From 217d21573938d324db2a03ef2cacf9050784ec48 Mon Sep 17 00:00:00 2001 From: Patrick Franz Date: Sun, 23 Aug 2026 16:52:10 +0200 Subject: [PATCH] Import qt6-multimedia_6.11.2.orig.tar.xz [dgit import orig qt6-multimedia_6.11.2.orig.tar.xz] --- .cmake.conf | 17 + .gitreview | 4 + .tag | 1 + CMakeLists.txt | 99 + LICENSES/Apache-2.0.txt | 61 + LICENSES/BSD-3-Clause.txt | 9 + LICENSES/GFDL-1.3-no-invariants-only.txt | 451 + LICENSES/GPL-2.0-only.txt | 339 + LICENSES/GPL-3.0-only.txt | 674 ++ LICENSES/LGPL-3.0-only.txt | 165 + LICENSES/LicenseRef-Qt-Commercial.txt | 8 + LICENSES/MIT-0.txt | 18 + LICENSES/MIT.txt | 11 + LICENSES/MPL-2.0.txt | 373 + LICENSES/Qt-GPL-exception-1.0.txt | 22 + REUSE.toml | 61 + cmake/FindFFmpeg.cmake | 414 + cmake/FindGObject.cmake | 58 + cmake/FindGStreamer.cmake | 261 + cmake/FindMMRenderer.cmake | 29 + cmake/FindMMRendererCore.cmake | 12 + cmake/FindPipeWire.cmake | 123 + cmake/FindVAAPI.cmake | 92 + cmake/FindWrapPulseAudio.cmake | 37 + cmake/REUSE.toml | 7 + coin/axivion/ci_config_linux.json | 45 + ..._tests_environment_for_ffmpeg_backend.yaml | 42 + .../run_darwin_backend_tests.yaml | 18 + .../run_ffmpeg_backend_tests.yaml | 15 + .../run_gstreamer_backend_tests.yaml | 27 + coin/module_config.yaml | 24 + config.tests/gpu_vivante/CMakeLists.txt | 33 + config.tests/gpu_vivante/main.cpp | 12 + config.tests/linux_v4l/CMakeLists.txt | 33 + config.tests/linux_v4l/main.cpp | 9 + config_help.txt | 8 + configure.cmake | 24 + dependencies.yaml | 13 + dist/REUSE.toml | 8 + dist/changes-5.0.1 | 76 + dist/changes-5.0.2 | 48 + dist/changes-5.1.0 | 38 + dist/changes-5.1.1 | 45 + dist/changes-5.10.0 | 41 + dist/changes-5.10.1 | 72 + dist/changes-5.11.0 | 75 + dist/changes-5.11.1 | 73 + dist/changes-5.11.2 | 61 + dist/changes-5.11.3 | 58 + dist/changes-5.12.0 | 59 + dist/changes-5.12.1 | 68 + dist/changes-5.12.2 | 45 + dist/changes-5.12.3 | 40 + dist/changes-5.12.4 | 57 + dist/changes-5.12.5 | 35 + dist/changes-5.13.0 | 64 + dist/changes-5.13.1 | 46 + dist/changes-5.13.2 | 68 + dist/changes-5.14.0 | 54 + dist/changes-5.14.1 | 25 + dist/changes-5.14.2 | 45 + dist/changes-5.15.0 | 57 + dist/changes-5.15.1 | 45 + dist/changes-5.15.2 | 29 + dist/changes-5.2.0 | 86 + dist/changes-5.2.1 | 35 + dist/changes-5.3.1 | 61 + dist/changes-5.3.2 | 65 + dist/changes-5.4.0 | 111 + dist/changes-5.4.1 | 49 + dist/changes-5.4.2 | 64 + dist/changes-5.5.0 | 118 + dist/changes-5.5.1 | 68 + dist/changes-5.6.0 | 138 + dist/changes-5.6.1 | 64 + dist/changes-5.6.2 | 90 + dist/changes-5.6.3 | 66 + dist/changes-5.7.0 | 67 + dist/changes-5.7.1 | 34 + dist/changes-5.8.0 | 70 + dist/changes-5.9.0 | 74 + dist/changes-5.9.1 | 43 + dist/changes-5.9.2 | 42 + dist/changes-5.9.3 | 58 + dist/changes-5.9.4 | 57 + dist/changes-5.9.5 | 45 + dist/changes-5.9.6 | 34 + examples/CMakeLists.txt | 11 + examples/examples.pro | 3 + examples/multimedia/CMakeLists.txt | 20 + .../multimedia/audiodevices/CMakeLists.txt | 43 + .../multimedia/audiodevices/Info.plist.in | 44 + .../audiodevices/Info.qmake.ios.plist | 41 + .../audiodevices/Info.qmake.macos.plist | 32 + .../multimedia/audiodevices/audiodevices.cpp | 231 + .../multimedia/audiodevices/audiodevices.h | 42 + .../multimedia/audiodevices/audiodevices.pro | 20 + .../audiodevices/audiodevicesbase.ui | 198 + .../audiodevices/doc/images/audiodevices.png | Bin 0 -> 14883 bytes .../audiodevices/doc/src/audiodevices.qdoc | 21 + examples/multimedia/audiodevices/main.cpp | 17 + .../multimedia/audiooutput/CMakeLists.txt | 40 + .../multimedia/audiooutput/audiooutput.cpp | 550 + examples/multimedia/audiooutput/audiooutput.h | 91 + .../multimedia/audiooutput/audiooutput.pro | 13 + .../doc/images/audiooutput-example.png | Bin 0 -> 8172 bytes .../audiooutput/doc/src/audiooutput.qdoc | 24 + examples/multimedia/audiooutput/main.cpp | 17 + .../multimedia/audiorecorder/CMakeLists.txt | 42 + .../multimedia/audiorecorder/Info.plist.in | 44 + .../audiorecorder/Info.qmake.ios.plist | 41 + .../audiorecorder/Info.qmake.macos.plist | 32 + .../audiorecorder/audiorecorder.cpp | 308 + .../multimedia/audiorecorder/audiorecorder.h | 54 + .../audiorecorder/audiorecorder.pro | 23 + .../multimedia/audiorecorder/audiorecorder.ui | 260 + .../doc/images/audiorecorder.png | Bin 0 -> 28212 bytes .../audiorecorder/doc/src/audiorecorder.qdoc | 85 + examples/multimedia/audiorecorder/main.cpp | 16 + .../multimedia/audiosource/CMakeLists.txt | 41 + examples/multimedia/audiosource/Info.plist.in | 44 + .../audiosource/Info.qmake.ios.plist | 41 + .../audiosource/Info.qmake.macos.plist | 32 + .../multimedia/audiosource/audiosource.cpp | 516 + examples/multimedia/audiosource/audiosource.h | 116 + .../multimedia/audiosource/audiosource.pro | 16 + .../doc/images/audiosource-example.png | Bin 0 -> 8180 bytes .../audiosource/doc/src/audiosource.qdoc | 28 + examples/multimedia/audiosource/main.cpp | 17 + examples/multimedia/camera/CMakeLists.txt | 83 + .../multimedia/camera/Info.qmake.ios.plist | 41 + .../multimedia/camera/Info.qmake.macos.plist | 32 + .../camera/android/AndroidManifest.xml | 38 + examples/multimedia/camera/camera.cpp | 416 + examples/multimedia/camera/camera.h | 104 + examples/multimedia/camera/camera.pro | 43 + examples/multimedia/camera/camera.qrc | 5 + examples/multimedia/camera/camera.ui | 446 + examples/multimedia/camera/camera_mobile.ui | 504 + .../camera/doc/images/camera-example.png | Bin 0 -> 151290 bytes .../multimedia/camera/doc/src/camera.qdoc | 93 + examples/multimedia/camera/images/shutter.svg | 21 + examples/multimedia/camera/imagesettings.cpp | 84 + examples/multimedia/camera/imagesettings.h | 41 + examples/multimedia/camera/imagesettings.ui | 123 + examples/multimedia/camera/ios/Info.plist.in | 50 + .../multimedia/camera/macos/Info.plist.in | 49 + examples/multimedia/camera/main.cpp | 20 + examples/multimedia/camera/metadatadialog.cpp | 107 + examples/multimedia/camera/metadatadialog.h | 31 + examples/multimedia/camera/videosettings.cpp | 202 + examples/multimedia/camera/videosettings.h | 42 + examples/multimedia/camera/videosettings.ui | 213 + .../multimedia/camera/videosettings_mobile.ui | 207 + .../declarative-camera/CMakeLists.txt | 69 + .../declarative-camera/CameraButton.qml | 41 + .../declarative-camera/CameraListButton.qml | 32 + .../CameraWhiteBalanceButton.qml | 64 + .../declarative-camera/FlashControl.qml | 68 + .../declarative-camera/Info.plist.in | 46 + .../declarative-camera/Info.qmake.ios.plist | 41 + .../declarative-camera/Info.qmake.macos.plist | 32 + .../PhotoCaptureControls.qml | 226 + .../declarative-camera/PhotoPreview.qml | 24 + .../VideoCaptureControls.qml | 243 + .../declarative-camera/VideoPreview.qml | 42 + .../declarative-camera/ZoomControl.qml | 82 + .../declarative-camera/declarative-camera.pro | 15 + .../declarative-camera/declarative-camera.qml | 190 + .../declarative-camera.qmlproject | 18 + .../declarative-camera/declarative-camera.qrc | 20 + .../doc/images/CaptureControls.png | Bin 0 -> 41278 bytes .../doc/images/FlashControls.png | Bin 0 -> 69725 bytes .../doc/images/VideoCaptureControls.png | Bin 0 -> 35913 bytes .../doc/images/ZoomControl.png | Bin 0 -> 28291 bytes .../doc/images/qml-camera.png | Bin 0 -> 51620 bytes .../doc/images/qml-declarative-portrait.png | Bin 0 -> 49057 bytes .../doc/src/declarative-camera.qdoc | 148 + .../images/camera_camera_setting.png | Bin 0 -> 717 bytes .../images/camera_flash_auto.png | Bin 0 -> 1119 bytes .../images/camera_flash_fill.png | Bin 0 -> 610 bytes .../images/camera_flash_off.png | Bin 0 -> 717 bytes .../images/camera_flash_redeye.png | Bin 0 -> 945 bytes .../declarative-camera/images/toolbutton.png | Bin 0 -> 2550 bytes .../declarative-camera/images/toolbutton.sci | 5 + .../declarative-camera/qmlcamera.cpp | 19 + examples/multimedia/multimedia.pro | 22 + examples/multimedia/player/CMakeLists.txt | 45 + .../multimedia/player/audiolevelmeter.cpp | 367 + examples/multimedia/player/audiolevelmeter.h | 144 + .../player/doc/images/mediaplayerex.jpg | Bin 0 -> 58304 bytes .../multimedia/player/doc/src/player.qdoc | 56 + examples/multimedia/player/main.cpp | 39 + examples/multimedia/player/player.cpp | 599 + examples/multimedia/player/player.h | 110 + examples/multimedia/player/player.pro | 32 + examples/multimedia/player/playercontrols.cpp | 172 + examples/multimedia/player/playercontrols.h | 63 + examples/multimedia/player/playlistmodel.cpp | 105 + examples/multimedia/player/playlistmodel.h | 53 + examples/multimedia/player/qmediaplaylist.cpp | 643 + examples/multimedia/player/qmediaplaylist.h | 90 + .../multimedia/player/qmediaplaylist_p.cpp | 65 + examples/multimedia/player/qmediaplaylist_p.h | 66 + .../multimedia/player/qplaylistfileparser.cpp | 623 + .../multimedia/player/qplaylistfileparser.h | 78 + examples/multimedia/player/videowidget.cpp | 46 + examples/multimedia/player/videowidget.h | 22 + .../multimedia/screencapture/CMakeLists.txt | 61 + .../multimedia/screencapture/Info.plist.in | 41 + .../screencapture/android/AndroidManifest.xml | 53 + .../doc/images/screencapture.jpg | Bin 0 -> 42725 bytes .../screencapture/doc/src/screencapture.qdoc | 49 + examples/multimedia/screencapture/main.cpp | 14 + .../screencapture/screencapture.pro | 19 + .../screencapture/screencapturepreview.cpp | 179 + .../screencapture/screencapturepreview.h | 66 + .../screencapture/screenlistmodel.cpp | 54 + .../screencapture/screenlistmodel.h | 29 + .../screencapture/windowlistmodel.cpp | 42 + .../screencapture/windowlistmodel.h | 30 + examples/multimedia/video/CMakeLists.txt | 10 + .../video/mediaplayer/CMakeLists.txt | 71 + .../multimedia/video/mediaplayer/Main.qml | 185 + .../mediaplayer/controls/AudioControl.qml | 51 + .../mediaplayer/controls/MetadataInfo.qml | 30 + .../mediaplayer/controls/PlaybackControl.qml | 317 + .../controls/PlaybackSeekControl.qml | 56 + .../mediaplayer/controls/SettingsPopup.qml | 238 + .../video/mediaplayer/controls/TracksInfo.qml | 25 + .../video/mediaplayer/controls/UrlPopup.qml | 54 + ...dia-examples-qml-media-player-settings.png | Bin 0 -> 33956 bytes ...qtmultimedia-examples-qml-media-player.png | Bin 0 -> 49506 bytes .../mediaplayer/doc/src/mediaplayer.qdoc | 153 + .../video/mediaplayer/images/backward10.svg | 5 + .../video/mediaplayer/images/ff.svg | 4 + .../video/mediaplayer/images/forward10.svg | 5 + .../video/mediaplayer/images/link.svg | 3 + .../video/mediaplayer/images/loop.svg | 3 + .../video/mediaplayer/images/more.svg | 5 + .../video/mediaplayer/images/mute.svg | 6 + .../video/mediaplayer/images/open_new.svg | 6 + .../video/mediaplayer/images/pause_symbol.svg | 4 + .../video/mediaplayer/images/play_symbol.svg | 3 + .../video/mediaplayer/images/rewind.svg | 4 + .../video/mediaplayer/images/settings.svg | 4 + .../video/mediaplayer/images/speaker.svg | 7 + .../video/mediaplayer/images/stop_symbol.svg | 3 + .../video/mediaplayer/images/url.svg | 6 + .../video/mediaplayer/images/volume.svg | 4 + .../video/mediaplayer/images/volume_mute.svg | 4 + .../mediaplayer/images/zoom_maximize.svg | 4 + .../mediaplayer/images/zoom_minimize.svg | 4 + .../multimedia/video/mediaplayer/main.cpp | 38 + .../multimedia/video/qmlvideo/CMakeLists.txt | 64 + .../multimedia/video/qmlvideo/Info.plist.in | 45 + .../qmlvideo/doc/images/qmlvideo-menu.jpg | Bin 0 -> 21959 bytes .../qmlvideo/doc/images/qmlvideo-overlay.jpg | Bin 0 -> 23787 bytes .../doc/images/video-qml-paint-rate.png | Bin 0 -> 6121 bytes .../video/qmlvideo/doc/src/qmlvideo.qdoc | 150 + .../qmlvideo/frequencymonitor/CMakeLists.txt | 23 + .../frequencymonitor/FrequencyItem.qml | 67 + .../frequencymonitor/PerformanceItem.qml | 100 + .../frequencymonitor/frequencymonitor.cpp | 216 + .../frequencymonitor/frequencymonitor.h | 67 + .../video/qmlvideo/frequencymonitor/qmldir | 4 + examples/multimedia/video/qmlvideo/main.cpp | 92 + .../multimedia/video/qmlvideo/qmlvideo.png | Bin 0 -> 3400 bytes .../multimedia/video/qmlvideo/qmlvideo.pro | 94 + .../multimedia/video/qmlvideo/qmlvideo.svg | 93 + .../video/qmlvideo/qmlvideo/CMakeLists.txt | 70 + .../video/qmlvideo/qmlvideo/CameraBasic.qml | 7 + .../video/qmlvideo/qmlvideo/CameraDrag.qml | 6 + .../video/qmlvideo/qmlvideo/CameraDummy.qml | 31 + .../qmlvideo/qmlvideo/CameraFullScreen.qml | 7 + .../qmlvideo/CameraFullScreenInverted.qml | 7 + .../video/qmlvideo/qmlvideo/CameraItem.qml | 47 + .../video/qmlvideo/qmlvideo/CameraMove.qml | 6 + .../video/qmlvideo/qmlvideo/CameraOverlay.qml | 6 + .../video/qmlvideo/qmlvideo/CameraResize.qml | 6 + .../video/qmlvideo/qmlvideo/CameraRotate.qml | 6 + .../video/qmlvideo/qmlvideo/CameraSpin.qml | 6 + .../video/qmlvideo/qmlvideo/Content.qml | 125 + .../video/qmlvideo/qmlvideo/ErrorDialog.qml | 70 + .../video/qmlvideo/qmlvideo/Main.qml | 188 + .../video/qmlvideo/qmlvideo/Scene.qml | 31 + .../video/qmlvideo/qmlvideo/SceneBasic.qml | 47 + .../video/qmlvideo/qmlvideo/SceneDrag.qml | 34 + .../qmlvideo/qmlvideo/SceneFullScreen.qml | 67 + .../qmlvideo/SceneFullScreenInverted.qml | 70 + .../video/qmlvideo/qmlvideo/SceneMove.qml | 49 + .../video/qmlvideo/qmlvideo/SceneMulti.qml | 185 + .../video/qmlvideo/qmlvideo/SceneOverlay.qml | 83 + .../video/qmlvideo/qmlvideo/SceneResize.qml | 41 + .../video/qmlvideo/qmlvideo/SceneRotate.qml | 57 + .../qmlvideo/qmlvideo/SceneSelectionPanel.qml | 109 + .../video/qmlvideo/qmlvideo/SceneSpin.qml | 34 + .../video/qmlvideo/qmlvideo/SeekControl.qml | 105 + .../video/qmlvideo/qmlvideo/VideoBasic.qml | 6 + .../video/qmlvideo/qmlvideo/VideoDrag.qml | 6 + .../video/qmlvideo/qmlvideo/VideoDummy.qml | 37 + .../video/qmlvideo/qmlvideo/VideoFillMode.qml | 49 + .../qmlvideo/qmlvideo/VideoFullScreen.qml | 7 + .../qmlvideo/VideoFullScreenInverted.qml | 7 + .../video/qmlvideo/qmlvideo/VideoItem.qml | 42 + .../video/qmlvideo/qmlvideo/VideoMetadata.qml | 80 + .../video/qmlvideo/qmlvideo/VideoMove.qml | 6 + .../video/qmlvideo/qmlvideo/VideoOverlay.qml | 6 + .../qmlvideo/qmlvideo/VideoPlaybackRate.qml | 65 + .../video/qmlvideo/qmlvideo/VideoResize.qml | 6 + .../video/qmlvideo/qmlvideo/VideoRotate.qml | 6 + .../video/qmlvideo/qmlvideo/VideoSeek.qml | 36 + .../video/qmlvideo/qmlvideo/VideoSpin.qml | 6 + .../video/qmlvideo/qmlvideo/images/folder.png | Bin 0 -> 1829 bytes .../video/qmlvideo/qmlvideo/images/leaves.jpg | Bin 0 -> 257378 bytes .../video/qmlvideo/qmlvideo/images/up.png | Bin 0 -> 1268 bytes .../multimedia/video/qmlvideo/qmlvideo/qmldir | 44 + .../video/qmlvideo/qmlvideo/qmlvideo_global.h | 10 + .../qmlvideo/qmlvideo/videosingleton.cpp | 54 + .../video/qmlvideo/qmlvideo/videosingleton.h | 46 + examples/multimedia/video/qmlvideo/trace.h | 81 + .../video/recorder/AudioInputSelect.qml | 53 + .../multimedia/video/recorder/CMakeLists.txt | 71 + .../multimedia/video/recorder/Controls.qml | 82 + .../multimedia/video/recorder/Info.plist.in | 46 + examples/multimedia/video/recorder/Main.qml | 168 + .../multimedia/video/recorder/MediaList.qml | 68 + .../video/recorder/PermissionHelper.qml | 34 + .../multimedia/video/recorder/Playback.qml | 55 + .../video/recorder/RecordButton.qml | 43 + .../video/recorder/SettingsEncoder.qml | 100 + .../video/recorder/SettingsMetaData.qml | 145 + examples/multimedia/video/recorder/Style.qml | 31 + .../video/recorder/StyleParameter.qml | 42 + .../video/recorder/StyleRectangle.qml | 11 + .../video/recorder/VideoSourceSelect.qml | 169 + .../recorder/android/AndroidManifest.xml | 53 + .../qml-recorder-control-bar-overview.gif | Bin 0 -> 111693 bytes .../doc/images/qml-recorder-overview.gif | Bin 0 -> 138905 bytes .../video/recorder/doc/images/qmlrecorder.jpg | Bin 0 -> 95965 bytes .../video/recorder/doc/src/recorder.qdoc | 105 + examples/multimedia/video/recorder/main.cpp | 25 + examples/multimedia/video/video.pro | 3 + .../videographicsitem/CMakeLists.txt | 41 + .../doc/images/video-videographicsitem.png | Bin 0 -> 54436 bytes .../doc/src/videographicsitem.qdoc | 21 + .../multimedia/videographicsitem/main.cpp | 37 + .../videographicsitem/videographicsitem.pro | 15 + .../videographicsitem/videoplayer.cpp | 148 + .../videographicsitem/videoplayer.h | 47 + .../multimedia/videowidget/CMakeLists.txt | 41 + .../doc/images/video-videowidget.png | Bin 0 -> 54199 bytes .../videowidget/doc/src/videowidget.qdoc | 19 + examples/multimedia/videowidget/main.cpp | 40 + .../multimedia/videowidget/videoplayer.cpp | 137 + examples/multimedia/videowidget/videoplayer.h | 44 + .../multimedia/videowidget/videowidget.pro | 17 + examples/spatialaudio/CMakeLists.txt | 4 + .../spatialaudio/audiopanning/CMakeLists.txt | 38 + .../audiopanning/audiopanning.pro | 10 + .../doc/images/audiopanning-example.png | Bin 0 -> 171760 bytes .../audiopanning/doc/src/audiopanning.qdoc | 28 + examples/spatialaudio/audiopanning/main.cpp | 238 + examples/spatialaudio/spatialaudio.pro | 3 + licenseRule.json | 149 + .../features/ios/add_ios_ffmpeg_libraries.prf | 23 + qt_cmdline.cmake | 4 + ...party-drwav-namespace-implementation.patch | 80 + src/3rdparty/dr_libs/LICENSE | 47 + src/3rdparty/dr_libs/REUSE.toml | 6 + src/3rdparty/dr_libs/dr_wav.h | 9116 ++++++++++++++ src/3rdparty/dr_libs/qt_attribution.json | 19 + src/3rdparty/eigen/.clang-format | 19 + src/3rdparty/eigen/CHANGELOG.md | 1916 +++ src/3rdparty/eigen/COPYING.APACHE | 203 + src/3rdparty/eigen/COPYING.BSD | 26 + src/3rdparty/eigen/COPYING.MINPACK | 51 + src/3rdparty/eigen/COPYING.MPL2 | 373 + src/3rdparty/eigen/COPYING.README | 6 + src/3rdparty/eigen/COPYRIGHTS | 54 + src/3rdparty/eigen/Eigen/AccelerateSupport | 52 + src/3rdparty/eigen/Eigen/Cholesky | 43 + src/3rdparty/eigen/Eigen/CholmodSupport | 48 + src/3rdparty/eigen/Eigen/Core | 451 + src/3rdparty/eigen/Eigen/Dense | 7 + src/3rdparty/eigen/Eigen/Eigen | 2 + src/3rdparty/eigen/Eigen/Eigenvalues | 63 + src/3rdparty/eigen/Eigen/Geometry | 59 + src/3rdparty/eigen/Eigen/Householder | 31 + .../eigen/Eigen/IterativeLinearSolvers | 52 + src/3rdparty/eigen/Eigen/Jacobi | 33 + src/3rdparty/eigen/Eigen/KLUSupport | 43 + src/3rdparty/eigen/Eigen/LU | 46 + src/3rdparty/eigen/Eigen/MetisSupport | 35 + src/3rdparty/eigen/Eigen/OrderingMethods | 73 + src/3rdparty/eigen/Eigen/PaStiXSupport | 51 + src/3rdparty/eigen/Eigen/PardisoSupport | 38 + src/3rdparty/eigen/Eigen/QR | 48 + src/3rdparty/eigen/Eigen/QtAlignedMalloc | 32 + src/3rdparty/eigen/Eigen/SPQRSupport | 41 + src/3rdparty/eigen/Eigen/SVD | 56 + src/3rdparty/eigen/Eigen/Sparse | 33 + src/3rdparty/eigen/Eigen/SparseCholesky | 40 + src/3rdparty/eigen/Eigen/SparseCore | 70 + src/3rdparty/eigen/Eigen/SparseLU | 50 + src/3rdparty/eigen/Eigen/SparseQR | 38 + src/3rdparty/eigen/Eigen/StdDeque | 30 + src/3rdparty/eigen/Eigen/StdList | 29 + src/3rdparty/eigen/Eigen/StdVector | 30 + src/3rdparty/eigen/Eigen/SuperLUSupport | 70 + src/3rdparty/eigen/Eigen/ThreadPool | 80 + src/3rdparty/eigen/Eigen/UmfPackSupport | 42 + src/3rdparty/eigen/Eigen/Version | 14 + .../src/AccelerateSupport/AccelerateSupport.h | 423 + .../AccelerateSupport/InternalHeaderCheck.h | 3 + .../Eigen/src/Cholesky/InternalHeaderCheck.h | 3 + src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h | 649 + src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h | 514 + .../eigen/Eigen/src/Cholesky/LLT_LAPACKE.h | 124 + .../Eigen/src/CholmodSupport/CholmodSupport.h | 738 ++ .../src/CholmodSupport/InternalHeaderCheck.h | 3 + .../eigen/Eigen/src/Core/ArithmeticSequence.h | 239 + src/3rdparty/eigen/Eigen/src/Core/Array.h | 376 + src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h | 213 + .../eigen/Eigen/src/Core/ArrayWrapper.h | 165 + src/3rdparty/eigen/Eigen/src/Core/Assign.h | 80 + .../eigen/Eigen/src/Core/AssignEvaluator.h | 1057 ++ .../eigen/Eigen/src/Core/Assign_MKL.h | 183 + .../eigen/Eigen/src/Core/BandMatrix.h | 338 + src/3rdparty/eigen/Eigen/src/Core/Block.h | 429 + .../eigen/Eigen/src/Core/CommaInitializer.h | 149 + .../eigen/Eigen/src/Core/ConditionEstimator.h | 173 + .../eigen/Eigen/src/Core/CoreEvaluators.h | 2018 ++++ .../eigen/Eigen/src/Core/CoreIterators.h | 141 + .../eigen/Eigen/src/Core/CwiseBinaryOp.h | 166 + .../eigen/Eigen/src/Core/CwiseNullaryOp.h | 975 ++ .../eigen/Eigen/src/Core/CwiseTernaryOp.h | 171 + .../eigen/Eigen/src/Core/CwiseUnaryOp.h | 91 + .../eigen/Eigen/src/Core/CwiseUnaryView.h | 167 + src/3rdparty/eigen/Eigen/src/Core/DenseBase.h | 673 ++ .../eigen/Eigen/src/Core/DenseCoeffsBase.h | 568 + .../eigen/Eigen/src/Core/DenseStorage.h | 573 + .../eigen/Eigen/src/Core/DeviceWrapper.h | 153 + src/3rdparty/eigen/Eigen/src/Core/Diagonal.h | 219 + .../eigen/Eigen/src/Core/DiagonalMatrix.h | 420 + .../eigen/Eigen/src/Core/DiagonalProduct.h | 30 + src/3rdparty/eigen/Eigen/src/Core/Dot.h | 268 + src/3rdparty/eigen/Eigen/src/Core/EigenBase.h | 149 + src/3rdparty/eigen/Eigen/src/Core/Fill.h | 138 + src/3rdparty/eigen/Eigen/src/Core/FindCoeff.h | 464 + .../eigen/Eigen/src/Core/ForceAlignedAccess.h | 127 + src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h | 132 + .../eigen/Eigen/src/Core/GeneralProduct.h | 519 + .../eigen/Eigen/src/Core/GenericPacketMath.h | 1702 +++ .../eigen/Eigen/src/Core/GlobalFunctions.h | 230 + src/3rdparty/eigen/Eigen/src/Core/IO.h | 233 + .../eigen/Eigen/src/Core/IndexedView.h | 321 + .../eigen/Eigen/src/Core/InnerProduct.h | 260 + .../Eigen/src/Core/InternalHeaderCheck.h | 3 + src/3rdparty/eigen/Eigen/src/Core/Inverse.h | 108 + src/3rdparty/eigen/Eigen/src/Core/Map.h | 153 + src/3rdparty/eigen/Eigen/src/Core/MapBase.h | 283 + .../eigen/Eigen/src/Core/MathFunctions.h | 2103 ++++ .../eigen/Eigen/src/Core/MathFunctionsImpl.h | 263 + src/3rdparty/eigen/Eigen/src/Core/Matrix.h | 534 + .../eigen/Eigen/src/Core/MatrixBase.h | 545 + .../eigen/Eigen/src/Core/NestByValue.h | 91 + src/3rdparty/eigen/Eigen/src/Core/NoAlias.h | 102 + src/3rdparty/eigen/Eigen/src/Core/NumTraits.h | 335 + .../Eigen/src/Core/PartialReduxEvaluator.h | 253 + .../eigen/Eigen/src/Core/PermutationMatrix.h | 555 + .../eigen/Eigen/src/Core/PlainObjectBase.h | 1014 ++ src/3rdparty/eigen/Eigen/src/Core/Product.h | 307 + .../eigen/Eigen/src/Core/ProductEvaluators.h | 1287 ++ src/3rdparty/eigen/Eigen/src/Core/Random.h | 207 + .../eigen/Eigen/src/Core/RandomImpl.h | 262 + src/3rdparty/eigen/Eigen/src/Core/RealView.h | 250 + src/3rdparty/eigen/Eigen/src/Core/Redux.h | 535 + src/3rdparty/eigen/Eigen/src/Core/Ref.h | 383 + src/3rdparty/eigen/Eigen/src/Core/Replicate.h | 130 + src/3rdparty/eigen/Eigen/src/Core/Reshaped.h | 398 + .../eigen/Eigen/src/Core/ReturnByValue.h | 111 + src/3rdparty/eigen/Eigen/src/Core/Reverse.h | 202 + src/3rdparty/eigen/Eigen/src/Core/Select.h | 92 + .../eigen/Eigen/src/Core/SelfAdjointView.h | 329 + .../eigen/Eigen/src/Core/SelfCwiseBinaryOp.h | 50 + .../Eigen/src/Core/SkewSymmetricMatrix3.h | 382 + src/3rdparty/eigen/Eigen/src/Core/Solve.h | 174 + .../eigen/Eigen/src/Core/SolveTriangular.h | 237 + .../eigen/Eigen/src/Core/SolverBase.h | 167 + .../eigen/Eigen/src/Core/StableNorm.h | 217 + .../eigen/Eigen/src/Core/StlIterators.h | 619 + src/3rdparty/eigen/Eigen/src/Core/Stride.h | 114 + src/3rdparty/eigen/Eigen/src/Core/Swap.h | 99 + src/3rdparty/eigen/Eigen/src/Core/Transpose.h | 427 + .../eigen/Eigen/src/Core/Transpositions.h | 323 + .../eigen/Eigen/src/Core/TriangularMatrix.h | 900 ++ .../eigen/Eigen/src/Core/VectorBlock.h | 83 + .../eigen/Eigen/src/Core/VectorwiseOp.h | 733 ++ src/3rdparty/eigen/Eigen/src/Core/Visitor.h | 537 + .../eigen/Eigen/src/Core/arch/AVX/Complex.h | 565 + .../Eigen/src/Core/arch/AVX/MathFunctions.h | 130 + .../Eigen/src/Core/arch/AVX/PacketMath.h | 3081 +++++ .../Eigen/src/Core/arch/AVX/Reductions.h | 353 + .../Eigen/src/Core/arch/AVX/TypeCasting.h | 308 + .../Eigen/src/Core/arch/AVX512/Complex.h | 472 + .../Eigen/src/Core/arch/AVX512/GemmKernel.h | 1245 ++ .../src/Core/arch/AVX512/MathFunctions.h | 141 + .../src/Core/arch/AVX512/MathFunctionsFP16.h | 75 + .../Eigen/src/Core/arch/AVX512/PacketMath.h | 3146 +++++ .../src/Core/arch/AVX512/PacketMathFP16.h | 1413 +++ .../Eigen/src/Core/arch/AVX512/Reductions.h | 297 + .../Eigen/src/Core/arch/AVX512/TrsmKernel.h | 1167 ++ .../src/Core/arch/AVX512/TrsmUnrolls.inc | 1219 ++ .../Eigen/src/Core/arch/AVX512/TypeCasting.h | 277 + .../src/Core/arch/AVX512/TypeCastingFP16.h | 130 + .../Eigen/src/Core/arch/AltiVec/Complex.h | 653 + .../src/Core/arch/AltiVec/MathFunctions.h | 81 + .../src/Core/arch/AltiVec/MatrixProduct.h | 3686 ++++++ .../Core/arch/AltiVec/MatrixProductCommon.h | 205 + .../src/Core/arch/AltiVec/MatrixProductMMA.h | 901 ++ .../arch/AltiVec/MatrixProductMMAbfloat16.h | 742 ++ .../Core/arch/AltiVec/MatrixVectorProduct.inc | 2818 +++++ .../Eigen/src/Core/arch/AltiVec/PacketMath.h | 3729 ++++++ .../Eigen/src/Core/arch/AltiVec/TypeCasting.h | 153 + .../Eigen/src/Core/arch/Default/BFloat16.h | 866 ++ .../Eigen/src/Core/arch/Default/ConjHelper.h | 128 + .../arch/Default/GenericPacketMathFunctions.h | 2634 ++++ .../Default/GenericPacketMathFunctionsFwd.h | 227 + .../eigen/Eigen/src/Core/arch/Default/Half.h | 1091 ++ .../Eigen/src/Core/arch/Default/Settings.h | 47 + .../eigen/Eigen/src/Core/arch/GPU/Complex.h | 244 + .../Eigen/src/Core/arch/GPU/MathFunctions.h | 104 + .../Eigen/src/Core/arch/GPU/PacketMath.h | 1712 +++ .../eigen/Eigen/src/Core/arch/GPU/Tuple.h | 268 + .../Eigen/src/Core/arch/GPU/TypeCasting.h | 77 + .../src/Core/arch/HIP/hcc/math_constants.h | 23 + .../Eigen/src/Core/arch/HVX/PacketMath.h | 1088 ++ .../eigen/Eigen/src/Core/arch/LSX/Complex.h | 520 + .../Core/arch/LSX/GeneralBlockPanelKernel.h | 23 + .../Eigen/src/Core/arch/LSX/MathFunctions.h | 43 + .../Eigen/src/Core/arch/LSX/PacketMath.h | 2866 +++++ .../Eigen/src/Core/arch/LSX/TypeCasting.h | 526 + .../eigen/Eigen/src/Core/arch/MSA/Complex.h | 620 + .../Eigen/src/Core/arch/MSA/MathFunctions.h | 379 + .../Eigen/src/Core/arch/MSA/PacketMath.h | 1237 ++ .../eigen/Eigen/src/Core/arch/NEON/Complex.h | 732 ++ .../Core/arch/NEON/GeneralBlockPanelKernel.h | 243 + .../Eigen/src/Core/arch/NEON/MathFunctions.h | 68 + .../Eigen/src/Core/arch/NEON/PacketMath.h | 6096 ++++++++++ .../Eigen/src/Core/arch/NEON/TypeCasting.h | 1642 +++ .../Eigen/src/Core/arch/NEON/UnaryFunctors.h | 57 + .../eigen/Eigen/src/Core/arch/SSE/Complex.h | 503 + .../Eigen/src/Core/arch/SSE/MathFunctions.h | 88 + .../Eigen/src/Core/arch/SSE/PacketMath.h | 2384 ++++ .../Eigen/src/Core/arch/SSE/Reductions.h | 324 + .../Eigen/src/Core/arch/SSE/TypeCasting.h | 230 + .../Eigen/src/Core/arch/SVE/MathFunctions.h | 48 + .../Eigen/src/Core/arch/SVE/PacketMath.h | 674 ++ .../Eigen/src/Core/arch/SVE/TypeCasting.h | 52 + .../Eigen/src/Core/arch/SYCL/InteropHeaders.h | 227 + .../Eigen/src/Core/arch/SYCL/MathFunctions.h | 303 + .../Eigen/src/Core/arch/SYCL/PacketMath.h | 576 + .../Eigen/src/Core/arch/SYCL/TypeCasting.h | 83 + .../Eigen/src/Core/arch/ZVector/Complex.h | 570 + .../src/Core/arch/ZVector/MathFunctions.h | 244 + .../Eigen/src/Core/arch/ZVector/PacketMath.h | 1413 +++ .../src/Core/functors/AssignmentFunctors.h | 174 + .../Eigen/src/Core/functors/BinaryFunctors.h | 747 ++ .../Eigen/src/Core/functors/NullaryFunctors.h | 274 + .../Eigen/src/Core/functors/StlFunctors.h | 149 + .../Eigen/src/Core/functors/TernaryFunctors.h | 52 + .../Eigen/src/Core/functors/UnaryFunctors.h | 1420 +++ .../Core/products/GeneralBlockPanelKernel.h | 3153 +++++ .../src/Core/products/GeneralMatrixMatrix.h | 459 + .../products/GeneralMatrixMatrixTriangular.h | 330 + .../GeneralMatrixMatrixTriangular_BLAS.h | 148 + .../Core/products/GeneralMatrixMatrix_BLAS.h | 205 + .../src/Core/products/GeneralMatrixVector.h | 473 + .../Core/products/GeneralMatrixVector_BLAS.h | 139 + .../Eigen/src/Core/products/Parallelizer.h | 282 + .../Core/products/SelfadjointMatrixMatrix.h | 483 + .../products/SelfadjointMatrixMatrix_BLAS.h | 277 + .../Core/products/SelfadjointMatrixVector.h | 253 + .../products/SelfadjointMatrixVector_BLAS.h | 115 + .../src/Core/products/SelfadjointProduct.h | 133 + .../Core/products/SelfadjointRank2Update.h | 95 + .../Core/products/TriangularMatrixMatrix.h | 397 + .../products/TriangularMatrixMatrix_BLAS.h | 325 + .../Core/products/TriangularMatrixVector.h | 347 + .../products/TriangularMatrixVector_BLAS.h | 275 + .../Core/products/TriangularSolverMatrix.h | 388 + .../products/TriangularSolverMatrix_BLAS.h | 166 + .../Core/products/TriangularSolverVector.h | 122 + .../eigen/Eigen/src/Core/util/Assert.h | 158 + .../eigen/Eigen/src/Core/util/BlasUtil.h | 622 + .../src/Core/util/ConfigureVectorization.h | 543 + .../eigen/Eigen/src/Core/util/Constants.h | 598 + .../src/Core/util/DisableStupidWarnings.h | 146 + .../eigen/Eigen/src/Core/util/EmulateArray.h | 270 + .../Eigen/src/Core/util/ForwardDeclarations.h | 524 + .../Eigen/src/Core/util/GpuHipCudaDefines.inc | 101 + .../src/Core/util/GpuHipCudaUndefines.inc | 45 + .../Eigen/src/Core/util/IndexedViewHelper.h | 487 + .../Eigen/src/Core/util/IntegralConstant.h | 279 + .../eigen/Eigen/src/Core/util/MKL_support.h | 139 + .../eigen/Eigen/src/Core/util/Macros.h | 1346 +++ .../eigen/Eigen/src/Core/util/MaxSizeVector.h | 139 + .../eigen/Eigen/src/Core/util/Memory.h | 1385 +++ src/3rdparty/eigen/Eigen/src/Core/util/Meta.h | 760 ++ .../eigen/Eigen/src/Core/util/MoreMeta.h | 638 + .../src/Core/util/ReenableStupidWarnings.h | 44 + .../Eigen/src/Core/util/ReshapedHelper.h | 51 + .../eigen/Eigen/src/Core/util/Serializer.h | 209 + .../eigen/Eigen/src/Core/util/StaticAssert.h | 105 + .../eigen/Eigen/src/Core/util/SymbolicIndex.h | 445 + .../eigen/Eigen/src/Core/util/XprHelper.h | 1093 ++ .../src/Eigenvalues/ComplexEigenSolver.h | 315 + .../Eigen/src/Eigenvalues/ComplexSchur.h | 442 + .../src/Eigenvalues/ComplexSchur_LAPACKE.h | 95 + .../eigen/Eigen/src/Eigenvalues/EigenSolver.h | 579 + .../src/Eigenvalues/GeneralizedEigenSolver.h | 402 + .../GeneralizedSelfAdjointEigenSolver.h | 212 + .../src/Eigenvalues/HessenbergDecomposition.h | 356 + .../src/Eigenvalues/InternalHeaderCheck.h | 3 + .../src/Eigenvalues/MatrixBaseEigenvalues.h | 142 + .../eigen/Eigen/src/Eigenvalues/RealQZ.h | 587 + .../eigen/Eigen/src/Eigenvalues/RealSchur.h | 519 + .../Eigen/src/Eigenvalues/RealSchur_LAPACKE.h | 83 + .../src/Eigenvalues/SelfAdjointEigenSolver.h | 850 ++ .../SelfAdjointEigenSolver_LAPACKE.h | 90 + .../src/Eigenvalues/Tridiagonalization.h | 529 + .../eigen/Eigen/src/Geometry/AlignedBox.h | 485 + .../eigen/Eigen/src/Geometry/AngleAxis.h | 245 + .../eigen/Eigen/src/Geometry/EulerAngles.h | 203 + .../eigen/Eigen/src/Geometry/Homogeneous.h | 453 + .../eigen/Eigen/src/Geometry/Hyperplane.h | 273 + .../Eigen/src/Geometry/InternalHeaderCheck.h | 3 + .../eigen/Eigen/src/Geometry/OrthoMethods.h | 257 + .../Eigen/src/Geometry/ParametrizedLine.h | 232 + .../eigen/Eigen/src/Geometry/Quaternion.h | 930 ++ .../eigen/Eigen/src/Geometry/Rotation2D.h | 201 + .../eigen/Eigen/src/Geometry/RotationBase.h | 209 + .../eigen/Eigen/src/Geometry/Scaling.h | 195 + .../eigen/Eigen/src/Geometry/Transform.h | 1485 +++ .../eigen/Eigen/src/Geometry/Translation.h | 204 + .../eigen/Eigen/src/Geometry/Umeyama.h | 161 + .../Eigen/src/Geometry/arch/Geometry_SIMD.h | 154 + .../Eigen/src/Householder/BlockHouseholder.h | 115 + .../eigen/Eigen/src/Householder/Householder.h | 154 + .../src/Householder/HouseholderSequence.h | 504 + .../src/Householder/InternalHeaderCheck.h | 3 + .../BasicPreconditioners.h | 213 + .../src/IterativeLinearSolvers/BiCGSTAB.h | 217 + .../ConjugateGradient.h | 217 + .../IncompleteCholesky.h | 402 + .../IterativeLinearSolvers/IncompleteLUT.h | 449 + .../InternalHeaderCheck.h | 3 + .../IterativeSolverBase.h | 395 + .../LeastSquareConjugateGradient.h | 193 + .../IterativeLinearSolvers/SolveWithGuess.h | 111 + .../Eigen/src/Jacobi/InternalHeaderCheck.h | 3 + src/3rdparty/eigen/Eigen/src/Jacobi/Jacobi.h | 427 + .../src/KLUSupport/InternalHeaderCheck.h | 3 + .../eigen/Eigen/src/KLUSupport/KLUSupport.h | 339 + src/3rdparty/eigen/Eigen/src/LU/Determinant.h | 98 + src/3rdparty/eigen/Eigen/src/LU/FullPivLU.h | 826 ++ .../eigen/Eigen/src/LU/InternalHeaderCheck.h | 3 + src/3rdparty/eigen/Eigen/src/LU/InverseImpl.h | 353 + .../eigen/Eigen/src/LU/PartialPivLU.h | 586 + .../eigen/Eigen/src/LU/PartialPivLU_LAPACKE.h | 97 + .../eigen/Eigen/src/LU/arch/InverseSize4.h | 353 + .../src/MetisSupport/InternalHeaderCheck.h | 3 + .../Eigen/src/MetisSupport/MetisSupport.h | 125 + .../eigen/Eigen/src/OrderingMethods/Amd.h | 413 + .../Eigen/src/OrderingMethods/Eigen_Colamd.h | 1690 +++ .../src/OrderingMethods/InternalHeaderCheck.h | 3 + .../Eigen/src/OrderingMethods/Ordering.h | 146 + .../src/PaStiXSupport/InternalHeaderCheck.h | 3 + .../Eigen/src/PaStiXSupport/PaStiXSupport.h | 632 + .../src/PardisoSupport/InternalHeaderCheck.h | 3 + .../Eigen/src/PardisoSupport/PardisoSupport.h | 500 + .../eigen/Eigen/src/QR/ColPivHouseholderQR.h | 674 ++ .../src/QR/ColPivHouseholderQR_LAPACKE.h | 161 + .../src/QR/CompleteOrthogonalDecomposition.h | 648 + .../eigen/Eigen/src/QR/FullPivHouseholderQR.h | 733 ++ .../eigen/Eigen/src/QR/HouseholderQR.h | 543 + .../Eigen/src/QR/HouseholderQR_LAPACKE.h | 77 + .../eigen/Eigen/src/QR/InternalHeaderCheck.h | 3 + .../src/SPQRSupport/InternalHeaderCheck.h | 3 + .../src/SPQRSupport/SuiteSparseQRSupport.h | 315 + src/3rdparty/eigen/Eigen/src/SVD/BDCSVD.h | 1470 +++ .../eigen/Eigen/src/SVD/BDCSVD_LAPACKE.h | 174 + .../eigen/Eigen/src/SVD/InternalHeaderCheck.h | 3 + src/3rdparty/eigen/Eigen/src/SVD/JacobiSVD.h | 846 ++ .../eigen/Eigen/src/SVD/JacobiSVD_LAPACKE.h | 127 + src/3rdparty/eigen/Eigen/src/SVD/SVDBase.h | 436 + .../Eigen/src/SVD/UpperBidiagonalization.h | 379 + .../src/SparseCholesky/InternalHeaderCheck.h | 3 + .../src/SparseCholesky/SimplicialCholesky.h | 868 ++ .../SparseCholesky/SimplicialCholesky_impl.h | 388 + .../eigen/Eigen/src/SparseCore/AmbiVector.h | 329 + .../Eigen/src/SparseCore/CompressedStorage.h | 206 + .../ConservativeSparseSparseProduct.h | 308 + .../src/SparseCore/InternalHeaderCheck.h | 3 + .../eigen/Eigen/src/SparseCore/SparseAssign.h | 279 + .../eigen/Eigen/src/SparseCore/SparseBlock.h | 534 + .../Eigen/src/SparseCore/SparseColEtree.h | 194 + .../src/SparseCore/SparseCompressedBase.h | 592 + .../src/SparseCore/SparseCwiseBinaryOp.h | 938 ++ .../Eigen/src/SparseCore/SparseCwiseUnaryOp.h | 142 + .../Eigen/src/SparseCore/SparseDenseProduct.h | 314 + .../src/SparseCore/SparseDiagonalProduct.h | 138 + .../eigen/Eigen/src/SparseCore/SparseDot.h | 100 + .../eigen/Eigen/src/SparseCore/SparseFuzzy.h | 31 + .../eigen/Eigen/src/SparseCore/SparseMap.h | 295 + .../eigen/Eigen/src/SparseCore/SparseMatrix.h | 1876 +++ .../Eigen/src/SparseCore/SparseMatrixBase.h | 451 + .../Eigen/src/SparseCore/SparsePermutation.h | 249 + .../Eigen/src/SparseCore/SparseProduct.h | 178 + .../eigen/Eigen/src/SparseCore/SparseRedux.h | 47 + .../eigen/Eigen/src/SparseCore/SparseRef.h | 370 + .../src/SparseCore/SparseSelfAdjointView.h | 613 + .../Eigen/src/SparseCore/SparseSolverBase.h | 115 + .../SparseSparseProductWithPruning.h | 184 + .../Eigen/src/SparseCore/SparseTranspose.h | 83 + .../src/SparseCore/SparseTriangularView.h | 177 + .../eigen/Eigen/src/SparseCore/SparseUtil.h | 209 + .../eigen/Eigen/src/SparseCore/SparseVector.h | 532 + .../eigen/Eigen/src/SparseCore/SparseView.h | 225 + .../Eigen/src/SparseCore/TriangularSolver.h | 274 + .../Eigen/src/SparseLU/InternalHeaderCheck.h | 3 + .../eigen/Eigen/src/SparseLU/SparseLU.h | 969 ++ .../eigen/Eigen/src/SparseLU/SparseLUImpl.h | 79 + .../Eigen/src/SparseLU/SparseLU_Memory.h | 210 + .../Eigen/src/SparseLU/SparseLU_Structs.h | 113 + .../src/SparseLU/SparseLU_SupernodalMatrix.h | 319 + .../eigen/Eigen/src/SparseLU/SparseLU_Utils.h | 75 + .../Eigen/src/SparseLU/SparseLU_column_bmod.h | 177 + .../Eigen/src/SparseLU/SparseLU_column_dfs.h | 168 + .../src/SparseLU/SparseLU_copy_to_ucol.h | 106 + .../src/SparseLU/SparseLU_heap_relax_snode.h | 114 + .../Eigen/src/SparseLU/SparseLU_kernel_bmod.h | 133 + .../Eigen/src/SparseLU/SparseLU_panel_bmod.h | 215 + .../Eigen/src/SparseLU/SparseLU_panel_dfs.h | 235 + .../Eigen/src/SparseLU/SparseLU_pivotL.h | 136 + .../Eigen/src/SparseLU/SparseLU_pruneL.h | 130 + .../Eigen/src/SparseLU/SparseLU_relax_snode.h | 81 + .../Eigen/src/SparseQR/InternalHeaderCheck.h | 3 + .../eigen/Eigen/src/SparseQR/SparseQR.h | 706 ++ .../eigen/Eigen/src/StlSupport/StdDeque.h | 51 + .../eigen/Eigen/src/StlSupport/StdList.h | 50 + .../eigen/Eigen/src/StlSupport/StdVector.h | 51 + .../eigen/Eigen/src/StlSupport/details.h | 82 + .../src/SuperLUSupport/InternalHeaderCheck.h | 3 + .../Eigen/src/SuperLUSupport/SuperLUSupport.h | 929 ++ .../eigen/Eigen/src/ThreadPool/Barrier.h | 70 + .../src/ThreadPool/CoreThreadPoolDevice.h | 336 + .../eigen/Eigen/src/ThreadPool/EventCount.h | 241 + .../eigen/Eigen/src/ThreadPool/ForkJoin.h | 140 + .../src/ThreadPool/InternalHeaderCheck.h | 4 + .../src/ThreadPool/NonBlockingThreadPool.h | 587 + .../eigen/Eigen/src/ThreadPool/RunQueue.h | 230 + .../eigen/Eigen/src/ThreadPool/ThreadCancel.h | 21 + .../Eigen/src/ThreadPool/ThreadEnvironment.h | 43 + .../eigen/Eigen/src/ThreadPool/ThreadLocal.h | 289 + .../src/ThreadPool/ThreadPoolInterface.h | 50 + .../eigen/Eigen/src/ThreadPool/ThreadYield.h | 16 + .../src/UmfPackSupport/InternalHeaderCheck.h | 3 + .../Eigen/src/UmfPackSupport/UmfPackSupport.h | 606 + src/3rdparty/eigen/Eigen/src/misc/Image.h | 80 + .../Eigen/src/misc/InternalHeaderCheck.h | 3 + src/3rdparty/eigen/Eigen/src/misc/Kernel.h | 77 + .../eigen/Eigen/src/misc/RealSvd2x2.h | 53 + src/3rdparty/eigen/Eigen/src/misc/blas.h | 97 + src/3rdparty/eigen/Eigen/src/misc/lapacke.h | 10085 ++++++++++++++++ .../eigen/Eigen/src/misc/lapacke_helpers.h | 163 + .../eigen/Eigen/src/misc/lapacke_mangling.h | 16 + .../Eigen/src/plugins/ArrayCwiseBinaryOps.inc | 344 + .../Eigen/src/plugins/ArrayCwiseUnaryOps.inc | 544 + .../eigen/Eigen/src/plugins/BlockMethods.inc | 1370 +++ .../src/plugins/CommonCwiseBinaryOps.inc | 116 + .../Eigen/src/plugins/CommonCwiseUnaryOps.inc | 167 + .../Eigen/src/plugins/IndexedViewMethods.inc | 192 + .../Eigen/src/plugins/InternalHeaderCheck.inc | 3 + .../src/plugins/MatrixCwiseBinaryOps.inc | 331 + .../Eigen/src/plugins/MatrixCwiseUnaryOps.inc | 118 + .../Eigen/src/plugins/ReshapedMethods.inc | 133 + src/3rdparty/eigen/INSTALL | 35 + src/3rdparty/eigen/LICENSE | 373 + src/3rdparty/eigen/README.md | 5 + src/3rdparty/eigen/REUSE.toml | 44 + src/3rdparty/eigen/qt_attribution.json | 26 + src/3rdparty/ffmpeg/LICENSE.BSD-2-Clause.txt | 9 + .../ffmpeg/LICENSE.BSD-Source-Code.txt | 10 + src/3rdparty/ffmpeg/LICENSE.BSL-1.0.txt | 7 + src/3rdparty/ffmpeg/LICENSE.IJG.txt | 38 + src/3rdparty/ffmpeg/LICENSE.ISC.txt | 8 + .../ffmpeg/LICENSE.LGPL-2.1-or-later.txt | 468 + src/3rdparty/ffmpeg/LICENSE.MIT.txt | 9 + src/3rdparty/ffmpeg/LICENSE.Zlib.txt | 11 + src/3rdparty/ffmpeg/qt_attribution.json | 64 + src/3rdparty/pffft/COPYRIGHTS | 2 + src/3rdparty/pffft/LICENSE | 45 + src/3rdparty/pffft/README.md | 320 + src/3rdparty/pffft/REUSE.toml | 9 + src/3rdparty/pffft/fftpack.c | 3111 +++++ src/3rdparty/pffft/fftpack.h | 799 ++ src/3rdparty/pffft/pffft.c | 1906 +++ src/3rdparty/pffft/pffft.h | 181 + src/3rdparty/pffft/qt_attribution.json | 17 + src/3rdparty/pffft/test_pffft.c | 526 + src/3rdparty/resonance-audio/.travis.yml | 17 + src/3rdparty/resonance-audio/AUTHORS | 10 + src/3rdparty/resonance-audio/CMakeLists.txt | 109 + src/3rdparty/resonance-audio/CODEOWNERS | 6 + src/3rdparty/resonance-audio/CONTRIBUTING.md | 14 + src/3rdparty/resonance-audio/COPYRIGHTS | 1 + src/3rdparty/resonance-audio/LICENSE | 202 + src/3rdparty/resonance-audio/README.md | 192 + src/3rdparty/resonance-audio/REUSE.toml | 7 + src/3rdparty/resonance-audio/build.sh | 151 + ...udio-avoid-c-linkage-for-ABI-factory.patch | 39 + ...01-resonance-audio-namespace-loggers.patch | 33 + .../0001-resonance_audio-fix-C-20-build.patch | 36 + .../resonance-audio/platforms/CMakeLists.txt | 30 + .../platforms/common/room_effects_utils.cc | 327 + .../platforms/common/room_effects_utils.h | 83 + .../common/room_effects_utils_test.cc | 197 + .../platforms/common/room_properties.h | 123 + .../resonance-audio/platforms/common/utils.cc | 59 + .../resonance-audio/platforms/common/utils.h | 55 + .../platforms/common/utils_test.cc | 107 + .../resonance-audio/qt_attribution.json | 22 + .../resonance_audio/CMakeLists.txt | 335 + .../ambisonics/ambisonic_binaural_decoder.cc | 80 + .../ambisonics/ambisonic_binaural_decoder.h | 71 + .../ambisonic_binaural_decoder_test.cc | 162 + .../ambisonics/ambisonic_codec.h | 62 + .../ambisonics/ambisonic_codec_impl.h | 295 + .../ambisonics/ambisonic_codec_impl_test.cc | 354 + .../ambisonics/ambisonic_lookup_table.cc | 231 + .../ambisonics/ambisonic_lookup_table.h | 92 + .../ambisonics/ambisonic_lookup_table_test.cc | 240 + .../ambisonic_spread_coefficients.h | 610 + ...sociated_legendre_polynomials_generator.cc | 147 + ...ssociated_legendre_polynomials_generator.h | 89 + ...ted_legendre_polynomials_generator_test.cc | 167 + .../resonance_audio/ambisonics/foa_rotator.cc | 117 + .../resonance_audio/ambisonics/foa_rotator.h | 61 + .../ambisonics/foa_rotator_test.cc | 201 + .../resonance_audio/ambisonics/hoa_rotator.cc | 308 + .../resonance_audio/ambisonics/hoa_rotator.h | 69 + .../ambisonics/hoa_rotator_test.cc | 201 + .../stereo_from_soundfield_converter.cc | 52 + .../stereo_from_soundfield_converter.h | 35 + .../stereo_from_soundfield_converter_test.cc | 103 + .../resonance_audio/ambisonics/utils.h | 120 + .../resonance_audio/ambisonics/utils_test.cc | 65 + .../api/binaural_surround_renderer.cc | 35 + .../api/binaural_surround_renderer.h | 255 + .../api/resonance_audio_api.cc | 30 + .../resonance_audio/api/resonance_audio_api.h | 416 + .../resonance_audio/base/aligned_allocator.h | 117 + .../base/aligned_allocator_test.cc | 53 + .../resonance_audio/base/audio_buffer.cc | 74 + .../resonance_audio/base/audio_buffer.h | 222 + .../resonance_audio/base/audio_buffer_test.cc | 144 + .../resonance_audio/base/channel_view.cc | 50 + .../resonance_audio/base/channel_view.h | 138 + .../resonance_audio/base/channel_view_test.cc | 157 + .../base/constants_and_types.h | 176 + .../resonance_audio/base/integral_types.h | 121 + .../resonance_audio/base/logging.h | 112 + .../resonance_audio/base/misc_math.cc | 94 + .../resonance_audio/base/misc_math.h | 385 + .../resonance_audio/base/misc_math_test.cc | 373 + .../resonance_audio/base/object_transform.h | 31 + .../resonance_audio/base/simd_macros.h | 65 + .../resonance_audio/base/simd_utils.cc | 1299 ++ .../resonance_audio/base/simd_utils.h | 296 + .../resonance_audio/base/simd_utils_test.cc | 711 ++ .../resonance_audio/base/source_parameters.h | 101 + .../resonance_audio/base/spherical_angle.cc | 78 + .../resonance_audio/base/spherical_angle.h | 87 + .../base/spherical_angle_test.cc | 122 + .../resonance_audio/base/unique_ptr_wrapper.h | 33 + .../resonance_audio/config/global_config.h | 37 + .../resonance_audio/config/source_config.cc | 76 + .../resonance_audio/config/source_config.h | 32 + .../resonance_audio/dsp/biquad_filter.cc | 149 + .../resonance_audio/dsp/biquad_filter.h | 137 + .../resonance_audio/dsp/biquad_filter_test.cc | 303 + .../resonance_audio/dsp/channel_converter.cc | 45 + .../resonance_audio/dsp/channel_converter.h | 40 + .../dsp/channel_converter_test.cc | 80 + .../resonance_audio/dsp/circular_buffer.cc | 120 + .../resonance_audio/dsp/circular_buffer.h | 96 + .../dsp/circular_buffer_test.cc | 230 + .../resonance_audio/dsp/delay_filter.cc | 180 + .../resonance_audio/dsp/delay_filter.h | 85 + .../resonance_audio/dsp/delay_filter_test.cc | 197 + .../dsp/distance_attenuation.cc | 121 + .../dsp/distance_attenuation.h | 82 + .../dsp/distance_attenuation_test.cc | 132 + .../resonance_audio/dsp/fft_manager.cc | 209 + .../resonance_audio/dsp/fft_manager.h | 182 + .../resonance_audio/dsp/fft_manager_test.cc | 260 + .../dsp/filter_coefficient_generators.cc | 165 + .../dsp/filter_coefficient_generators.h | 177 + .../dsp/filter_coefficient_generators_test.cc | 146 + .../resonance_audio/dsp/fir_filter.cc | 148 + .../resonance_audio/dsp/fir_filter.h | 62 + .../resonance_audio/dsp/fir_filter_test.cc | 104 + .../resonance_audio/dsp/gain.cc | 102 + .../resonance_audio/dsp/gain.h | 67 + .../resonance_audio/dsp/gain_mixer.cc | 115 + .../resonance_audio/dsp/gain_mixer.h | 96 + .../resonance_audio/dsp/gain_mixer_test.cc | 188 + .../resonance_audio/dsp/gain_processor.cc | 94 + .../resonance_audio/dsp/gain_processor.h | 74 + .../dsp/gain_processor_test.cc | 181 + .../resonance_audio/dsp/gain_test.cc | 132 + .../resonance_audio/dsp/mixer.cc | 56 + .../resonance_audio/dsp/mixer.h | 62 + .../resonance_audio/dsp/mixer_test.cc | 163 + .../resonance_audio/dsp/mono_pole_filter.cc | 59 + .../resonance_audio/dsp/mono_pole_filter.h | 57 + .../dsp/mono_pole_filter_test.cc | 59 + .../resonance_audio/dsp/multi_channel_iir.cc | 152 + .../resonance_audio/dsp/multi_channel_iir.h | 88 + .../dsp/multi_channel_iir_test.cc | 117 + .../dsp/near_field_processor.cc | 97 + .../dsp/near_field_processor.h | 75 + .../dsp/occlusion_calculator.cc | 52 + .../dsp/occlusion_calculator.h | 54 + .../dsp/occlusion_calculator_test.cc | 139 + .../dsp/partitioned_fft_filter.cc | 267 + .../dsp/partitioned_fft_filter.h | 167 + .../dsp/partitioned_fft_filter_test.cc | 761 ++ .../resonance_audio/dsp/reflection.h | 34 + .../dsp/reflections_processor.cc | 177 + .../dsp/reflections_processor.h | 128 + .../dsp/reflections_processor_test.cc | 142 + .../resonance_audio/dsp/resampler.cc | 335 + .../resonance_audio/dsp/resampler.h | 135 + .../resonance_audio/dsp/resampler_test.cc | 325 + .../dsp/reverb_onset_compensator.cc | 214 + .../dsp/reverb_onset_compensator.h | 110 + .../dsp/reverb_onset_update_processor.cc | 184 + .../dsp/reverb_onset_update_processor.h | 113 + .../resonance_audio/dsp/sh_hrir_creator.cc | 72 + .../resonance_audio/dsp/sh_hrir_creator.h | 54 + .../resonance_audio/dsp/shoe_box_room.cc | 61 + .../resonance_audio/dsp/shoe_box_room.h | 44 + .../resonance_audio/dsp/shoe_box_room_test.cc | 96 + .../resonance_audio/dsp/spectral_reverb.cc | 350 + .../resonance_audio/dsp/spectral_reverb.h | 173 + .../spectral_reverb_constants_and_tables.h | 6508 ++++++++++ .../dsp/spectral_reverb_test.cc | 324 + .../resonance_audio/dsp/stereo_panner.cc | 46 + .../resonance_audio/dsp/stereo_panner.h | 35 + .../resonance_audio/dsp/stereo_panner_test.cc | 88 + .../resonance_audio/dsp/utils.cc | 190 + .../resonance_audio/dsp/utils.h | 93 + .../resonance_audio/dsp/utils_test.cc | 194 + .../geometrical_acoustics/acoustic_listener.h | 57 + .../geometrical_acoustics/acoustic_ray.cc | 27 + .../geometrical_acoustics/acoustic_ray.h | 195 + .../acoustic_ray_test.cc | 243 + .../geometrical_acoustics/acoustic_source.h | 111 + .../acoustic_source_test.cc | 136 + .../collection_kernel.cc | 128 + .../geometrical_acoustics/collection_kernel.h | 79 + .../collection_kernel_test.cc | 353 + .../geometrical_acoustics/estimating_rt60.cc | 155 + .../geometrical_acoustics/estimating_rt60.h | 38 + .../estimating_rt60_test.cc | 185 + .../impulse_response_computer.cc | 188 + .../impulse_response_computer.h | 112 + .../impulse_response_computer_test.cc | 377 + .../geometrical_acoustics/mesh.h | 40 + .../geometrical_acoustics/parallel_for.cc | 44 + .../geometrical_acoustics/parallel_for.h | 53 + .../parallel_for_test.cc | 65 + .../geometrical_acoustics/path.h | 36 + .../geometrical_acoustics/path_tracer.cc | 96 + .../geometrical_acoustics/path_tracer.h | 59 + .../geometrical_acoustics/path_tracer_test.cc | 193 + .../proxy_room_estimator.cc | 438 + .../proxy_room_estimator.h | 156 + .../proxy_room_estimator_test.cc | 317 + .../reflection_kernel.cc | 99 + .../geometrical_acoustics/reflection_kernel.h | 104 + .../reflection_kernel_test.cc | 300 + .../geometrical_acoustics/sampling.h | 126 + .../geometrical_acoustics/scene_manager.cc | 153 + .../geometrical_acoustics/scene_manager.h | 130 + .../scene_manager_test.cc | 202 + .../geometrical_acoustics/sphere.cc | 120 + .../geometrical_acoustics/sphere.h | 69 + .../geometrical_acoustics/sphere_test.cc | 267 + .../geometrical_acoustics/test_util.cc | 231 + .../geometrical_acoustics/test_util.h | 131 + .../graph/ambisonic_binaural_decoder_node.cc | 111 + .../graph/ambisonic_binaural_decoder_node.h | 88 + .../graph/ambisonic_mixing_encoder_node.cc | 69 + .../graph/ambisonic_mixing_encoder_node.h | 71 + .../ambisonic_mixing_encoder_node_test.cc | 150 + .../graph/binaural_surround_renderer_impl.cc | 495 + .../graph/binaural_surround_renderer_impl.h | 190 + .../binaural_surround_renderer_impl_test.cc | 202 + .../graph/buffered_source_node.cc | 46 + .../graph/buffered_source_node.h | 62 + .../resonance_audio/graph/foa_rotator_node.cc | 67 + .../resonance_audio/graph/foa_rotator_node.h | 54 + .../resonance_audio/graph/gain_mixer_node.cc | 66 + .../resonance_audio/graph/gain_mixer_node.h | 68 + .../graph/gain_mixer_node_test.cc | 246 + .../resonance_audio/graph/gain_node.cc | 82 + .../resonance_audio/graph/gain_node.h | 69 + .../resonance_audio/graph/gain_node_test.cc | 138 + .../resonance_audio/graph/graph_manager.cc | 290 + .../resonance_audio/graph/graph_manager.h | 404 + .../graph/graph_manager_config.h | 40 + .../resonance_audio/graph/hoa_rotator_node.cc | 69 + .../resonance_audio/graph/hoa_rotator_node.h | 55 + .../resonance_audio/graph/mixer_node.cc | 57 + .../resonance_audio/graph/mixer_node.h | 54 + .../resonance_audio/graph/mixer_node_test.cc | 112 + .../graph/mono_from_soundfield_node.cc | 45 + .../graph/mono_from_soundfield_node.h | 44 + .../graph/near_field_effect_node.cc | 117 + .../graph/near_field_effect_node.h | 69 + .../graph/near_field_effect_node_test.cc | 127 + .../resonance_audio/graph/occlusion_node.cc | 101 + .../resonance_audio/graph/occlusion_node.h | 59 + .../graph/occlusion_node_test.cc | 186 + .../resonance_audio/graph/reflections_node.cc | 113 + .../resonance_audio/graph/reflections_node.h | 78 + .../graph/resonance_audio_api_impl.cc | 586 + .../graph/resonance_audio_api_impl.h | 175 + .../resonance_audio/graph/reverb_node.cc | 162 + .../resonance_audio/graph/reverb_node.h | 99 + .../graph/source_graph_config.h | 43 + .../graph/source_parameters_manager.cc | 58 + .../graph/source_parameters_manager.h | 68 + .../graph/source_parameters_manager_test.cc | 91 + .../graph/stereo_mixing_panner_node.cc | 65 + .../graph/stereo_mixing_panner_node.h | 61 + .../resonance_audio/graph/system_settings.h | 189 + .../resonance_audio/node/audio_nodes_test.cc | 407 + .../resonance_audio/node/node.h | 258 + .../resonance_audio/node/node_test.cc | 330 + .../resonance_audio/node/processing_node.cc | 89 + .../resonance_audio/node/processing_node.h | 115 + .../resonance_audio/node/publisher_node.h | 51 + .../resonance_audio/node/sink_node.cc | 54 + .../resonance_audio/node/sink_node.h | 59 + .../resonance_audio/node/source_node.cc | 41 + .../resonance_audio/node/source_node.h | 68 + .../resonance_audio/node/subscriber_node.h | 48 + .../utils/buffer_crossfader.cc | 66 + .../resonance_audio/utils/buffer_crossfader.h | 48 + .../utils/buffer_crossfader_test.cc | 53 + .../utils/buffer_partitioner.cc | 160 + .../utils/buffer_partitioner.h | 152 + .../utils/buffer_partitioner_test.cc | 241 + .../utils/buffer_unpartitioner.cc | 132 + .../utils/buffer_unpartitioner.h | 135 + .../utils/buffer_unpartitioner_test.cc | 294 + .../utils/lockless_task_queue.cc | 156 + .../utils/lockless_task_queue.h | 124 + .../utils/lockless_task_queue_test.cc | 215 + .../utils/ogg_vorbis_recorder.cc | 107 + .../utils/ogg_vorbis_recorder.h | 94 + .../utils/planar_interleaved_conversion.cc | 505 + .../utils/planar_interleaved_conversion.h | 421 + .../planar_interleaved_conversion_test.cc | 875 ++ .../resonance_audio/utils/pseudoinverse.h | 45 + .../utils/pseudoinverse_test.cc | 87 + .../utils/sample_type_conversion.cc | 40 + .../utils/sample_type_conversion.h | 79 + .../utils/sample_type_conversion_test.cc | 80 + .../utils/semi_lockless_fifo.h | 232 + .../utils/sum_and_difference_processor.cc | 40 + .../utils/sum_and_difference_processor.h | 44 + .../sum_and_difference_processor_test.cc | 42 + .../resonance_audio/utils/task_thread_pool.cc | 249 + .../resonance_audio/utils/task_thread_pool.h | 121 + .../utils/task_thread_pool_test.cc | 185 + .../resonance_audio/utils/test_util.cc | 190 + .../resonance_audio/utils/test_util.h | 91 + .../resonance_audio/utils/test_util_test.cc | 249 + .../resonance_audio/utils/threadsafe_fifo.h | 258 + .../utils/vorbis_stream_encoder.cc | 174 + .../utils/vorbis_stream_encoder.h | 114 + .../resonance_audio/utils/wav.cc | 53 + .../resonance_audio/utils/wav.h | 66 + .../resonance_audio/utils/wav_reader.cc | 214 + .../resonance_audio/utils/wav_reader.h | 103 + .../third_party/SADIE_hrtf_database/LICENSE | 157 + .../generate_hrtf_assets.py | 287 + .../SADIE_hrtf_database/generated/README | 5 + .../generated/hrtf_assets.cc | 1200 ++ .../generated/hrtf_assets.h | 45 + .../SADIE_hrtf_database/hrtf_assets.iad | 8 + src/3rdparty/signalsmith-stretch/LICENSE.txt | 21 + src/3rdparty/signalsmith-stretch/README.md | 142 + src/3rdparty/signalsmith-stretch/REUSE.toml | 6 + .../signalsmith-stretch/dsp/LICENSE.txt | 21 + .../signalsmith-stretch/dsp/README.md | 40 + src/3rdparty/signalsmith-stretch/dsp/common.h | 43 + src/3rdparty/signalsmith-stretch/dsp/curves.h | 371 + src/3rdparty/signalsmith-stretch/dsp/delay.h | 717 ++ .../signalsmith-stretch/dsp/envelopes.h | 523 + src/3rdparty/signalsmith-stretch/dsp/fft.h | 521 + .../signalsmith-stretch/dsp/filters.h | 436 + src/3rdparty/signalsmith-stretch/dsp/mix.h | 218 + src/3rdparty/signalsmith-stretch/dsp/perf.h | 84 + src/3rdparty/signalsmith-stretch/dsp/rates.h | 184 + .../signalsmith-stretch/dsp/spectral.h | 492 + .../signalsmith-stretch/dsp/windows.h | 219 + .../signalsmith-stretch/qt_attribution.json | 19 + .../signalsmith-stretch/signalsmith-stretch.h | 640 + ...mplementation-to-QtPrivate-namespace.patch | 90 + src/3rdparty/tlsf/CMakeLists.txt | 12 + src/3rdparty/tlsf/REUSE.toml | 6 + src/3rdparty/tlsf/qt_attribution.json | 17 + src/3rdparty/tlsf/tlsf.cpp | 1272 ++ src/3rdparty/tlsf/tlsf.h | 92 + src/CMakeLists.txt | 42 + src/android/CMakeLists.txt | 6 + src/android/jar/AndroidManifest.xml | 6 + src/android/jar/CMakeLists.txt | 40 + .../multimedia/QtAndroidMediaPlayer.java | 752 ++ .../multimedia/QtAudioDeviceManager.java | 596 + .../android/multimedia/QtCameraListener.java | 205 + .../multimedia/QtMediaRecorderListener.java | 31 + .../android/multimedia/QtMultimediaUtils.java | 149 + .../multimedia/QtSurfaceHolderCallback.java | 37 + .../multimedia/QtSurfaceTextureHolder.java | 89 + .../multimedia/QtSurfaceTextureListener.java | 24 + .../multimedia/qffmpeg/CameraSettings.java | 71 + .../android/multimedia/qffmpeg/QtCamera2.java | 1116 ++ .../qffmpeg/QtCameraAvailabilityListener.java | 116 + .../multimedia/qffmpeg/QtExifDataHandler.java | 51 + .../qffmpeg/QtScreenCaptureService.java | 211 + .../multimedia/qffmpeg/QtScreenGrabber.java | 115 + .../qffmpeg/QtVideoDeviceManager.java | 337 + src/multimedia/CMakeLists.txt | 535 + src/multimedia/Qt6MultimediaMacros.cmake | 64 + src/multimedia/alsa/qalsaaudiodevice.cpp | 66 + src/multimedia/alsa/qalsaaudiodevice_p.h | 37 + src/multimedia/alsa/qalsaaudiodevices.cpp | 128 + src/multimedia/alsa/qalsaaudiodevices_p.h | 45 + src/multimedia/alsa/qalsaaudiosink.cpp | 643 + src/multimedia/alsa/qalsaaudiosink_p.h | 112 + src/multimedia/alsa/qalsaaudiosource.cpp | 709 ++ src/multimedia/alsa/qalsaaudiosource_p.h | 133 + src/multimedia/android/qaaudiostream.cpp | 250 + src/multimedia/android/qaaudiostream_p.h | 94 + .../android/qandroidaudiodevice.cpp | 50 + .../android/qandroidaudiodevice_p.h | 40 + .../android/qandroidaudiodevices.cpp | 183 + .../android/qandroidaudiodevices_p.h | 48 + .../android/qandroidaudiojnitypes_p.h | 29 + src/multimedia/android/qandroidaudiosink.cpp | 260 + src/multimedia/android/qandroidaudiosink_p.h | 100 + .../android/qandroidaudiosource.cpp | 234 + .../android/qandroidaudiosource_p.h | 94 + src/multimedia/android/qandroidaudioutil.cpp | 49 + src/multimedia/android/qandroidaudioutil_p.h | 32 + src/multimedia/audio/q_pmr_emulation_p.h | 224 + src/multimedia/audio/qaudio.h | 100 + .../audio/qaudio_alignment_support_p.h | 67 + src/multimedia/audio/qaudio_dr_wav.cpp | 7 + ...qaudio_platform_implementation_support_p.h | 641 + .../audio/qaudio_qiodevice_support_p.h | 241 + src/multimedia/audio/qaudio_qspan_support_p.h | 48 + src/multimedia/audio/qaudio_rtsan_support_p.h | 65 + src/multimedia/audio/qaudiobuffer.cpp | 326 + src/multimedia/audio/qaudiobuffer.h | 173 + src/multimedia/audio/qaudiobuffer_support_p.h | 100 + src/multimedia/audio/qaudiobufferinput.cpp | 202 + src/multimedia/audio/qaudiobufferinput.h | 48 + src/multimedia/audio/qaudiobufferoutput.cpp | 83 + src/multimedia/audio/qaudiobufferoutput.h | 38 + src/multimedia/audio/qaudiobufferoutput_p.h | 43 + src/multimedia/audio/qaudiodecoder.cpp | 386 + src/multimedia/audio/qaudiodecoder.h | 85 + src/multimedia/audio/qaudiodecoder_p.h | 40 + src/multimedia/audio/qaudiodevice.cpp | 524 + src/multimedia/audio/qaudiodevice.h | 85 + src/multimedia/audio/qaudiodevice_p.h | 136 + src/multimedia/audio/qaudioformat.cpp | 497 + src/multimedia/audio/qaudioformat.h | 161 + src/multimedia/audio/qaudioformat_p.h | 65 + src/multimedia/audio/qaudiohelpers.cpp | 491 + src/multimedia/audio/qaudiohelpers_p.h | 89 + src/multimedia/audio/qaudioinput.cpp | 199 + src/multimedia/audio/qaudioinput.h | 54 + src/multimedia/audio/qaudiooutput.cpp | 235 + src/multimedia/audio/qaudiooutput.h | 55 + src/multimedia/audio/qaudioringbuffer_p.h | 250 + src/multimedia/audio/qaudiosink.cpp | 523 + src/multimedia/audio/qaudiosink.h | 96 + src/multimedia/audio/qaudiosource.cpp | 539 + src/multimedia/audio/qaudiosource.h | 97 + src/multimedia/audio/qaudiosystem.cpp | 115 + src/multimedia/audio/qaudiosystem_p.h | 474 + .../qaudiosystem_platform_stream_support.cpp | 518 + .../qaudiosystem_platform_stream_support_p.h | 323 + .../audio/qautoresetevent_kqueue.cpp | 71 + .../audio/qautoresetevent_kqueue_p.h | 65 + .../audio/qautoresetevent_linux.cpp | 64 + .../audio/qautoresetevent_linux_p.h | 62 + src/multimedia/audio/qautoresetevent_p.h | 60 + src/multimedia/audio/qautoresetevent_pipe.cpp | 77 + src/multimedia/audio/qautoresetevent_pipe_p.h | 66 + .../audio/qautoresetevent_win32.cpp | 61 + .../audio/qautoresetevent_win32_p.h | 62 + .../audio/qmemory_resource_tlsf.cpp | 60 + .../audio/qmemory_resource_tlsf_p.h | 61 + src/multimedia/audio/qrtaudioengine.cpp | 407 + src/multimedia/audio/qrtaudioengine_p.h | 299 + src/multimedia/audio/qsamplecache_p.cpp | 409 + src/multimedia/audio/qsamplecache_p.h | 139 + src/multimedia/audio/qsoundeffect.cpp | 580 + src/multimedia/audio/qsoundeffect.h | 102 + src/multimedia/audio/qsoundeffect_p.h | 59 + .../audio/qsoundeffectsynchronous.cpp | 413 + .../audio/qsoundeffectsynchronous_p.h | 99 + .../audio/qsoundeffectwithplayer.cpp | 605 + .../audio/qsoundeffectwithplayer_p.h | 141 + src/multimedia/audio/qtaudio.cpp | 254 + src/multimedia/audio/qtaudio.h | 127 + src/multimedia/audio/qwavedecoder.cpp | 491 + src/multimedia/audio/qwavedecoder.h | 119 + src/multimedia/camera/qcamera.cpp | 1483 +++ src/multimedia/camera/qcamera.h | 269 + src/multimedia/camera/qcamera_p.h | 42 + src/multimedia/camera/qcameradevice.cpp | 513 + src/multimedia/camera/qcameradevice.h | 109 + src/multimedia/camera/qcameradevice_p.h | 81 + src/multimedia/camera/qimagecapture.cpp | 623 + src/multimedia/camera/qimagecapture.h | 132 + src/multimedia/compat/removed_api.cpp | 69 + src/multimedia/configure.cmake | 313 + src/multimedia/darwin/qavfcamerabase.mm | 1061 ++ src/multimedia/darwin/qavfcamerabase_p.h | 122 + src/multimedia/darwin/qavfcameradebug_p.h | 26 + src/multimedia/darwin/qavfcamerautility.mm | 719 ++ src/multimedia/darwin/qavfcamerautility_p.h | 181 + src/multimedia/darwin/qavfhelpers.mm | 151 + src/multimedia/darwin/qavfhelpers_p.h | 66 + src/multimedia/darwin/qavfvideodevices.mm | 300 + src/multimedia/darwin/qavfvideodevices_p.h | 83 + .../darwin/qcoreaudiosessionmanager.mm | 424 + .../darwin/qcoreaudiosessionmanager_p.h | 94 + src/multimedia/darwin/qcoreaudioutils.cpp | 513 + src/multimedia/darwin/qcoreaudioutils_p.h | 104 + src/multimedia/darwin/qdarwinaudiodevice.cpp | 205 + src/multimedia/darwin/qdarwinaudiodevice_p.h | 37 + src/multimedia/darwin/qdarwinaudiodevices.mm | 330 + src/multimedia/darwin/qdarwinaudiodevices_p.h | 91 + src/multimedia/darwin/qdarwinaudiosink.mm | 337 + src/multimedia/darwin/qdarwinaudiosink_p.h | 107 + src/multimedia/darwin/qdarwinaudiosource.mm | 402 + src/multimedia/darwin/qdarwinaudiosource_p.h | 111 + .../darwin/qdarwinintegrationfactory.mm | 19 + .../darwin/qdarwinintegrationfactory_p.h | 35 + .../darwin/qmacosaudiodatautils.cpp | 204 + .../darwin/qmacosaudiodatautils_p.h | 158 + src/multimedia/doc/QtMultimediaDoc | 5 + src/multimedia/doc/qtmultimedia.qdocconf | 108 + src/multimedia/doc/snippets/CMakeLists.txt | 15 + .../custommediainputsnippets/CMakeLists.txt | 31 + .../custommediainputsnippets.cpp | 90 + .../custommediainputsnippets.h | 42 + .../custommediainputsnippets/main.cpp | 16 + .../snippets/multimedia-snippets/audio.cpp | 336 + .../snippets/multimedia-snippets/camera.cpp | 219 + .../snippets/multimedia-snippets/devices.cpp | 38 + .../multimedia-snippets/images/qt-logo.png | Bin 0 -> 1301 bytes .../snippets/multimedia-snippets/media.cpp | 109 + .../multiple-videooutputs.qml | 33 + .../snippets/multimedia-snippets/qsound.cpp | 35 + .../multimedia-snippets/qtvideosink.qml | 29 + .../multimedia-snippets/soundeffect.qml | 25 + .../snippets/multimedia-snippets/video.cpp | 118 + .../src/advanced-ffmpeg-configuration.qdoc | 135 + src/multimedia/doc/src/audiooverview.qdoc | 164 + .../doc/src/backend-notes-gstreamer.qdoc | 248 + src/multimedia/doc/src/cameraoverview.qdoc | 278 + src/multimedia/doc/src/classic.css | 284 + .../doc/src/cmake/cmake-variables.qdoc | 26 + .../cmake/qt_add_ios_ffmpeg_libraries.qdoc | 58 + src/multimedia/doc/src/images/Zoom.gif | Bin 0 -> 706673 bytes .../doc/src/images/annotatedurl.png | Bin 0 -> 34705 bytes .../src/images/camera_correctionAngle_90.png | Bin 0 -> 48562 bytes src/multimedia/doc/src/images/codeless.png | Bin 0 -> 4636 bytes .../doc/src/images/how-focus-works.gif | Bin 0 -> 289878 bytes .../doc/src/images/image_processing.png | Bin 0 -> 215435 bytes .../doc/src/images/noun_Media_166644.svg | 64 + src/multimedia/doc/src/images/qS1FmgPVL.jpg | Bin 0 -> 23184 bytes .../doc/src/images/qmlcamera-menu.png | Bin 0 -> 64550 bytes .../doc/src/images/radio-example.png | Bin 0 -> 11702 bytes .../doc/src/images/slideshow-img1.png | Bin 0 -> 596624 bytes .../doc/src/images/sound-wave-small.jpg | Bin 0 -> 37707 bytes .../doc/src/images/video-graphics-memory.png | Bin 0 -> 12945 bytes .../building-FFmpeg-configure.qdocinc | 317 + .../includes/building-FFmpeg-contents.qdocinc | 72 + .../building-FFmpeg-prerequisites.qdocinc | 315 + .../includes/building-FFmpeg-source.qdocinc | 62 + .../cmake-find-package-multimedia.qdocinc | 6 + .../doc/src/multimedia-overview.qdoc | 141 + .../doc/src/platform-notes-apple.qdoc | 50 + .../doc/src/platform-notes-linux.qdoc | 34 + .../doc/src/platform-notes-wasm.qdoc | 47 + .../doc/src/platform-notes-windows.qdoc | 29 + src/multimedia/doc/src/qm-external-pages.qdoc | 252 + src/multimedia/doc/src/qt6-changes.qdoc | 141 + ...timedia-building-FFmpeg-android-linux.qdoc | 14 + ...timedia-building-FFmpeg-android-macos.qdoc | 14 + ...media-building-FFmpeg-android-windows.qdoc | 14 + .../src/qtmultimedia-building-FFmpeg-ios.qdoc | 256 + .../qtmultimedia-building-FFmpeg-linux.qdoc | 14 + .../qtmultimedia-building-FFmpeg-macos.qdoc | 14 + .../qtmultimedia-building-FFmpeg-windows.qdoc | 14 + .../doc/src/qtmultimedia-building-FFmpeg.qdoc | 53 + .../qtmultimedia-building-from-source.qdoc | 112 + src/multimedia/doc/src/qtmultimedia-cpp.qdoc | 45 + .../doc/src/qtmultimedia-examples.qdoc | 15 + .../doc/src/qtmultimedia-ffmpeg-stubs.qdoc | 109 + .../doc/src/qtmultimedia-index.qdoc | 323 + .../doc/src/qtmultimedia-qml-types.qdoc | 45 + src/multimedia/doc/src/qtmultimedia-toc.qdoc | 40 + src/multimedia/doc/src/videooverview.qdoc | 124 + .../pipewire/qpipewire_async_support.cpp | 150 + .../pipewire/qpipewire_async_support_p.h | 104 + .../qpipewire_audiocontextmanager.cpp | 469 + .../qpipewire_audiocontextmanager_p.h | 132 + .../pipewire/qpipewire_audiodevice.cpp | 164 + .../pipewire/qpipewire_audiodevice_p.h | 49 + .../pipewire/qpipewire_audiodevicemonitor.cpp | 636 + .../pipewire/qpipewire_audiodevicemonitor_p.h | 191 + .../pipewire/qpipewire_audiodevices.cpp | 68 + .../pipewire/qpipewire_audiodevices_p.h | 56 + .../pipewire/qpipewire_audiosink.cpp | 390 + .../pipewire/qpipewire_audiosink_p.h | 122 + .../pipewire/qpipewire_audiosource.cpp | 283 + .../pipewire/qpipewire_audiosource_p.h | 111 + .../pipewire/qpipewire_audiostream.cpp | 255 + .../pipewire/qpipewire_audiostream_p.h | 100 + .../pipewire/qpipewire_instance.cpp | 64 + .../pipewire/qpipewire_instance_p.h | 43 + .../pipewire/qpipewire_propertydict.cpp | 159 + .../pipewire/qpipewire_propertydict_p.h | 68 + .../pipewire/qpipewire_registry_support.cpp | 52 + .../pipewire/qpipewire_registry_support_p.h | 51 + .../pipewire/qpipewire_screencapture.cpp | 43 + .../pipewire/qpipewire_screencapture_p.h | 48 + .../qpipewire_screencapturehelper.cpp | 938 ++ .../qpipewire_screencapturehelper_p.h | 148 + .../pipewire/qpipewire_spa_compat_p.h | 140 + .../qpipewire_spa_pod_parser_support_p.h | 189 + .../pipewire/qpipewire_spa_pod_support.cpp | 236 + .../pipewire/qpipewire_spa_pod_support_p.h | 77 + src/multimedia/pipewire/qpipewire_support.cpp | 104 + src/multimedia/pipewire/qpipewire_support_p.h | 141 + .../pipewire/qpipewire_symbolloader.cpp | 89 + .../pipewire/qpipewire_symbolloader_p.h | 17 + .../qgstreamer_platformspecificinterface.cpp | 27 + .../qgstreamer_platformspecificinterface_p.h | 59 + .../platform/qplatformaudiobufferinput.cpp | 10 + .../platform/qplatformaudiobufferinput_p.h | 56 + .../platform/qplatformaudiodecoder.cpp | 84 + .../platform/qplatformaudiodecoder_p.h | 93 + .../platform/qplatformaudiodevices.cpp | 198 + .../platform/qplatformaudiodevices_p.h | 82 + .../platform/qplatformaudioinput_p.h | 46 + .../platform/qplatformaudiooutput_p.h | 44 + .../platform/qplatformaudioresampler_p.h | 33 + src/multimedia/platform/qplatformcamera.cpp | 240 + src/multimedia/platform/qplatformcamera_p.h | 238 + .../platform/qplatformcapturablewindows_p.h | 52 + .../platform/qplatformimagecapture.cpp | 28 + .../platform/qplatformimagecapture_p.h | 96 + .../platform/qplatformmediacapture.cpp | 38 + .../platform/qplatformmediacapture_p.h | 89 + .../platform/qplatformmediaformatinfo.cpp | 78 + .../platform/qplatformmediaformatinfo_p.h | 50 + .../platform/qplatformmediaintegration.cpp | 255 + .../platform/qplatformmediaintegration_p.h | 172 + .../platform/qplatformmediaplayer.cpp | 73 + .../platform/qplatformmediaplayer_p.h | 181 + .../platform/qplatformmediaplugin.cpp | 14 + .../platform/qplatformmediaplugin_p.h | 42 + .../platform/qplatformmediarecorder.cpp | 75 + .../platform/qplatformmediarecorder_p.h | 172 + .../platform/qplatformsurfacecapture.cpp | 88 + .../platform/qplatformsurfacecapture_p.h | 87 + .../platform/qplatformvideodevices.cpp | 39 + .../platform/qplatformvideodevices_p.h | 67 + .../platform/qplatformvideoframeinput.cpp | 10 + .../platform/qplatformvideoframeinput_p.h | 55 + .../platform/qplatformvideosink.cpp | 82 + .../platform/qplatformvideosink_p.h | 86 + .../platform/qplatformvideosource.cpp | 15 + .../platform/qplatformvideosource_p.h | 57 + src/multimedia/playback/qmediaplayer.cpp | 1595 +++ src/multimedia/playback/qmediaplayer.h | 238 + src/multimedia/playback/qmediaplayer_p.h | 92 + src/multimedia/playback/qplaybackoptions.cpp | 242 + src/multimedia/playback/qplaybackoptions.h | 72 + .../pulseaudio/qpulseaudio_contextmanager.cpp | 615 + .../pulseaudio/qpulseaudio_contextmanager_p.h | 114 + .../pulseaudio/qpulseaudiodevice_p.h | 32 + .../pulseaudio/qpulseaudiodevices.cpp | 55 + .../pulseaudio/qpulseaudiodevices_p.h | 53 + src/multimedia/pulseaudio/qpulseaudiosink.cpp | 405 + src/multimedia/pulseaudio/qpulseaudiosink_p.h | 106 + .../pulseaudio/qpulseaudiosource.cpp | 339 + .../pulseaudio/qpulseaudiosource_p.h | 104 + src/multimedia/pulseaudio/qpulsehelpers.cpp | 349 + src/multimedia/pulseaudio/qpulsehelpers_p.h | 101 + src/multimedia/qcachedvalue_p.h | 104 + src/multimedia/qerrorinfo_p.h | 57 + src/multimedia/qmediadevices.cpp | 310 + src/multimedia/qmediadevices.h | 51 + src/multimedia/qmediaformat.cpp | 909 ++ src/multimedia/qmediaformat.h | 153 + src/multimedia/qmediaframeinput.cpp | 43 + src/multimedia/qmediaframeinput_p.h | 74 + .../qmediainputencoderinterface_p.h | 31 + src/multimedia/qmediametadata.cpp | 552 + src/multimedia/qmediametadata.h | 98 + src/multimedia/qmediastoragelocation.cpp | 94 + src/multimedia/qmediastoragelocation_p.h | 35 + src/multimedia/qmediatimerange.cpp | 579 + src/multimedia/qmediatimerange.h | 129 + .../qmultimedia_enum_to_string_converter_p.h | 97 + src/multimedia/qmultimedia_ranges_p.h | 200 + src/multimedia/qmultimediautils.cpp | 185 + src/multimedia/qmultimediautils_p.h | 96 + src/multimedia/qnx/qqnxaudiodevice.cpp | 96 + src/multimedia/qnx/qqnxaudiodevice_p.h | 35 + src/multimedia/qnx/qqnxaudiodevices.cpp | 73 + src/multimedia/qnx/qqnxaudiodevices_p.h | 43 + src/multimedia/qnx/qqnxaudiosink.cpp | 474 + src/multimedia/qnx/qqnxaudiosink_p.h | 109 + src/multimedia/qnx/qqnxaudiosource.cpp | 336 + src/multimedia/qnx/qqnxaudiosource_p.h | 101 + src/multimedia/qnx/qqnxaudioutils.cpp | 148 + src/multimedia/qnx/qqnxaudioutils_p.h | 52 + src/multimedia/qrhivaluemapper.cpp | 83 + src/multimedia/qrhivaluemapper_p.h | 155 + src/multimedia/qsharedhandle_p.h | 167 + src/multimedia/qsymbolsresolveutils.cpp | 85 + src/multimedia/qsymbolsresolveutils_p.h | 188 + src/multimedia/qt_cmdline.cmake | 6 + src/multimedia/qtaggedtime_p.h | 119 + src/multimedia/qthreadlocalrhi.cpp | 156 + src/multimedia/qthreadlocalrhi_p.h | 35 + src/multimedia/qtmultimedia_pch_p.h | 52 + src/multimedia/qtmultimediaglobal.h | 11 + src/multimedia/qtmultimediaglobal_p.h | 22 + src/multimedia/qvideotransformation.cpp | 16 + src/multimedia/qvideotransformation_p.h | 75 + .../recording/qcapturablewindow.cpp | 198 + src/multimedia/recording/qcapturablewindow.h | 68 + .../recording/qcapturablewindow_p.h | 52 + .../recording/qmediacapturesession.cpp | 700 ++ .../recording/qmediacapturesession.h | 106 + .../recording/qmediacapturesession_p.h | 53 + src/multimedia/recording/qmediarecorder.cpp | 1213 ++ src/multimedia/recording/qmediarecorder.h | 177 + src/multimedia/recording/qmediarecorder_p.h | 55 + .../qscreencapture-limitations.qdocinc | 49 + src/multimedia/recording/qscreencapture.cpp | 321 + src/multimedia/recording/qscreencapture.h | 72 + src/multimedia/recording/qvideoframeinput.cpp | 199 + src/multimedia/recording/qvideoframeinput.h | 49 + .../qwindowcapture-limitations.qdocinc | 29 + src/multimedia/recording/qwindowcapture.cpp | 318 + src/multimedia/recording/qwindowcapture.h | 71 + src/multimedia/shaders/abgr.frag | 22 + src/multimedia/shaders/argb.frag | 22 + src/multimedia/shaders/ayuv.frag | 28 + src/multimedia/shaders/bgra.frag | 22 + src/multimedia/shaders/colorconvert.glsl | 22 + src/multimedia/shaders/colortransfer.glsl | 121 + src/multimedia/shaders/compile.bat | 16 + src/multimedia/shaders/externalsampler.frag | 17 + src/multimedia/shaders/externalsampler.vert | 19 + .../shaders/externalsampler_gles.frag | 35 + src/multimedia/shaders/hdrtonemapper.glsl | 41 + src/multimedia/shaders/imc2.frag | 33 + src/multimedia/shaders/imc4.frag | 33 + src/multimedia/shaders/nv12.frag | 31 + src/multimedia/shaders/nv12_bt2020_hlg.frag | 46 + src/multimedia/shaders/nv12_bt2020_pq.frag | 52 + src/multimedia/shaders/nv21.frag | 31 + src/multimedia/shaders/p016.frag | 31 + src/multimedia/shaders/qrhitextureformats_p.h | 42 + src/multimedia/shaders/rectsampler.vert | 19 + src/multimedia/shaders/rectsampler_bgra.frag | 22 + src/multimedia/shaders/rgba.frag | 22 + src/multimedia/shaders/texturecomponent.glsl | 197 + src/multimedia/shaders/uniformbuffer.glsl | 23 + src/multimedia/shaders/uyvy.frag | 51 + src/multimedia/shaders/vertex.vert | 19 + src/multimedia/shaders/y.frag | 29 + src/multimedia/shaders/y16.frag | 30 + src/multimedia/shaders/yuv_triplanar.frag | 33 + src/multimedia/shaders/yuv_triplanar_p10.frag | 33 + src/multimedia/shaders/yuyv.frag | 51 + src/multimedia/shaders/yvu_triplanar.frag | 33 + src/multimedia/video/qabstractvideobuffer.cpp | 141 + src/multimedia/video/qabstractvideobuffer.h | 33 + src/multimedia/video/qhwvideobuffer.cpp | 17 + src/multimedia/video/qhwvideobuffer_p.h | 115 + src/multimedia/video/qimagevideobuffer.cpp | 78 + src/multimedia/video/qimagevideobuffer_p.h | 40 + src/multimedia/video/qmemoryvideobuffer.cpp | 52 + src/multimedia/video/qmemoryvideobuffer_p.h | 40 + src/multimedia/video/qtvideo.cpp | 32 + src/multimedia/video/qtvideo.h | 30 + src/multimedia/video/qvideoframe.cpp | 1065 ++ src/multimedia/video/qvideoframe.h | 164 + src/multimedia/video/qvideoframe_p.h | 101 + .../video/qvideoframeconversionhelper.cpp | 630 + .../qvideoframeconversionhelper_avx2.cpp | 135 + .../video/qvideoframeconversionhelper_p.h | 142 + .../qvideoframeconversionhelper_sse2.cpp | 123 + .../qvideoframeconversionhelper_ssse3.cpp | 89 + src/multimedia/video/qvideoframeconverter.cpp | 441 + src/multimedia/video/qvideoframeconverter_p.h | 40 + src/multimedia/video/qvideoframeformat.cpp | 964 ++ src/multimedia/video/qvideoframeformat.h | 236 + .../video/qvideoframetexturefromsource.cpp | 55 + .../video/qvideoframetexturefromsource_p.h | 77 + .../video/qvideoframetexturepool.cpp | 47 + .../video/qvideoframetexturepool_p.h | 87 + .../video/qvideooutputorientationhandler.cpp | 52 + .../video/qvideooutputorientationhandler_p.h | 50 + src/multimedia/video/qvideosink.cpp | 194 + src/multimedia/video/qvideosink.h | 57 + src/multimedia/video/qvideotexturehelper.cpp | 1018 ++ src/multimedia/video/qvideotexturehelper_p.h | 188 + src/multimedia/video/qvideowindow.cpp | 529 + src/multimedia/video/qvideowindow_p.h | 123 + src/multimedia/wasm/qwasmaudiodevice.cpp | 66 + src/multimedia/wasm/qwasmaudiodevice_p.h | 30 + src/multimedia/wasm/qwasmaudiosink.cpp | 430 + src/multimedia/wasm/qwasmaudiosink_p.h | 81 + src/multimedia/wasm/qwasmaudiosource.cpp | 283 + src/multimedia/wasm/qwasmaudiosource_p.h | 66 + src/multimedia/wasm/qwasmjs.cpp | 539 + src/multimedia/wasm/qwasmjs_p.h | 126 + src/multimedia/wasm/qwasmmediadevices.cpp | 310 + src/multimedia/wasm/qwasmmediadevices_p.h | 113 + src/multimedia/windows/qcomtaskresource_p.h | 156 + .../windows/qwindows_propertystore.cpp | 103 + .../windows/qwindows_propertystore_p.h | 50 + .../windows/qwindows_scopedpropvariant_p.h | 43 + .../windows/qwindows_wasapi_warmup_client.cpp | 308 + .../windows/qwindows_wasapi_warmup_client_p.h | 32 + .../windows/qwindowsaudiodevice.cpp | 448 + .../windows/qwindowsaudiodevice_p.h | 70 + .../windows/qwindowsaudiodevices.cpp | 512 + .../windows/qwindowsaudiodevices_p.h | 78 + src/multimedia/windows/qwindowsaudiosink.cpp | 437 + src/multimedia/windows/qwindowsaudiosink_p.h | 135 + .../windows/qwindowsaudiosource.cpp | 356 + .../windows/qwindowsaudiosource_p.h | 122 + src/multimedia/windows/qwindowsaudioutils.cpp | 506 + src/multimedia/windows/qwindowsaudioutils_p.h | 93 + .../windows/qwindowsmediafoundation.cpp | 96 + .../windows/qwindowsmediafoundation_p.h | 69 + .../windows/qwindowsmultimediautils.cpp | 228 + .../windows/qwindowsmultimediautils_p.h | 49 + src/multimedia/windows/qwindowsresampler.cpp | 347 + src/multimedia/windows/qwindowsresampler_p.h | 94 + .../windows/qwindowsvideodevices.cpp | 268 + .../windows/qwindowsvideodevices_p.h | 47 + src/multimedia/windows/qwmf_support.cpp | 272 + src/multimedia/windows/qwmf_support_p.h | 157 + src/multimediaquick/CMakeLists.txt | 47 + src/multimediaquick/Video.qml | 419 + src/multimediaquick/multimedia_plugin.cpp | 33 + src/multimediaquick/qquickimagecapture.cpp | 197 + src/multimediaquick/qquickimagecapture_p.h | 58 + .../qquickimagepreviewprovider.cpp | 97 + .../qquickimagepreviewprovider_p.h | 37 + src/multimediaquick/qquickmediaplayer.cpp | 68 + src/multimediaquick/qquickmediaplayer_p.h | 59 + src/multimediaquick/qquickscreencapture.cpp | 35 + src/multimediaquick/qquickscreencapture_p.h | 49 + src/multimediaquick/qquicksoundeffect.cpp | 29 + src/multimediaquick/qquicksoundeffect_p.h | 47 + src/multimediaquick/qquickvideooutput.cpp | 665 + src/multimediaquick/qquickvideooutput_p.h | 204 + src/multimediaquick/qsgvideonode_p.cpp | 437 + src/multimediaquick/qsgvideonode_p.h | 71 + src/multimediaquick/qsgvideotexture.cpp | 78 + src/multimediaquick/qsgvideotexture_p.h | 49 + .../qtmultimediaquickglobal_p.h | 28 + .../qtmultimediaquicktypes.cpp | 12 + .../qtmultimediaquicktypes_p.h | 235 + src/multimediatestlib/CMakeLists.txt | 34 + .../audiogenerationutils_p.h | 153 + .../capturesessionfixture.cpp | 111 + .../capturesessionfixture_p.h | 64 + src/multimediatestlib/formatutils.cpp | 66 + src/multimediatestlib/formatutils_p.h | 31 + src/multimediatestlib/framegenerator.cpp | 124 + src/multimediatestlib/framegenerator_p.h | 73 + src/multimediatestlib/mediabackendutils_p.h | 102 + src/multimediatestlib/mediafileselector_p.h | 192 + src/multimediatestlib/mediainfo_p.h | 130 + .../multimedia_debug_support_p.h | 35 + src/multimediatestlib/osdetection_p.h | 61 + src/multimediatestlib/qcolorutil.cpp | 40 + src/multimediatestlib/qcolorutil_p.h | 30 + src/multimediatestlib/qfileutil.cpp | 44 + src/multimediatestlib/qfileutil_p.h | 26 + src/multimediatestlib/qmockiodevice_p.h | 38 + .../qscopedenvironmentvariable_p.h | 40 + .../qsequentialfileadaptor_p.h | 55 + src/multimediatestlib/qsinewavevalidator.cpp | 65 + src/multimediatestlib/qsinewavevalidator_p.h | 56 + src/multimediatestlib/testvideosink_p.h | 77 + src/multimediawidgets/CMakeLists.txt | 34 + .../snippets/multimedia-snippets/camera.cpp | 37 + .../snippets/multimedia-snippets/video.cpp | 63 + .../doc/src/qtmultimediawidgets-index.qdoc | 36 + .../doc/src/qtmultimediawidgets.qdoc | 13 + src/multimediawidgets/qgraphicsvideoitem.cpp | 258 + src/multimediawidgets/qgraphicsvideoitem.h | 70 + .../qtmultimediawidgetsglobal.h | 9 + src/multimediawidgets/qvideowidget.cpp | 220 + src/multimediawidgets/qvideowidget.h | 59 + src/multimediawidgets/qvideowidget_p.h | 44 + src/plugins/CMakeLists.txt | 4 + src/plugins/multimedia/CMakeLists.txt | 24 + src/plugins/multimedia/android/CMakeLists.txt | 74 + src/plugins/multimedia/android/android.json | 3 + .../android/audio/qandroidaudiodecoder.cpp | 439 + .../android/audio/qandroidaudiodecoder_p.h | 117 + .../android/common/qandroidaudioinput.cpp | 47 + .../android/common/qandroidaudioinput_p.h | 47 + .../android/common/qandroidaudiooutput_p.h | 30 + .../android/common/qandroidglobal_p.h | 28 + .../common/qandroidmultimediautils.cpp | 125 + .../common/qandroidmultimediautils_p.h | 40 + .../android/common/qandroidvideooutput.cpp | 465 + .../android/common/qandroidvideooutput_p.h | 93 + .../android/common/qandroidvideosink.cpp | 35 + .../android/common/qandroidvideosink_p.h | 41 + .../android/mediacapture/qandroidcamera.cpp | 562 + .../android/mediacapture/qandroidcamera_p.h | 99 + .../mediacapture/qandroidcamerasession.cpp | 808 ++ .../mediacapture/qandroidcamerasession_p.h | 166 + .../mediacapture/qandroidcapturesession.cpp | 474 + .../mediacapture/qandroidcapturesession_p.h | 158 + .../mediacapture/qandroidimagecapture.cpp | 73 + .../mediacapture/qandroidimagecapture_p.h | 48 + .../qandroidmediacapturesession.cpp | 115 + .../qandroidmediacapturesession_p.h | 66 + .../mediacapture/qandroidmediaencoder.cpp | 72 + .../mediacapture/qandroidmediaencoder_p.h | 50 + .../mediaplayer/qandroidmediaplayer.cpp | 995 ++ .../mediaplayer/qandroidmediaplayer_p.h | 127 + .../android/mediaplayer/qandroidmetadata.cpp | 163 + .../android/mediaplayer/qandroidmetadata_p.h | 47 + .../android/qandroidformatsinfo.cpp | 160 + .../android/qandroidformatsinfo_p.h | 40 + .../android/qandroidintegration.cpp | 165 + .../android/qandroidintegration_p.h | 50 + .../android/wrappers/jni/androidcamera.cpp | 1799 +++ .../android/wrappers/jni/androidcamera_p.h | 208 + .../jni/androidmediametadataretriever.cpp | 136 + .../jni/androidmediametadataretriever_p.h | 66 + .../wrappers/jni/androidmediaplayer.cpp | 535 + .../wrappers/jni/androidmediaplayer_p.h | 135 + .../wrappers/jni/androidmediarecorder.cpp | 346 + .../wrappers/jni/androidmediarecorder_p.h | 161 + .../wrappers/jni/androidmultimediautils.cpp | 43 + .../wrappers/jni/androidmultimediautils_p.h | 40 + .../wrappers/jni/androidsurfacetexture.cpp | 149 + .../wrappers/jni/androidsurfacetexture_p.h | 61 + .../wrappers/jni/androidsurfaceview.cpp | 152 + .../wrappers/jni/androidsurfaceview_p.h | 78 + src/plugins/multimedia/darwin/CMakeLists.txt | 68 + .../multimedia/darwin/avfaudiodecoder.mm | 589 + .../multimedia/darwin/avfaudiodecoder_p.h | 98 + .../multimedia/darwin/avfvideobuffer.mm | 196 + .../multimedia/darwin/avfvideobuffer_p.h | 66 + src/plugins/multimedia/darwin/avfvideosink.mm | 217 + .../multimedia/darwin/avfvideosink_p.h | 93 + .../darwin/camera/avfaudiopreviewdelegate.mm | 100 + .../darwin/camera/avfaudiopreviewdelegate_p.h | 40 + .../multimedia/darwin/camera/avfcamera.mm | 82 + .../multimedia/darwin/camera/avfcamera_p.h | 48 + .../darwin/camera/avfcamerarenderer.mm | 287 + .../darwin/camera/avfcamerarenderer_p.h | 91 + .../darwin/camera/avfcameraservice.mm | 169 + .../darwin/camera/avfcameraservice_p.h | 84 + .../darwin/camera/avfcamerasession.mm | 512 + .../darwin/camera/avfcamerasession_p.h | 132 + .../darwin/camera/avfimagecapture.mm | 385 + .../darwin/camera/avfimagecapture_p.h | 81 + .../darwin/camera/avfmediaassetwriter.mm | 628 + .../darwin/camera/avfmediaassetwriter_p.h | 54 + .../darwin/camera/avfmediaencoder.mm | 672 + .../darwin/camera/avfmediaencoder_p.h | 96 + .../multimedia/darwin/common/avfmetadata.mm | 505 + .../multimedia/darwin/common/avfmetadata_p.h | 37 + src/plugins/multimedia/darwin/darwin.json | 3 + src/plugins/multimedia/darwin/darwin_pch.h | 24 + .../darwin/mediaplayer/avfdisplaylink.mm | 198 + .../darwin/mediaplayer/avfdisplaylink_p.h | 72 + .../darwin/mediaplayer/avfmediaplayer.mm | 1407 +++ .../darwin/mediaplayer/avfmediaplayer_p.h | 145 + .../mediaplayer/avfvideorenderercontrol.mm | 252 + .../mediaplayer/avfvideorenderercontrol_p.h | 73 + .../multimedia/darwin/qdarwinformatsinfo.mm | 209 + .../multimedia/darwin/qdarwinformatsinfo_p.h | 38 + .../multimedia/darwin/qdarwinintegration.mm | 116 + .../multimedia/darwin/qdarwinintegration_p.h | 43 + src/plugins/multimedia/ffmpeg/CMakeLists.txt | 342 + .../ffmpeg/android/qandroidcamera.cpp | 911 ++ .../ffmpeg/android/qandroidcamera_p.h | 126 + .../ffmpeg/android/qandroidimagecapture.cpp | 70 + .../ffmpeg/android/qandroidimagecapture_p.h | 40 + .../ffmpeg/android/qandroidscreencapture.cpp | 175 + .../ffmpeg/android/qandroidscreencapture_p.h | 49 + .../ffmpeg/android/qandroidvideodevices.cpp | 187 + .../ffmpeg/android/qandroidvideodevices_p.h | 55 + .../android/qandroidvideoframebuffer.cpp | 260 + .../android/qandroidvideoframebuffer_p.h | 94 + .../android/qandroidvideoframefactory.cpp | 53 + .../android/qandroidvideoframefactory_p.h | 48 + .../ffmpeg/android/qandroidvideojnitypes_p.h | 28 + .../android/qffmpeghwaccel_mediacodec.cpp | 146 + .../android/qffmpeghwaccel_mediacodec_p.h | 48 + .../ffmpeg/cmake/QtAddFFmpegStubs.cmake | 206 + .../ffmpeg/cmake/QtDeployFFmpeg.cmake | 53 + .../multimedia/ffmpeg/darwin/qavfcamera.mm | 827 ++ .../multimedia/ffmpeg/darwin/qavfcamera_p.h | 132 + .../darwin/qavfcamerarotationtracker.mm | 87 + .../darwin/qavfcamerarotationtracker_p.h | 65 + .../darwin/qavfcapturephotooutputdelegate.mm | 145 + .../darwin/qavfcapturephotooutputdelegate_p.h | 47 + .../ffmpeg/darwin/qavfimagecapture.mm | 66 + .../ffmpeg/darwin/qavfimagecapture_p.h | 39 + .../ffmpeg/darwin/qavfsamplebufferdelegate.mm | 153 + .../darwin/qavfsamplebufferdelegate_p.h | 88 + .../ffmpeg/darwin/qavfscreencapture.mm | 223 + .../ffmpeg/darwin/qavfscreencapture_p.h | 65 + .../ffmpeg/darwin/qavfstillphotonotifier.cpp | 6 + .../ffmpeg/darwin/qavfstillphotonotifier_p.h | 43 + .../ffmpeg/darwin/qcgcapturablewindows.mm | 81 + .../ffmpeg/darwin/qcgcapturablewindows_p.h | 38 + .../ffmpeg/darwin/qcgwindowcapture.mm | 208 + .../ffmpeg/darwin/qcgwindowcapture_p.h | 47 + .../ffmpeg/darwin/qcvimagevideobuffer.cpp | 67 + .../ffmpeg/darwin/qcvimagevideobuffer_p.h | 51 + .../darwin/qffmpegdarwinhwframehelpers.mm | 87 + .../darwin/qffmpegdarwinhwframehelpers_p.h | 37 + .../qffmpegdarwinintegrationfactory_p.h | 39 + .../darwin/qffmpeghwaccel_videotoolbox.mm | 326 + .../darwin/qffmpeghwaccel_videotoolbox_p.h | 72 + src/plugins/multimedia/ffmpeg/ffmpeg.json | 3 + src/plugins/multimedia/ffmpeg/ffmpeg_pch.h | 41 + .../qffmpegaudioframeconverter.cpp | 175 + .../qffmpegaudioframeconverter_p.h | 53 + .../playbackengine/qffmpegaudiorenderer.cpp | 426 + .../playbackengine/qffmpegaudiorenderer_p.h | 149 + .../playbackengine/qffmpegcodeccontext.cpp | 140 + .../playbackengine/qffmpegcodeccontext_p.h | 81 + .../ffmpeg/playbackengine/qffmpegdemuxer.cpp | 324 + .../ffmpeg/playbackengine/qffmpegdemuxer_p.h | 107 + .../ffmpeg/playbackengine/qffmpegframe_p.h | 136 + .../playbackengine/qffmpegmediadataholder.cpp | 541 + .../playbackengine/qffmpegmediadataholder_p.h | 109 + .../ffmpeg/playbackengine/qffmpegpacket_p.h | 60 + .../qffmpegplaybackenginedefs_p.h | 46 + .../qffmpegplaybackengineobject.cpp | 160 + .../qffmpegplaybackengineobject_p.h | 160 + .../playbackengine/qffmpegplaybackutils_p.h | 54 + .../ffmpeg/playbackengine/qffmpegrenderer.cpp | 225 + .../ffmpeg/playbackengine/qffmpegrenderer_p.h | 131 + .../playbackengine/qffmpegstreamdecoder.cpp | 272 + .../playbackengine/qffmpegstreamdecoder_p.h | 95 + .../qffmpegsubtitlerenderer.cpp | 51 + .../qffmpegsubtitlerenderer_p.h | 48 + .../ffmpeg/playbackengine/qffmpegtime_p.h | 147 + .../playbackengine/qffmpegtimecontroller.cpp | 185 + .../playbackengine/qffmpegtimecontroller_p.h | 100 + .../playbackengine/qffmpegvideorenderer.cpp | 87 + .../playbackengine/qffmpegvideorenderer_p.h | 49 + .../multimedia/ffmpeg/qeglfsscreencapture.cpp | 188 + .../multimedia/ffmpeg/qeglfsscreencapture_p.h | 48 + src/plugins/multimedia/ffmpeg/qffmpeg.cpp | 442 + src/plugins/multimedia/ffmpeg/qffmpeg_p.h | 327 + .../multimedia/ffmpeg/qffmpegaudiodecoder.cpp | 255 + .../multimedia/ffmpeg/qffmpegaudiodecoder_p.h | 68 + .../multimedia/ffmpeg/qffmpegaudioinput.cpp | 249 + .../multimedia/ffmpeg/qffmpegaudioinput_p.h | 63 + .../ffmpeg/qffmpegavaudioformat.cpp | 96 + .../ffmpeg/qffmpegavaudioformat_p.h | 70 + .../multimedia/ffmpeg/qffmpegcodec.cpp | 318 + .../multimedia/ffmpeg/qffmpegcodec_p.h | 84 + .../multimedia/ffmpeg/qffmpegcodecstorage.cpp | 513 + .../multimedia/ffmpeg/qffmpegcodecstorage_p.h | 47 + .../multimedia/ffmpeg/qffmpegconverter.cpp | 267 + .../multimedia/ffmpeg/qffmpegconverter_p.h | 30 + src/plugins/multimedia/ffmpeg/qffmpegdefs_p.h | 88 + .../ffmpeg/qffmpegencodingformatcontext.cpp | 116 + .../ffmpeg/qffmpegencodingformatcontext_p.h | 60 + .../multimedia/ffmpeg/qffmpeghwaccel.cpp | 466 + .../ffmpeg/qffmpeghwaccel_d3d11.cpp | 392 + .../ffmpeg/qffmpeghwaccel_d3d11_p.h | 100 + .../multimedia/ffmpeg/qffmpeghwaccel_p.h | 109 + .../ffmpeg/qffmpeghwaccel_vaapi.cpp | 377 + .../ffmpeg/qffmpeghwaccel_vaapi_p.h | 49 + .../multimedia/ffmpeg/qffmpegimagecapture.cpp | 296 + .../multimedia/ffmpeg/qffmpegimagecapture_p.h | 73 + .../multimedia/ffmpeg/qffmpegioutils.cpp | 55 + .../multimedia/ffmpeg/qffmpegioutils_p.h | 40 + .../ffmpeg/qffmpegmediacapturesession.cpp | 320 + .../ffmpeg/qffmpegmediacapturesession_p.h | 112 + .../ffmpeg/qffmpegmediaformatinfo.cpp | 528 + .../ffmpeg/qffmpegmediaformatinfo_p.h | 52 + .../ffmpeg/qffmpegmediaintegration.cpp | 396 + .../ffmpeg/qffmpegmediaintegration_p.h | 72 + .../ffmpeg/qffmpegmediametadata.cpp | 200 + .../ffmpeg/qffmpegmediametadata_p.h | 35 + .../multimedia/ffmpeg/qffmpegmediaplayer.cpp | 443 + .../multimedia/ffmpeg/qffmpegmediaplayer_p.h | 129 + .../ffmpeg/qffmpegmediarecorder.cpp | 209 + .../ffmpeg/qffmpegmediarecorder_p.h | 70 + .../ffmpeg/qffmpegplaybackengine.cpp | 688 ++ .../ffmpeg/qffmpegplaybackengine_p.h | 257 + .../multimedia/ffmpeg/qffmpegplugin.cpp | 26 + .../multimedia/ffmpeg/qffmpegresampler.cpp | 156 + .../multimedia/ffmpeg/qffmpegresampler_p.h | 75 + .../ffmpeg/qffmpegscreencapture_dxgi.cpp | 480 + .../ffmpeg/qffmpegscreencapture_dxgi_p.h | 44 + .../ffmpeg/qffmpegsurfacecapturegrabber.cpp | 202 + .../ffmpeg/qffmpegsurfacecapturegrabber_p.h | 93 + .../ffmpeg/qffmpegtextureconverter.cpp | 159 + .../ffmpeg/qffmpegtextureconverter_p.h | 140 + .../multimedia/ffmpeg/qffmpegthread.cpp | 54 + .../multimedia/ffmpeg/qffmpegthread_p.h | 102 + .../multimedia/ffmpeg/qffmpegvideobuffer.cpp | 398 + .../multimedia/ffmpeg/qffmpegvideobuffer_p.h | 76 + .../multimedia/ffmpeg/qffmpegvideosink.cpp | 36 + .../multimedia/ffmpeg/qffmpegvideosink_p.h | 46 + .../ffmpeg/qffmpegwindowcapture_uwp.cpp | 512 + .../ffmpeg/qffmpegwindowcapture_uwp_p.h | 46 + .../multimedia/ffmpeg/qgdiwindowcapture.cpp | 197 + .../multimedia/ffmpeg/qgdiwindowcapture_p.h | 43 + .../ffmpeg/qgrabwindowsurfacecapture.cpp | 227 + .../ffmpeg/qgrabwindowsurfacecapture_p.h | 48 + .../multimedia/ffmpeg/qopenglvideobuffer.cpp | 95 + .../multimedia/ffmpeg/qopenglvideobuffer_p.h | 44 + src/plugins/multimedia/ffmpeg/qv4l2camera.cpp | 707 ++ src/plugins/multimedia/ffmpeg/qv4l2camera_p.h | 133 + .../multimedia/ffmpeg/qv4l2cameradevices.cpp | 182 + .../multimedia/ffmpeg/qv4l2cameradevices_p.h | 47 + .../multimedia/ffmpeg/qv4l2filedescriptor.cpp | 71 + .../multimedia/ffmpeg/qv4l2filedescriptor_p.h | 50 + .../multimedia/ffmpeg/qv4l2memorytransfer.cpp | 233 + .../multimedia/ffmpeg/qv4l2memorytransfer_p.h | 66 + .../ffmpeg/qwincapturablewindows.cpp | 82 + .../ffmpeg/qwincapturablewindows_p.h | 34 + .../multimedia/ffmpeg/qwindowscamera.cpp | 346 + .../multimedia/ffmpeg/qwindowscamera_p.h | 46 + .../ffmpeg/qx11capturablewindows.cpp | 105 + .../ffmpeg/qx11capturablewindows_p.h | 47 + .../multimedia/ffmpeg/qx11surfacecapture.cpp | 392 + .../multimedia/ffmpeg/qx11surfacecapture_p.h | 47 + .../recordingengine/qffmpegaudioencoder.cpp | 415 + .../recordingengine/qffmpegaudioencoder_p.h | 85 + .../qffmpegaudioencoderutils.cpp | 108 + .../qffmpegaudioencoderutils_p.h | 36 + .../recordingengine/qffmpegencoderoptions.cpp | 425 + .../recordingengine/qffmpegencoderoptions_p.h | 36 + .../recordingengine/qffmpegencoderthread.cpp | 56 + .../recordingengine/qffmpegencoderthread_p.h | 94 + .../qffmpegencodinginitializer.cpp | 169 + .../qffmpegencodinginitializer_p.h | 77 + .../ffmpeg/recordingengine/qffmpegmuxer.cpp | 81 + .../ffmpeg/recordingengine/qffmpegmuxer_p.h | 52 + .../qffmpegrecordingengine.cpp | 324 + .../qffmpegrecordingengine_p.h | 155 + .../qffmpegrecordingengineutils.cpp | 63 + .../qffmpegrecordingengineutils_p.h | 81 + .../recordingengine/qffmpegvideoencoder.cpp | 263 + .../recordingengine/qffmpegvideoencoder_p.h | 76 + .../qffmpegvideoencoderutils.cpp | 237 + .../qffmpegvideoencoderutils_p.h | 68 + .../qffmpegvideoframeencoder.cpp | 690 ++ .../qffmpegvideoframeencoder_p.h | 127 + .../ffmpeg/symbolstubs/openssl3.ver | 7 + .../symbolstubs/qffmpegsymbols-crypto.cpp | 7 + .../ffmpeg/symbolstubs/qffmpegsymbols-ssl.cpp | 301 + .../symbolstubs/qffmpegsymbols-va-drm.cpp | 15 + .../symbolstubs/qffmpegsymbols-va-x11.cpp | 15 + .../ffmpeg/symbolstubs/qffmpegsymbols-va.cpp | 166 + .../multimedia/ffmpeg/symbolstubs/va.ver | 7 + .../multimedia/gstreamer/CMakeLists.txt | 103 + .../audio/qgstreameraudiodecoder.cpp | 536 + .../audio/qgstreameraudiodecoder_p.h | 116 + .../gstreamer/audio/qgstreameraudiodevice.cpp | 50 + .../gstreamer/audio/qgstreameraudiodevice_p.h | 47 + .../gstreamer/common/qglist_helper_p.h | 91 + .../multimedia/gstreamer/common/qgst.cpp | 1728 +++ .../gstreamer/common/qgst_bus_observer.cpp | 109 + .../gstreamer/common/qgst_bus_observer_p.h | 72 + .../gstreamer/common/qgst_debug.cpp | 684 ++ .../gstreamer/common/qgst_debug_p.h | 87 + .../gstreamer/common/qgst_discoverer.cpp | 327 + .../gstreamer/common/qgst_discoverer_p.h | 127 + .../gstreamer/common/qgst_handle_types_p.h | 225 + .../multimedia/gstreamer/common/qgst_p.h | 1049 ++ .../multimedia/gstreamer/common/qgst_play.cpp | 77 + .../multimedia/gstreamer/common/qgst_play_p.h | 86 + .../gstreamer/common/qgstpipeline.cpp | 321 + .../gstreamer/common/qgstpipeline_p.h | 89 + .../gstreamer/common/qgstreameraudioinput.cpp | 146 + .../gstreamer/common/qgstreameraudioinput_p.h | 56 + .../common/qgstreameraudiooutput.cpp | 199 + .../common/qgstreameraudiooutput_p.h | 62 + .../common/qgstreamerbufferprobe.cpp | 88 + .../common/qgstreamerbufferprobe_p.h | 56 + .../gstreamer/common/qgstreameregldisplay.cpp | 66 + .../gstreamer/common/qgstreameregldisplay_p.h | 34 + .../common/qgstreamermediaplayer.cpp | 1194 ++ .../common/qgstreamermediaplayer_p.h | 187 + .../gstreamer/common/qgstreamermessage_p.h | 45 + .../gstreamer/common/qgstreamermetadata.cpp | 570 + .../gstreamer/common/qgstreamermetadata_p.h | 47 + .../common/qgstreamervideooutput.cpp | 196 + .../common/qgstreamervideooutput_p.h | 82 + .../gstreamer/common/qgstreamervideosink.cpp | 379 + .../gstreamer/common/qgstreamervideosink_p.h | 104 + .../gstreamer/common/qgstsubtitlesink.cpp | 160 + .../gstreamer/common/qgstsubtitlesink_p.h | 64 + .../multimedia/gstreamer/common/qgstutils.cpp | 164 + .../multimedia/gstreamer/common/qgstutils_p.h | 47 + .../gstreamer/common/qgstvideobuffer.cpp | 558 + .../gstreamer/common/qgstvideobuffer_p.h | 53 + .../common/qgstvideorenderersink.cpp | 614 + .../common/qgstvideorenderersink_p.h | 205 + .../multimedia/gstreamer/gstreamer.json | 3 + .../mediacapture/qgstreamercamera.cpp | 787 ++ .../mediacapture/qgstreamercamera_p.h | 171 + .../mediacapture/qgstreamerimagecapture.cpp | 476 + .../mediacapture/qgstreamerimagecapture_p.h | 108 + .../qgstreamermediacapturesession.cpp | 551 + .../qgstreamermediacapturesession_p.h | 121 + .../mediacapture/qgstreamermediarecorder.cpp | 400 + .../mediacapture/qgstreamermediarecorder_p.h | 82 + .../gstreamer/qgstreamerformatinfo.cpp | 471 + .../gstreamer/qgstreamerformatinfo_p.h | 47 + .../gstreamer/qgstreamerintegration.cpp | 292 + .../gstreamer/qgstreamerintegration_p.h | 86 + .../multimedia/gstreamer/qgstreamerplugin.cpp | 28 + .../gstreamer/qgstreamervideodevices.cpp | 281 + .../gstreamer/qgstreamervideodevices_p.h | 61 + .../qgstreamer_qiodevice_handler.cpp | 494 + .../qgstreamer_qiodevice_handler_p.h | 34 + .../uri_handler/qgstreamer_qrc_handler.cpp | 363 + .../uri_handler/qgstreamer_qrc_handler_p.h | 27 + src/plugins/multimedia/qnx/CMakeLists.txt | 43 + .../multimedia/qnx/camera/qqnxcamera.cpp | 820 ++ .../multimedia/qnx/camera/qqnxcamera_p.h | 201 + .../qnx/camera/qqnxcameraframebuffer.cpp | 298 + .../qnx/camera/qqnxcameraframebuffer_p.h | 58 + .../qnx/camera/qqnxcamerahandle_p.h | 102 + .../qnx/camera/qqnximagecapture.cpp | 257 + .../qnx/camera/qqnximagecapture_p.h | 63 + .../qnx/camera/qqnxplatformcamera.cpp | 426 + .../qnx/camera/qqnxplatformcamera_p.h | 113 + .../qnx/capture/qqnxaudiorecorder.cpp | 284 + .../qnx/capture/qqnxaudiorecorder_p.h | 103 + .../qnx/capture/qqnxmediacapturesession.cpp | 121 + .../qnx/capture/qqnxmediacapturesession_p.h | 67 + .../qnx/capture/qqnxmediarecorder.cpp | 115 + .../qnx/capture/qqnxmediarecorder_p.h | 51 + .../multimedia/qnx/common/mmrenderertypes.h | 95 + .../multimedia/qnx/common/qqnxaudioinput.cpp | 25 + .../multimedia/qnx/common/qqnxaudioinput_p.h | 33 + .../multimedia/qnx/common/qqnxaudiooutput.cpp | 52 + .../multimedia/qnx/common/qqnxaudiooutput_p.h | 39 + .../qnx/common/qqnxmediaeventthread.cpp | 98 + .../qnx/common/qqnxmediaeventthread_p.h | 55 + .../qnx/common/qqnxwindowgrabber.cpp | 435 + .../qnx/common/qqnxwindowgrabber_p.h | 114 + .../qnx/mediaplayer/qqnxmediametadata.cpp | 262 + .../qnx/mediaplayer/qqnxmediametadata_p.h | 74 + .../qnx/mediaplayer/qqnxmediaplayer.cpp | 887 ++ .../qnx/mediaplayer/qqnxmediaplayer_p.h | 167 + .../qnx/mediaplayer/qqnxmediautil.cpp | 126 + .../qnx/mediaplayer/qqnxmediautil_p.h | 32 + .../qnx/mediaplayer/qqnxvideosink.cpp | 26 + .../qnx/mediaplayer/qqnxvideosink_p.h | 41 + src/plugins/multimedia/qnx/qnx.json | 3 + src/plugins/multimedia/qnx/qqnxformatinfo.cpp | 36 + src/plugins/multimedia/qnx/qqnxformatinfo_p.h | 33 + .../multimedia/qnx/qqnxmediaintegration.cpp | 79 + .../multimedia/qnx/qqnxmediaintegration_p.h | 50 + .../multimedia/qnx/qqnxvideodevices.cpp | 111 + .../multimedia/qnx/qqnxvideodevices_p.h | 33 + src/plugins/multimedia/wasm/CMakeLists.txt | 34 + .../wasm/common/qwasmaudioinput.cpp | 68 + .../wasm/common/qwasmaudioinput_p.h | 58 + .../wasm/common/qwasmaudiooutput.cpp | 401 + .../wasm/common/qwasmaudiooutput_p.h | 98 + .../wasm/common/qwasmvideooutput.cpp | 1060 ++ .../wasm/common/qwasmvideooutput_p.h | 173 + .../wasm/mediacapture/qwasmcamera.cpp | 480 + .../wasm/mediacapture/qwasmcamera_p.h | 100 + .../mediacapture/qwasmcapturablewindows.cpp | 71 + .../mediacapture/qwasmcapturablewindows_p.h | 39 + .../wasm/mediacapture/qwasmimagecapture.cpp | 135 + .../wasm/mediacapture/qwasmimagecapture_p.h | 56 + .../mediacapture/qwasmmediacapturesession.cpp | 282 + .../mediacapture/qwasmmediacapturesession_p.h | 92 + .../wasm/mediacapture/qwasmmediarecorder.cpp | 354 + .../wasm/mediacapture/qwasmmediarecorder_p.h | 89 + .../wasm/mediacapture/qwasmscreencapture.cpp | 78 + .../wasm/mediacapture/qwasmscreencapture_p.h | 54 + .../wasm/mediacapture/qwasmwindowcapture.cpp | 76 + .../wasm/mediacapture/qwasmwindowcapture_p.h | 57 + .../wasm/mediaplayer/qwasmmediaplayer.cpp | 503 + .../wasm/mediaplayer/qwasmmediaplayer_p.h | 125 + .../wasm/mediaplayer/qwasmvideosink.cpp | 26 + .../wasm/mediaplayer/qwasmvideosink_p.h | 40 + .../multimedia/wasm/qwasmmediaintegration.cpp | 127 + .../multimedia/wasm/qwasmmediaintegration_p.h | 54 + src/plugins/multimedia/wasm/wasm.json | 5 + src/plugins/multimedia/windows/CMakeLists.txt | 72 + .../multimedia/windows/common/mfmetadata.cpp | 531 + .../multimedia/windows/common/mfmetadata_p.h | 33 + .../windows/decoder/mfaudiodecodercontrol.cpp | 226 + .../windows/decoder/mfaudiodecodercontrol_p.h | 74 + .../windows/decoder/mfdecodersourcereader.cpp | 72 + .../windows/decoder/mfdecodersourcereader_p.h | 48 + .../decoder/mfdecodersourcereadercallback.cpp | 25 + .../decoder/mfdecodersourcereadercallback_p.h | 43 + .../windows/evr/evrcustompresenter.cpp | 1855 +++ .../windows/evr/evrcustompresenter_p.h | 357 + .../windows/evr/evrd3dpresentengine.cpp | 784 ++ .../windows/evr/evrd3dpresentengine_p.h | 153 + .../multimedia/windows/evr/evrhelpers.cpp | 142 + .../multimedia/windows/evr/evrhelpers_p.h | 86 + .../windows/evr/evrvideowindowcontrol.cpp | 228 + .../windows/evr/evrvideowindowcontrol_p.h | 71 + .../windows/mediacapture/qwindowscamera.cpp | 101 + .../windows/mediacapture/qwindowscamera_p.h | 55 + .../mediacapture/qwindowsimagecapture.cpp | 207 + .../mediacapture/qwindowsimagecapture_p.h | 64 + .../mediacapture/qwindowsmediacapture.cpp | 109 + .../mediacapture/qwindowsmediacapture_p.h | 62 + .../qwindowsmediadevicereader.cpp | 1035 ++ .../qwindowsmediadevicereader_p.h | 156 + .../qwindowsmediadevicesession.cpp | 378 + .../qwindowsmediadevicesession_p.h | 100 + .../mediacapture/qwindowsmediaencoder.cpp | 224 + .../mediacapture/qwindowsmediaencoder_p.h | 71 + src/plugins/multimedia/windows/mfstream.cpp | 326 + src/plugins/multimedia/windows/mfstream_p.h | 124 + .../multimedia/windows/player/mfactivate.cpp | 17 + .../multimedia/windows/player/mfactivate_p.h | 202 + .../player/mfevrvideowindowcontrol.cpp | 59 + .../player/mfevrvideowindowcontrol_p.h | 40 + .../windows/player/mfplayercontrol.cpp | 261 + .../windows/player/mfplayercontrol_p.h | 95 + .../windows/player/mfplayersession.cpp | 1743 +++ .../windows/player/mfplayersession_p.h | 241 + .../windows/player/mfvideorenderercontrol.cpp | 148 + .../windows/player/mfvideorenderercontrol_p.h | 48 + .../multimedia/windows/qwindowsformatinfo.cpp | 190 + .../multimedia/windows/qwindowsformatinfo_p.h | 31 + .../windows/qwindowsintegration.cpp | 97 + .../windows/qwindowsintegration_p.h | 51 + .../multimedia/windows/sourceresolver.cpp | 294 + .../multimedia/windows/sourceresolver_p.h | 83 + src/plugins/multimedia/windows/windows.json | 3 + src/resonance-audio/CMakeLists.txt | 248 + src/resonance-audio/resonance_audio.cpp | 38 + src/resonance-audio/resonance_audio.h | 30 + src/spatialaudio/CMakeLists.txt | 26 + src/spatialaudio/doc/qtspatialaudio.qdocconf | 70 + .../doc/src/qtspatialaudio-cpp.qdoc | 33 + .../doc/src/qtspatialaudio-examples.qdoc | 15 + .../doc/src/qtspatialaudio-index.qdoc | 104 + .../doc/src/qtspatialaudio-qml-types.qdoc | 26 + .../doc/src/spatialaudiooverview.qdoc | 64 + src/spatialaudio/qambientsound.cpp | 322 + src/spatialaudio/qambientsound.h | 69 + src/spatialaudio/qambientsound_p.h | 96 + src/spatialaudio/qambisonicdecoder.cpp | 317 + src/spatialaudio/qambisonicdecoder_p.h | 75 + src/spatialaudio/qambisonicdecoderdata_p.h | 279 + src/spatialaudio/qaudioengine.cpp | 355 + src/spatialaudio/qaudioengine.h | 83 + src/spatialaudio/qaudioengine_p.h | 111 + src/spatialaudio/qaudioengine_threaded.cpp | 430 + src/spatialaudio/qaudioengine_threaded_p.h | 87 + src/spatialaudio/qaudiolistener.cpp | 126 + src/spatialaudio/qaudiolistener.h | 39 + src/spatialaudio/qaudioroom.cpp | 434 + src/spatialaudio/qaudioroom.h | 111 + src/spatialaudio/qaudioroom_p.h | 51 + src/spatialaudio/qspatialsound.cpp | 655 + src/spatialaudio/qspatialsound.h | 128 + src/spatialaudio/qspatialsound_p.h | 61 + src/spatialaudio/qtspatialaudioglobal.h | 10 + src/spatialaudio/qtspatialaudioglobal_p.h | 21 + src/spatialaudioquick3d/CMakeLists.txt | 35 + .../qquick3dambientsound.cpp | 148 + .../qquick3dambientsound_p.h | 74 + .../qquick3daudio-qml-types.qdoc | 32 + .../qquick3daudioengine.cpp | 155 + .../qquick3daudioengine_p.h | 69 + .../qquick3daudiolistener.cpp | 50 + .../qquick3daudiolistener_p.h | 47 + src/spatialaudioquick3d/qquick3daudioroom.cpp | 271 + src/spatialaudioquick3d/qquick3daudioroom_p.h | 127 + .../qquick3dspatialaudio_plugin.cpp | 35 + .../qquick3dspatialsound.cpp | 324 + .../qquick3dspatialsound_p.h | 127 + .../qtquick3daudioglobal_p.h | 28 + .../qtquick3daudiotypes_p.h | 27 + tests/CMakeLists.txt | 16 + tests/auto/CMakeLists.txt | 6 + tests/auto/cmake/CMakeLists.txt | 26 + tests/auto/integration/CMakeLists.txt | 56 + .../auto/integration/backends/CMakeLists.txt | 9 + .../integration/backends/tst_backends.cpp | 61 + .../auto/integration/multiapp/CMakeLists.txt | 21 + .../auto/integration/multiapp/double-drop.wav | Bin 0 -> 20626 bytes .../integration/multiapp/tst_multiapp.cpp | 90 + .../qaudiodecoderbackend/CMakeLists.txt | 23 + .../testdata/test-corrupted.wav | Bin 0 -> 1952 bytes .../testdata/test-no-audio-track.mp4 | Bin 0 -> 1589 bytes .../testdata/test-unsupported.avi | Bin 0 -> 17934 bytes .../qaudiodecoderbackend/testdata/test.wav | Bin 0 -> 88232 bytes .../tst_qaudiodecoderbackend.cpp | 966 ++ .../qaudiodevicebackend/CMakeLists.txt | 15 + .../tst_qaudiodevicebackend.cpp | 227 + .../integration/qaudiosink/CMakeLists.txt | 15 + .../integration/qaudiosink/tst_qaudiosink.cpp | 1495 +++ .../integration/qaudiosource/CMakeLists.txt | 22 + .../auto/integration/qaudiosource/Info.plist | 44 + .../qaudiosource/tst_qaudiosource.cpp | 1142 ++ .../auto/integration/qcamerabackend/BLACKLIST | 12 + .../integration/qcamerabackend/CMakeLists.txt | 23 + .../integration/qcamerabackend/Info.plist | 46 + .../qcamerabackend/tst_qcamerabackend.cpp | 852 ++ .../qmediacapturesession/BLACKLIST | 2 + .../qmediacapturesession/CMakeLists.txt | 23 + .../qmediacapturesession/Info.plist | 46 + .../tst_qmediacapturesession.cpp | 1372 +++ .../integration/qmediaformatbackend/BLACKLIST | 11 + .../qmediaformatbackend/CMakeLists.txt | 10 + .../tst_qmediaformatbackend.cpp | 1053 ++ .../qmediaframeinputsbackend/CMakeLists.txt | 18 + .../tst_qmediaframeinputsbackend.cpp | 464 + .../tst_qmediaframeinputsbackend.h | 43 + .../3colors_with_sound_1s.mp4 | Bin 0 -> 37261 bytes .../qmediaplayer_concurrent/CMakeLists.txt | 13 + .../tst_qmediaplayer_concurrent.cpp | 82 + .../integration/qmediaplayerbackend/BLACKLIST | 23 + .../qmediaplayerbackend/CMakeLists.txt | 67 + .../qmediaplayerbackend/LazyLoad.qml | 52 + .../integration/qmediaplayerbackend/fake.h | 28 + .../integration/qmediaplayerbackend/fixture.h | 97 + .../qmediaplayerbackend/mediaplayerstate.h | 172 + .../integration/qmediaplayerbackend/server.h | 47 + .../qmediaplayerbackend/testdata/15s.mkv | Bin 0 -> 63705 bytes .../testdata/3colors_with_sound_1s.mp4 | Bin 0 -> 37261 bytes .../testdata/BigBuckBunny.mp4 | Bin 0 -> 36724 bytes .../qmediaplayerbackend/testdata/_test.wav | Bin 0 -> 88232 bytes .../audio_video_with_jpg_thumbnail.mp4 | Bin 0 -> 37930 bytes .../audio_video_with_png_thumbnail.mp4 | Bin 0 -> 37436 bytes .../qmediaplayerbackend/testdata/busAv1.webm | Bin 0 -> 16108 bytes .../qmediaplayerbackend/testdata/busMpeg4.mp4 | Bin 0 -> 25954 bytes .../testdata/color_matrix.mp4 | Bin 0 -> 21412 bytes .../color_matrix_180_deg_clockwise.mp4 | Bin 0 -> 21412 bytes ...olor_matrix_180_deg_clockwise_mirrored.mp4 | Bin 0 -> 21412 bytes .../color_matrix_270_deg_clockwise.mp4 | Bin 0 -> 21412 bytes ...olor_matrix_270_deg_clockwise_mirrored.mp4 | Bin 0 -> 21412 bytes .../color_matrix_90_deg_clockwise.mp4 | Bin 0 -> 21412 bytes ...color_matrix_90_deg_clockwise_mirrored.mp4 | Bin 0 -> 21412 bytes .../testdata/color_matrix_mirrored.mp4 | Bin 0 -> 21412 bytes .../qmediaplayerbackend/testdata/colors.mp4 | Bin 0 -> 26042 bytes .../qmediaplayerbackend/testdata/colors.ogv | Bin 0 -> 12090 bytes .../testdata/corrupt_end.ogg | Bin 0 -> 5946 bytes .../testdata/duration_issues.webm | Bin 0 -> 34940 bytes .../h264_avc1_yuv420p10le_tv_bt2020.mov | Bin 0 -> 20164 bytes .../testdata/invalid_media.m3u | 1 + .../testdata/invalid_media2.m3u | 3 + .../multitrack-subtitle-start-at-zero.mkv | Bin 0 -> 153449 bytes .../testdata/multitrack.mkv | Bin 0 -> 153452 bytes .../qmediaplayerbackend/testdata/nested1.m3u | 4 + .../qmediaplayerbackend/testdata/nested2.m3u | 3 + .../testdata/nokia-tune.mkv | Bin 0 -> 50694 bytes .../testdata/nokia-tune.mp3 | Bin 0 -> 33988 bytes .../testdata/one_red_frame.mp4 | Bin 0 -> 1589 bytes .../qmediaplayerbackend/testdata/par_2_3.mp4 | Bin 0 -> 1656 bytes .../qmediaplayerbackend/testdata/par_3_2.mp4 | Bin 0 -> 1652 bytes .../testdata/recursive.m3u | 2 + .../testdata/recursive_master.m3u | 3 + .../qmediaplayerbackend/testdata/sample.m3u | 4 + .../testdata/subtitletest.mkv | Bin 0 -> 17398 bytes .../qmediaplayerbackend/testdata/test.wav | Bin 0 -> 88232 bytes .../testdata/with_creation_time.mp4 | Bin 0 -> 1588 bytes .../testdata/with_date.mp4 | Bin 0 -> 1632 bytes .../testdata/with_date_and_creation_time.mp4 | Bin 0 -> 1632 bytes .../with_qtdate_and_creation_time.mov | Bin 0 -> 9458 bytes .../tst_qmediaplayerbackend.cpp | 5079 ++++++++ .../qmediaplayerformatsupport/CMakeLists.txt | 40 + .../testdata/README.md | 35 + .../containers/supported/container.avi | Bin 0 -> 11284 bytes .../containers/supported/container.mkv | Bin 0 -> 3019 bytes .../containers/supported/container.mp4 | Bin 0 -> 3280 bytes .../containers/supported/container.mpeg | Bin 0 -> 34816 bytes .../containers/supported/container.wmv | Bin 0 -> 29587 bytes .../containers/unsupported/container.webp | Bin 0 -> 2676 bytes .../testdata/flipable.gif | Bin 0 -> 131710 bytes .../pixel_formats/supported/h264_bgr0.mp4 | Bin 0 -> 12335 bytes .../pixel_formats/supported/h264_bgr24.mp4 | Bin 0 -> 12335 bytes .../pixel_formats/supported/h264_gray.mp4 | Bin 0 -> 6289 bytes .../pixel_formats/supported/h264_gray10le.mp4 | Bin 0 -> 6326 bytes .../pixel_formats/supported/h264_nv12.mp4 | Bin 0 -> 7734 bytes .../pixel_formats/supported/h264_nv16.mp4 | Bin 0 -> 8646 bytes .../pixel_formats/supported/h264_nv21.mp4 | Bin 0 -> 7734 bytes .../pixel_formats/supported/h264_rgb24.mp4 | Bin 0 -> 12335 bytes .../pixel_formats/supported/h264_yuv420p.mp4 | Bin 0 -> 7747 bytes .../supported/h264_yuv420p10.mp4 | Bin 0 -> 7699 bytes .../supported/h264_yuv420p10le.mp4 | Bin 0 -> 7699 bytes .../pixel_formats/supported/h264_yuv422p.mp4 | Bin 0 -> 8646 bytes .../supported/h264_yuv422p10.mp4 | Bin 0 -> 8675 bytes .../supported/h264_yuv422p10le.mp4 | Bin 0 -> 8675 bytes .../pixel_formats/supported/h264_yuv444p.mp4 | Bin 0 -> 7575 bytes .../supported/h264_yuv444p10.mp4 | Bin 0 -> 7549 bytes .../pixel_formats/supported/h264_yuvj420p.mp4 | Bin 0 -> 8081 bytes .../pixel_formats/supported/h264_yuvj422p.mp4 | Bin 0 -> 9059 bytes .../pixel_formats/supported/h264_yuvj444p.mp4 | Bin 0 -> 7939 bytes .../tst_qmediaplayerformatsupport.cpp | 124 + .../qmediarecorderbackend/CMakeLists.txt | 10 + .../tst_qmediarecorderbackend.cpp | 790 ++ tests/auto/integration/qml/CMakeLists.txt | 18 + .../qml/mediaplayer/tst_mediaplayer.qml | 32 + .../playbackoptions/tst_playbackoptions.qml | 65 + .../qml/soundeffect/tst_soundeffect.qml | 19 + tests/auto/integration/qml/tst_qml.cpp | 5 + .../qquickscreencapturebackend/CMakeLists.txt | 16 + .../tst_qquickscreencapturebackend.cpp | 141 + .../qquickvideooutput/CMakeLists.txt | 32 + .../integration/qquickvideooutput/main.qml | 7 + .../tst_qquickvideooutput.cpp | 439 + .../qquickvideooutput_window/CMakeLists.txt | 32 + .../qquickvideooutput_window/main.qml | 13 + .../tst_qquickvideooutput_window.cpp | 98 + .../integration/qrtaudioengine/CMakeLists.txt | 10 + .../qrtaudioengine/tst_qrtaudioengine.cpp | 236 + .../qscreencapturebackend/BLACKLIST | 11 + .../qscreencapturebackend/CMakeLists.txt | 22 + .../android/AndroidManifest.xml | 57 + .../tst_qscreencapturebackend.cpp | 588 + .../integration/qsoundeffect/CMakeLists.txt | 18 + tests/auto/integration/qsoundeffect/test.wav | Bin 0 -> 38316 bytes .../qsoundeffect/test_corrupted.wav | Bin 0 -> 38316 bytes .../integration/qsoundeffect/test_tone.wav | Bin 0 -> 265388 bytes .../qsoundeffect/tst_qsoundeffect.cpp | 743 ++ .../qsoundeffect_concurrent/CMakeLists.txt | 12 + .../qsoundeffect_concurrent/double-drop.wav | Bin 0 -> 20626 bytes .../tst_qsoundeffect_concurrent.cpp | 93 + .../integration/qspatialaudio/CMakeLists.txt | 13 + tests/auto/integration/qspatialaudio/test.wav | Bin 0 -> 38316 bytes .../qspatialaudio/tst_qspatialaudio.cpp | 415 + .../qvideoframebackend/CMakeLists.txt | 19 + .../qvideoframebackend/testdata/colors.mp4 | Bin 0 -> 26042 bytes .../testdata/one_red_frame.mp4 | Bin 0 -> 1589 bytes .../tst_qvideoframebackend.cpp | 297 + .../qwindowcapturebackend/BLACKLIST | 19 + .../qwindowcapturebackend/CMakeLists.txt | 23 + .../qwindowcapturebackend/fixture.cpp | 234 + .../qwindowcapturebackend/fixture.h | 146 + .../qwindowcapturebackend/grabber.cpp | 64 + .../qwindowcapturebackend/grabber.h | 42 + .../tst_qwindowcapturebackend.cpp | 274 + .../qwindowcapturebackend/widget.cpp | 125 + .../qwindowcapturebackend/widget.h | 43 + .../spatialaudio_qml/CMakeLists.txt | 18 + .../integration/spatialaudio_qml/qml/test.wav | Bin 0 -> 38316 bytes .../spatialaudio_qml/qml/tst_ambientsound.qml | 40 + .../spatialaudio_qml/qml/tst_audioengine.qml | 31 + .../qml/tst_audiolistener.qml | 26 + .../spatialaudio_qml/qml/tst_audioroom.qml | 27 + .../spatialaudio_qml/qml/tst_spatialsound.qml | 60 + .../integration/spatialaudio_qml/tst_qml.cpp | 5 + .../integration/static_linking/CMakeLists.txt | 15 + .../tst_multimedia_static_linking.cpp | 16 + tests/auto/runautotests.py | 173 + tests/auto/unit/CMakeLists.txt | 11 + tests/auto/unit/mockbackend/CMakeLists.txt | 30 + tests/auto/unit/mockbackend/mock.json | 3 + .../unit/mockbackend/qmockaudiodecoder.cpp | 139 + .../auto/unit/mockbackend/qmockaudiodecoder.h | 68 + .../unit/mockbackend/qmockaudiodevices.cpp | 77 + .../auto/unit/mockbackend/qmockaudiodevices.h | 59 + .../auto/unit/mockbackend/qmockaudiooutput.h | 30 + tests/auto/unit/mockbackend/qmockcamera.cpp | 158 + tests/auto/unit/mockbackend/qmockcamera.h | 81 + .../unit/mockbackend/qmockimagecapture.cpp | 59 + .../auto/unit/mockbackend/qmockimagecapture.h | 48 + .../unit/mockbackend/qmockintegration.cpp | 164 + .../auto/unit/mockbackend/qmockintegration.h | 117 + .../mockbackend/qmockmediacapturesession.h | 86 + .../auto/unit/mockbackend/qmockmediaencoder.h | 90 + .../auto/unit/mockbackend/qmockmediaplayer.h | 166 + .../unit/mockbackend/qmocksurfacecapture.h | 88 + .../auto/unit/mockbackend/qmockvideobuffer.h | 38 + .../unit/mockbackend/qmockvideodevices.cpp | 65 + .../auto/unit/mockbackend/qmockvideodevices.h | 42 + tests/auto/unit/mockbackend/qmockvideosink.h | 33 + tests/auto/unit/multimedia/CMakeLists.txt | 49 + .../qabstractvideobuffer/CMakeLists.txt | 14 + .../tst_qabstractvideobuffer.cpp | 101 + .../multimedia/qaudiobuffer/CMakeLists.txt | 13 + .../qaudiobuffer/tst_qaudiobuffer.cpp | 387 + .../multimedia/qaudiodecoder/CMakeLists.txt | 17 + .../qaudiodecoder/tst_qaudiodecoder.cpp | 339 + .../multimedia/qaudiodevice/CMakeLists.txt | 13 + .../qaudiodevice/tst_qaudiodevice.cpp | 138 + .../multimedia/qaudioformat/CMakeLists.txt | 13 + .../qaudioformat/tst_qaudioformat.cpp | 278 + .../multimedia/qaudiohelpers/CMakeLists.txt | 9 + .../qaudiohelpers/tst_qaudiohelpers.cpp | 430 + .../multimedia/qaudionamespace/CMakeLists.txt | 13 + .../qaudionamespace/tst_qaudionamespace.cpp | 219 + .../multimedia/qaudiorecorder/CMakeLists.txt | 17 + .../qaudiorecorder/tst_qaudiorecorder.cpp | 84 + .../qaudioringbuffer/CMakeLists.txt | 13 + .../qaudioringbuffer/tst_qaudioringbuffer.cpp | 318 + .../multimedia/qautoresetevent/CMakeLists.txt | 9 + .../qautoresetevent/tst_qautoresetevent.cpp | 120 + .../unit/multimedia/qcamera/CMakeLists.txt | 18 + .../unit/multimedia/qcamera/tst_qcamera.cpp | 847 ++ .../multimedia/qcameradevice/CMakeLists.txt | 17 + .../qcameradevice/tst_qcameradevice.cpp | 202 + .../unit/multimedia/qerrorinfo/CMakeLists.txt | 9 + .../multimedia/qerrorinfo/tst_qerrorinfo.cpp | 116 + .../multimedia/qimagecapture/CMakeLists.txt | 17 + .../qimagecapture/tst_qimagecapture.cpp | 284 + .../multimedia/qmediadevices/CMakeLists.txt | 12 + .../qmediadevices/tst_qmediadevices.cpp | 188 + .../multimedia/qmediaformat/CMakeLists.txt | 13 + .../qmediaformat/tst_qmediaformat.cpp | 196 + .../multimedia/qmediametadata/CMakeLists.txt | 13 + .../qmediametadata/tst_qmediametadata.cpp | 96 + .../multimedia/qmediaplayer/CMakeLists.txt | 30 + .../qmediaplayer/testdata/nokia-tune.mp3 | Bin 0 -> 62715 bytes .../qmediaplayer/tst_qmediaplayer.cpp | 927 ++ .../multimedia/qmediaplaylist/CMakeLists.txt | 23 + .../qmediaplaylist/testdata/empty.pls | 2 + .../qmediaplaylist/testdata/test.m3u | 11 + .../qmediaplaylist/testdata/test.pls | 27 + .../qmediaplaylist/testdata/testfile | 0 .../qmediaplaylist/testdata/testfile2#suffix | 0 .../testdata/totem-pl-example.pls | 5 + .../qmediaplaylist/tst_qmediaplaylist.cpp | 902 ++ .../multimedia/qmediarecorder/CMakeLists.txt | 17 + .../qmediarecorder/tst_qmediarecorder.cpp | 715 ++ .../qmediastoragelocation/CMakeLists.txt | 9 + .../tst_qmediastoragelocation.cpp | 119 + .../multimedia/qmediatimerange/CMakeLists.txt | 14 + .../qmediatimerange/tst_qmediatimerange.cpp | 765 ++ .../qmultimediautils/CMakeLists.txt | 9 + .../qmultimediautils/tst_qmultimediautils.cpp | 424 + .../qplaybackoptions/CMakeLists.txt | 9 + .../qplaybackoptions/tst_qplaybackoptions.cpp | 161 + .../multimedia/qrhivaluemapper/CMakeLists.txt | 10 + .../qrhivaluemapper/tst_qrhivaluemapper.cpp | 241 + .../multimedia/qsamplecache/CMakeLists.txt | 19 + .../qsamplecache/testdata/corrupted.wav | Bin 0 -> 864 bytes .../testdata/drwav_heap-buffer-overflow.wav | Bin 0 -> 96 bytes .../testdata/drwav_integer-underflow.wav | Bin 0 -> 74 bytes .../multimedia/qsamplecache/testdata/test.wav | Bin 0 -> 88232 bytes .../qsamplecache/testdata/test2.wav | Bin 0 -> 88232 bytes .../qsamplecache/tst_qsamplecache.cpp | 146 + .../multimedia/qscreencapture/CMakeLists.txt | 17 + .../qscreencapture/tst_qscreencapture.cpp | 64 + .../multimedia/qsharedhandle/CMakeLists.txt | 15 + .../qsharedhandle/tst_qsharedhandle.cpp | 342 + .../multimedia/qvideobuffers/CMakeLists.txt | 10 + .../qvideobuffers/tst_qvideobuffers.cpp | 234 + .../multimedia/qvideoframe/CMakeLists.txt | 17 + .../qvideoframe/tst_qvideoframe.cpp | 1536 +++ .../unit/multimedia/qvideoframe/umbrellas.jpg | Bin 0 -> 12786 bytes .../qvideoframe_nogui/CMakeLists.txt | 10 + .../tst_qvideoframe_nogui.cpp | 33 + .../qvideoframecolormanagement/BLACKLIST | 3 + .../qvideoframecolormanagement/CMakeLists.txt | 20 + .../testdata/umbrellas.jpg | Bin 0 -> 12786 bytes .../umbrellas.jpg_abgr8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_abgr8888_adobergb_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_adobergb_video.png | Bin 0 -> 35949 bytes ...rellas.jpg_abgr8888_adobergb_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_abgr8888_bt2020_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt2020_video.png | Bin 0 -> 35949 bytes ...mbrellas.jpg_abgr8888_bt2020_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt601_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt601_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_abgr8888_bt601_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt709_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt709_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_abgr8888_bt709_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_argb8888_adobergb_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_adobergb_video.png | Bin 0 -> 35949 bytes ...rellas.jpg_argb8888_adobergb_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_argb8888_bt2020_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt2020_video.png | Bin 0 -> 35949 bytes ...mbrellas.jpg_argb8888_bt2020_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt601_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt601_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_argb8888_bt601_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt709_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt709_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_argb8888_bt709_video_cpu.png | Bin 0 -> 41243 bytes ...g_argb8888_premultiplied_adobergb_full.png | Bin 0 -> 41243 bytes ...gb8888_premultiplied_adobergb_full_cpu.png | Bin 0 -> 41243 bytes ..._argb8888_premultiplied_adobergb_video.png | Bin 0 -> 35949 bytes ...b8888_premultiplied_adobergb_video_cpu.png | Bin 0 -> 41243 bytes ...jpg_argb8888_premultiplied_bt2020_full.png | Bin 0 -> 41243 bytes ...argb8888_premultiplied_bt2020_full_cpu.png | Bin 0 -> 41243 bytes ...pg_argb8888_premultiplied_bt2020_video.png | Bin 0 -> 35949 bytes ...rgb8888_premultiplied_bt2020_video_cpu.png | Bin 0 -> 41243 bytes ....jpg_argb8888_premultiplied_bt601_full.png | Bin 0 -> 41243 bytes ..._argb8888_premultiplied_bt601_full_cpu.png | Bin 0 -> 41243 bytes ...jpg_argb8888_premultiplied_bt601_video.png | Bin 0 -> 35949 bytes ...argb8888_premultiplied_bt601_video_cpu.png | Bin 0 -> 41243 bytes ....jpg_argb8888_premultiplied_bt709_full.png | Bin 0 -> 41243 bytes ..._argb8888_premultiplied_bt709_full_cpu.png | Bin 0 -> 41243 bytes ...jpg_argb8888_premultiplied_bt709_video.png | Bin 0 -> 35949 bytes ...argb8888_premultiplied_bt709_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_bgra8888_adobergb_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_adobergb_video.png | Bin 0 -> 35949 bytes ...rellas.jpg_bgra8888_adobergb_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_bgra8888_bt2020_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt2020_video.png | Bin 0 -> 35949 bytes ...mbrellas.jpg_bgra8888_bt2020_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt601_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt601_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_bgra8888_bt601_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt709_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt709_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_bgra8888_bt709_video_cpu.png | Bin 0 -> 41243 bytes ...g_bgra8888_premultiplied_adobergb_full.png | Bin 0 -> 41243 bytes ...ra8888_premultiplied_adobergb_full_cpu.png | Bin 0 -> 41243 bytes ..._bgra8888_premultiplied_adobergb_video.png | Bin 0 -> 35949 bytes ...a8888_premultiplied_adobergb_video_cpu.png | Bin 0 -> 41243 bytes ...jpg_bgra8888_premultiplied_bt2020_full.png | Bin 0 -> 41243 bytes ...bgra8888_premultiplied_bt2020_full_cpu.png | Bin 0 -> 41243 bytes ...pg_bgra8888_premultiplied_bt2020_video.png | Bin 0 -> 35949 bytes ...gra8888_premultiplied_bt2020_video_cpu.png | Bin 0 -> 41243 bytes ....jpg_bgra8888_premultiplied_bt601_full.png | Bin 0 -> 41243 bytes ..._bgra8888_premultiplied_bt601_full_cpu.png | Bin 0 -> 41243 bytes ...jpg_bgra8888_premultiplied_bt601_video.png | Bin 0 -> 35949 bytes ...bgra8888_premultiplied_bt601_video_cpu.png | Bin 0 -> 41243 bytes ....jpg_bgra8888_premultiplied_bt709_full.png | Bin 0 -> 41243 bytes ..._bgra8888_premultiplied_bt709_full_cpu.png | Bin 0 -> 41243 bytes ...jpg_bgra8888_premultiplied_bt709_video.png | Bin 0 -> 35949 bytes ...bgra8888_premultiplied_bt709_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgrx8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_bgrx8888_adobergb_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_adobergb_video.png | Bin 0 -> 35949 bytes ...rellas.jpg_bgrx8888_adobergb_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_bgrx8888_bt2020_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt2020_video.png | Bin 0 -> 35949 bytes ...mbrellas.jpg_bgrx8888_bt2020_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgrx8888_bt601_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt601_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_bgrx8888_bt601_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgrx8888_bt709_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt709_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_bgrx8888_bt709_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_imc1_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_imc1_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc1_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_imc1_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc1_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_imc1_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_imc1_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_imc1_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_imc1_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_imc1_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc1_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_imc1_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_imc1_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_imc1_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc1_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_imc1_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_imc2_adobergb_full.png | Bin 0 -> 40934 bytes .../umbrellas.jpg_imc2_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc2_adobergb_video.png | Bin 0 -> 40934 bytes .../umbrellas.jpg_imc2_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc2_bt2020_full.png | Bin 0 -> 40912 bytes .../umbrellas.jpg_imc2_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_imc2_bt2020_video.png | Bin 0 -> 41004 bytes .../umbrellas.jpg_imc2_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_imc2_bt601_full.png | Bin 0 -> 40870 bytes .../umbrellas.jpg_imc2_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc2_bt601_video.png | Bin 0 -> 40924 bytes .../umbrellas.jpg_imc2_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_imc2_bt709_full.png | Bin 0 -> 40966 bytes .../umbrellas.jpg_imc2_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc2_bt709_video.png | Bin 0 -> 40975 bytes .../umbrellas.jpg_imc2_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_imc3_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_imc3_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc3_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_imc3_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc3_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_imc3_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_imc3_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_imc3_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_imc3_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_imc3_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc3_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_imc3_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_imc3_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_imc3_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc3_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_imc3_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_imc4_adobergb_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_imc4_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc4_adobergb_video.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_imc4_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc4_bt2020_full.png | Bin 0 -> 40912 bytes .../umbrellas.jpg_imc4_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_imc4_bt2020_video.png | Bin 0 -> 40987 bytes .../umbrellas.jpg_imc4_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_imc4_bt601_full.png | Bin 0 -> 40877 bytes .../umbrellas.jpg_imc4_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc4_bt601_video.png | Bin 0 -> 40918 bytes .../umbrellas.jpg_imc4_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_imc4_bt709_full.png | Bin 0 -> 40967 bytes .../umbrellas.jpg_imc4_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc4_bt709_video.png | Bin 0 -> 40961 bytes .../umbrellas.jpg_imc4_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_nv12_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_nv12_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_nv12_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_nv12_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_nv12_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_nv12_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_nv12_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_nv12_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_nv12_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_nv12_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_nv12_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_nv12_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_nv12_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_nv12_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_nv12_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_nv12_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_nv21_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_nv21_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_nv21_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_nv21_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_nv21_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_nv21_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_nv21_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_nv21_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_nv21_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_nv21_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_nv21_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_nv21_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_nv21_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_nv21_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_nv21_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_nv21_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_p010_adobergb_full.png | Bin 0 -> 40927 bytes .../umbrellas.jpg_p010_adobergb_full_cpu.png | Bin 0 -> 35927 bytes .../umbrellas.jpg_p010_adobergb_video.png | Bin 0 -> 40927 bytes .../umbrellas.jpg_p010_adobergb_video_cpu.png | Bin 0 -> 35927 bytes .../umbrellas.jpg_p010_bt2020_full.png | Bin 0 -> 40923 bytes .../umbrellas.jpg_p010_bt2020_full_cpu.png | Bin 0 -> 35936 bytes .../umbrellas.jpg_p010_bt2020_video.png | Bin 0 -> 40964 bytes .../umbrellas.jpg_p010_bt2020_video_cpu.png | Bin 0 -> 35927 bytes .../umbrellas.jpg_p010_bt601_full.png | Bin 0 -> 40897 bytes .../umbrellas.jpg_p010_bt601_full_cpu.png | Bin 0 -> 35887 bytes .../umbrellas.jpg_p010_bt601_video.png | Bin 0 -> 40914 bytes .../umbrellas.jpg_p010_bt601_video_cpu.png | Bin 0 -> 35881 bytes .../umbrellas.jpg_p010_bt709_full.png | Bin 0 -> 40936 bytes .../umbrellas.jpg_p010_bt709_full_cpu.png | Bin 0 -> 35887 bytes .../umbrellas.jpg_p010_bt709_video.png | Bin 0 -> 40991 bytes .../umbrellas.jpg_p010_bt709_video_cpu.png | Bin 0 -> 35933 bytes .../umbrellas.jpg_p016_adobergb_full.png | Bin 0 -> 40913 bytes .../umbrellas.jpg_p016_adobergb_full_cpu.png | Bin 0 -> 35941 bytes .../umbrellas.jpg_p016_adobergb_video.png | Bin 0 -> 40913 bytes .../umbrellas.jpg_p016_adobergb_video_cpu.png | Bin 0 -> 35941 bytes .../umbrellas.jpg_p016_bt2020_full.png | Bin 0 -> 40969 bytes .../umbrellas.jpg_p016_bt2020_full_cpu.png | Bin 0 -> 35925 bytes .../umbrellas.jpg_p016_bt2020_video.png | Bin 0 -> 40951 bytes .../umbrellas.jpg_p016_bt2020_video_cpu.png | Bin 0 -> 35968 bytes .../umbrellas.jpg_p016_bt601_full.png | Bin 0 -> 40860 bytes .../umbrellas.jpg_p016_bt601_full_cpu.png | Bin 0 -> 35857 bytes .../umbrellas.jpg_p016_bt601_video.png | Bin 0 -> 40946 bytes .../umbrellas.jpg_p016_bt601_video_cpu.png | Bin 0 -> 35908 bytes .../umbrellas.jpg_p016_bt709_full.png | Bin 0 -> 40942 bytes .../umbrellas.jpg_p016_bt709_full_cpu.png | Bin 0 -> 35857 bytes .../umbrellas.jpg_p016_bt709_video.png | Bin 0 -> 40966 bytes .../umbrellas.jpg_p016_bt709_video_cpu.png | Bin 0 -> 35945 bytes .../umbrellas.jpg_rgba8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_rgba8888_adobergb_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_adobergb_video.png | Bin 0 -> 35949 bytes ...rellas.jpg_rgba8888_adobergb_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_rgba8888_bt2020_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt2020_video.png | Bin 0 -> 35949 bytes ...mbrellas.jpg_rgba8888_bt2020_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt601_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt601_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_rgba8888_bt601_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt709_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt709_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_rgba8888_bt709_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgbx8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_rgbx8888_adobergb_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_adobergb_video.png | Bin 0 -> 35949 bytes ...rellas.jpg_rgbx8888_adobergb_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_rgbx8888_bt2020_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt2020_video.png | Bin 0 -> 35949 bytes ...mbrellas.jpg_rgbx8888_bt2020_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgbx8888_bt601_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt601_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_rgbx8888_bt601_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgbx8888_bt709_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt709_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_rgbx8888_bt709_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_uyvy_adobergb_full.png | Bin 0 -> 41163 bytes .../umbrellas.jpg_uyvy_adobergb_full_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_uyvy_adobergb_video.png | Bin 0 -> 41163 bytes .../umbrellas.jpg_uyvy_adobergb_video_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_uyvy_bt2020_full.png | Bin 0 -> 41160 bytes .../umbrellas.jpg_uyvy_bt2020_full_cpu.png | Bin 0 -> 36087 bytes .../umbrellas.jpg_uyvy_bt2020_video.png | Bin 0 -> 41199 bytes .../umbrellas.jpg_uyvy_bt2020_video_cpu.png | Bin 0 -> 36215 bytes .../umbrellas.jpg_uyvy_bt601_full.png | Bin 0 -> 41000 bytes .../umbrellas.jpg_uyvy_bt601_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_uyvy_bt601_video.png | Bin 0 -> 41177 bytes .../umbrellas.jpg_uyvy_bt601_video_cpu.png | Bin 0 -> 36258 bytes .../umbrellas.jpg_uyvy_bt709_full.png | Bin 0 -> 41183 bytes .../umbrellas.jpg_uyvy_bt709_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_uyvy_bt709_video.png | Bin 0 -> 41209 bytes .../umbrellas.jpg_uyvy_bt709_video_cpu.png | Bin 0 -> 36189 bytes .../umbrellas.jpg_xbgr8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_xbgr8888_adobergb_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_adobergb_video.png | Bin 0 -> 35949 bytes ...rellas.jpg_xbgr8888_adobergb_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_xbgr8888_bt2020_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt2020_video.png | Bin 0 -> 35949 bytes ...mbrellas.jpg_xbgr8888_bt2020_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_xbgr8888_bt601_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt601_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_xbgr8888_bt601_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_xbgr8888_bt709_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt709_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_xbgr8888_bt709_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_xrgb8888_adobergb_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_adobergb_video.png | Bin 0 -> 35949 bytes ...rellas.jpg_xrgb8888_adobergb_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_xrgb8888_bt2020_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt2020_video.png | Bin 0 -> 35949 bytes ...mbrellas.jpg_xrgb8888_bt2020_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_xrgb8888_bt601_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt601_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_xrgb8888_bt601_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_xrgb8888_bt709_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt709_video.png | Bin 0 -> 35949 bytes ...umbrellas.jpg_xrgb8888_bt709_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_y16_adobergb_full.png | Bin 0 -> 25240 bytes .../umbrellas.jpg_y16_adobergb_full_cpu.png | Bin 0 -> 23434 bytes .../umbrellas.jpg_y16_adobergb_video.png | Bin 0 -> 25240 bytes .../umbrellas.jpg_y16_adobergb_video_cpu.png | Bin 0 -> 23434 bytes .../umbrellas.jpg_y16_bt2020_full.png | Bin 0 -> 25544 bytes .../umbrellas.jpg_y16_bt2020_full_cpu.png | Bin 0 -> 23596 bytes .../umbrellas.jpg_y16_bt2020_video.png | Bin 0 -> 24030 bytes .../umbrellas.jpg_y16_bt2020_video_cpu.png | Bin 0 -> 22241 bytes .../testdata/umbrellas.jpg_y16_bt601_full.png | Bin 0 -> 25557 bytes .../umbrellas.jpg_y16_bt601_full_cpu.png | Bin 0 -> 23545 bytes .../umbrellas.jpg_y16_bt601_video.png | Bin 0 -> 23884 bytes .../umbrellas.jpg_y16_bt601_video_cpu.png | Bin 0 -> 22208 bytes .../testdata/umbrellas.jpg_y16_bt709_full.png | Bin 0 -> 25557 bytes .../umbrellas.jpg_y16_bt709_full_cpu.png | Bin 0 -> 23545 bytes .../umbrellas.jpg_y16_bt709_video.png | Bin 0 -> 24021 bytes .../umbrellas.jpg_y16_bt709_video_cpu.png | Bin 0 -> 22392 bytes .../umbrellas.jpg_y8_adobergb_full.png | Bin 0 -> 25364 bytes .../umbrellas.jpg_y8_adobergb_full_cpu.png | Bin 0 -> 23481 bytes .../umbrellas.jpg_y8_adobergb_video.png | Bin 0 -> 25364 bytes .../umbrellas.jpg_y8_adobergb_video_cpu.png | Bin 0 -> 23481 bytes .../testdata/umbrellas.jpg_y8_bt2020_full.png | Bin 0 -> 25430 bytes .../umbrellas.jpg_y8_bt2020_full_cpu.png | Bin 0 -> 23425 bytes .../umbrellas.jpg_y8_bt2020_video.png | Bin 0 -> 23981 bytes .../umbrellas.jpg_y8_bt2020_video_cpu.png | Bin 0 -> 22350 bytes .../testdata/umbrellas.jpg_y8_bt601_full.png | Bin 0 -> 25497 bytes .../umbrellas.jpg_y8_bt601_full_cpu.png | Bin 0 -> 23568 bytes .../testdata/umbrellas.jpg_y8_bt601_video.png | Bin 0 -> 23904 bytes .../umbrellas.jpg_y8_bt601_video_cpu.png | Bin 0 -> 22203 bytes .../testdata/umbrellas.jpg_y8_bt709_full.png | Bin 0 -> 25497 bytes .../umbrellas.jpg_y8_bt709_full_cpu.png | Bin 0 -> 23568 bytes .../testdata/umbrellas.jpg_y8_bt709_video.png | Bin 0 -> 23979 bytes .../umbrellas.jpg_y8_bt709_video_cpu.png | Bin 0 -> 22331 bytes .../umbrellas.jpg_yuv420p10_adobergb_full.png | Bin 0 -> 40919 bytes ...umbrellas.jpg_yuv420p10_adobergb_video.png | Bin 0 -> 40919 bytes .../umbrellas.jpg_yuv420p10_bt2020_full.png | Bin 0 -> 40952 bytes .../umbrellas.jpg_yuv420p10_bt2020_video.png | Bin 0 -> 40967 bytes .../umbrellas.jpg_yuv420p10_bt601_full.png | Bin 0 -> 40881 bytes .../umbrellas.jpg_yuv420p10_bt601_video.png | Bin 0 -> 40962 bytes .../umbrellas.jpg_yuv420p10_bt709_full.png | Bin 0 -> 40954 bytes .../umbrellas.jpg_yuv420p10_bt709_video.png | Bin 0 -> 40987 bytes .../umbrellas.jpg_yuv420p_adobergb_full.png | Bin 0 -> 40898 bytes ...mbrellas.jpg_yuv420p_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_yuv420p_adobergb_video.png | Bin 0 -> 40898 bytes ...brellas.jpg_yuv420p_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_yuv420p_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_yuv420p_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_yuv420p_bt2020_video.png | Bin 0 -> 40978 bytes ...umbrellas.jpg_yuv420p_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_yuv420p_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_yuv420p_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_yuv420p_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_yuv420p_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_yuv420p_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_yuv420p_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_yuv420p_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_yuv420p_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_yuv422p_adobergb_full.png | Bin 0 -> 41163 bytes ...mbrellas.jpg_yuv422p_adobergb_full_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_yuv422p_adobergb_video.png | Bin 0 -> 41163 bytes ...brellas.jpg_yuv422p_adobergb_video_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_yuv422p_bt2020_full.png | Bin 0 -> 41160 bytes .../umbrellas.jpg_yuv422p_bt2020_full_cpu.png | Bin 0 -> 36087 bytes .../umbrellas.jpg_yuv422p_bt2020_video.png | Bin 0 -> 41199 bytes ...umbrellas.jpg_yuv422p_bt2020_video_cpu.png | Bin 0 -> 36215 bytes .../umbrellas.jpg_yuv422p_bt601_full.png | Bin 0 -> 41000 bytes .../umbrellas.jpg_yuv422p_bt601_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_yuv422p_bt601_video.png | Bin 0 -> 41177 bytes .../umbrellas.jpg_yuv422p_bt601_video_cpu.png | Bin 0 -> 36258 bytes .../umbrellas.jpg_yuv422p_bt709_full.png | Bin 0 -> 41183 bytes .../umbrellas.jpg_yuv422p_bt709_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_yuv422p_bt709_video.png | Bin 0 -> 41209 bytes .../umbrellas.jpg_yuv422p_bt709_video_cpu.png | Bin 0 -> 36189 bytes .../umbrellas.jpg_yuyv_adobergb_full.png | Bin 0 -> 41163 bytes .../umbrellas.jpg_yuyv_adobergb_full_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_yuyv_adobergb_video.png | Bin 0 -> 41163 bytes .../umbrellas.jpg_yuyv_adobergb_video_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_yuyv_bt2020_full.png | Bin 0 -> 41160 bytes .../umbrellas.jpg_yuyv_bt2020_full_cpu.png | Bin 0 -> 36087 bytes .../umbrellas.jpg_yuyv_bt2020_video.png | Bin 0 -> 41199 bytes .../umbrellas.jpg_yuyv_bt2020_video_cpu.png | Bin 0 -> 36215 bytes .../umbrellas.jpg_yuyv_bt601_full.png | Bin 0 -> 41000 bytes .../umbrellas.jpg_yuyv_bt601_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_yuyv_bt601_video.png | Bin 0 -> 41177 bytes .../umbrellas.jpg_yuyv_bt601_video_cpu.png | Bin 0 -> 36258 bytes .../umbrellas.jpg_yuyv_bt709_full.png | Bin 0 -> 41183 bytes .../umbrellas.jpg_yuyv_bt709_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_yuyv_bt709_video.png | Bin 0 -> 41209 bytes .../umbrellas.jpg_yuyv_bt709_video_cpu.png | Bin 0 -> 36189 bytes .../umbrellas.jpg_yv12_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_yv12_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_yv12_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_yv12_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_yv12_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_yv12_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_yv12_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_yv12_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_yv12_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_yv12_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_yv12_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_yv12_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_yv12_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_yv12_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_yv12_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_yv12_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../tst_qvideoframecolormanagement.cpp | 644 + .../qvideoframeformat/CMakeLists.txt | 13 + .../tst_qvideoframeformat.cpp | 567 + .../qvideotexturehelper/CMakeLists.txt | 10 + .../tst_qvideotexturehelper.cpp | 259 + .../qvideotransformation/CMakeLists.txt | 9 + .../tst_qvideotransformation.cpp | 244 + .../multimedia/qwavedecoder/CMakeLists.txt | 49 + .../data/corrupt_datadesc_1_16_8000.le.wav | Bin 0 -> 4044 bytes .../data/corrupt_fmtdesc_1_16_8000.le.wav | Bin 0 -> 4044 bytes .../data/corrupt_fmtstring_1_16_8000.le.wav | Bin 0 -> 4044 bytes .../multimedia/qwavedecoder/data/empty.wav | 0 .../multimedia/qwavedecoder/data/gendata.sh | 30 + .../data/isawav_1_16_44100_le.wav | Bin 0 -> 22094 bytes .../data/isawav_1_16_44100_le_2.wav | Bin 0 -> 22096 bytes .../qwavedecoder/data/isawav_1_16_8000_le.wav | Bin 0 -> 4044 bytes .../data/isawav_1_24_44100_le.wav | Bin 0 -> 33156 bytes .../qwavedecoder/data/isawav_1_24_8000_le.wav | Bin 0 -> 6080 bytes .../data/isawav_1_32_44100_le.wav | Bin 0 -> 44180 bytes .../qwavedecoder/data/isawav_1_32_8000_le.wav | Bin 0 -> 8080 bytes .../qwavedecoder/data/isawav_1_8_44100.wav | Bin 0 -> 11070 bytes .../qwavedecoder/data/isawav_1_8_8000.wav | Bin 0 -> 2044 bytes .../data/isawav_1_8_8000_even_bext.wav | Bin 0 -> 2064 bytes .../data/isawav_1_8_8000_odd_bext.wav | Bin 0 -> 2064 bytes .../data/isawav_1_f32_44100_le.wav | Bin 0 -> 44158 bytes .../data/isawav_1_f32_8000_le.wav | Bin 0 -> 8058 bytes .../data/isawav_2_16_44100_be.wav | Bin 0 -> 44144 bytes .../qwavedecoder/data/isawav_2_16_8000_be.wav | Bin 0 -> 8044 bytes .../data/isawav_2_24_44100_be.wav | Bin 0 -> 66230 bytes .../qwavedecoder/data/isawav_2_24_8000_be.wav | Bin 0 -> 12080 bytes .../data/isawav_2_32_44100_be.wav | Bin 0 -> 88280 bytes .../qwavedecoder/data/isawav_2_32_8000_be.wav | Bin 0 -> 16080 bytes .../qwavedecoder/data/isawav_2_8_44100.wav | Bin 0 -> 22094 bytes .../qwavedecoder/data/isawav_2_8_8000.wav | Bin 0 -> 4044 bytes .../data/isawav_2_f32_44100_be.wav | Bin 0 -> 88258 bytes .../data/isawav_2_f32_8000_be.wav | Bin 0 -> 16058 bytes .../qwavedecoder/data/nosampledata.wav | Bin 0 -> 44 bytes .../multimedia/qwavedecoder/data/notawav.wav | 1 + .../multimedia/qwavedecoder/data/onebyte.wav | 1 + .../qwavedecoder/tst_qwavedecoder.cpp | 325 + .../qwindowsresampler/CMakeLists.txt | 9 + .../tst_qwindowsresampler.cpp | 124 + .../unit/multimediawidgets/CMakeLists.txt | 13 + .../qcamerawidgets/CMakeLists.txt | 19 + .../qcamerawidgets/tst_qcamerawidgets.cpp | 114 + .../qgraphicsvideoitem/CMakeLists.txt | 19 + .../tst_qgraphicsvideoitem.cpp | 390 + .../qmediaplayerwidgets/CMakeLists.txt | 19 + .../tst_qmediaplayerwidgets.cpp | 106 + .../qvideowidget/CMakeLists.txt | 20 + .../qvideowidget/tst_qvideowidget.cpp | 271 + tests/auto/unit/plugins/CMakeLists.txt | 4 + .../unit/plugins/multimedia/CMakeLists.txt | 10 + .../plugins/multimedia/ffmpeg/CMakeLists.txt | 6 + .../ffmpeg/qffmpegmath/CMakeLists.txt | 19 + .../ffmpeg/qffmpegmath/tst_qffmpegmath.cpp | 30 + .../qffmpegvideoencoderutils/CMakeLists.txt | 19 + .../tst_qffmpegvideoencoderutils.cpp | 70 + .../ffmpeg/texturebridge/CMakeLists.txt | 20 + .../ffmpeg/texturebridge/devicecontext.cpp | 137 + .../ffmpeg/texturebridge/devicecontext.h | 32 + .../texturebridge/tst_texturebridge.cpp | 186 + .../multimedia/gstreamer/CMakeLists.txt | 3 + .../gstreamer/gstreamer_backend/BLACKLIST | 2 + .../gstreamer_backend/CMakeLists.txt | 21 + .../color_matrix_90_deg_clockwise.m2v | Bin 0 -> 5625 bytes .../color_matrix_90_deg_clockwise.mp4 | Bin 0 -> 21412 bytes .../gstreamer_backend/metadata_test_file.mp4 | Bin 0 -> 29324 bytes .../gstreamer/gstreamer_backend/readme.txt | 10 + .../tst_gstreamer_backend.cpp | 596 + .../gstreamer_backend/tst_gstreamer_backend.h | 63 + .../qmediacapture_gstreamer/BLACKLIST | 2 + .../qmediacapture_gstreamer/CMakeLists.txt | 16 + .../tst_qmediacapture_gstreamer.cpp | 211 + .../qmediaplayer_gstreamer/BLACKLIST | 2 + .../qmediaplayer_gstreamer/CMakeLists.txt | 19 + .../testdata/color_matrix.mp4 | Bin 0 -> 21412 bytes .../tst_qmediaplayer_gstreamer.cpp | 167 + .../tst_qmediaplayer_gstreamer.h | 50 + tests/global/global.cfg | 6 + tests/manual/CMakeLists.txt | 48 + tests/manual/audiodecoder/CMakeLists.txt | 47 + tests/manual/audiodecoder/audiodecoder.cpp | 161 + tests/manual/audiodecoder/audiodecoder.h | 55 + tests/manual/audiodecoder/main.cpp | 83 + .../CMakeLists.txt | 41 + .../gstreamer-custom-camera-rtp/Info.plist.in | 46 + .../gstreamer-custom-camera-rtp.cpp | 57 + .../gstreamer-custom-camera/CMakeLists.txt | 39 + .../gstreamer-custom-camera/Info.plist.in | 46 + .../gstreamer-custom-camera.cpp | 50 + tests/manual/media-metadata/CMakeLists.txt | 36 + tests/manual/media-metadata/Info.plist.in | 38 + .../manual/media-metadata/media-metadata.cpp | 110 + tests/manual/mediadevices/CMakeLists.txt | 42 + tests/manual/mediadevices/main.cpp | 174 + tests/manual/mediaformats/CMakeLists.txt | 39 + tests/manual/mediaformats/main.cpp | 87 + tests/manual/mediaframeinputs/CMakeLists.txt | 46 + .../mediaframeinputs/commandlineparser.cpp | 390 + .../mediaframeinputs/commandlineparser.h | 164 + tests/manual/mediaframeinputs/main.cpp | 41 + .../mediaframeinputs/mediaframeinputqueue.h | 65 + .../mediaframeinputs/mediagenerator.cpp | 178 + .../manual/mediaframeinputs/mediagenerator.h | 59 + .../manual/mediaframeinputs/previewrunner.cpp | 67 + tests/manual/mediaframeinputs/previewrunner.h | 38 + .../mediaframeinputs/pushmodemediasource.h | 53 + .../mediaframeinputs/recordingrunner.cpp | 154 + .../manual/mediaframeinputs/recordingrunner.h | 91 + tests/manual/mediaframeinputs/settings.h | 67 + .../minimal-audio-callback-io/CMakeLists.txt | 45 + .../minimal-audio-callback-io/Info.plist.in | 46 + .../minimal-audio-callback-io.cpp | 362 + .../minimal-audio-recorder/CMakeLists.txt | 37 + .../minimal-audio-recorder/info.plist.in | 46 + .../minimal-audio-recorder.cpp | 114 + .../minimal-camera-recorder/CMakeLists.txt | 36 + .../minimal-camera-recorder/Info.plist.in | 46 + .../minimal-camera-recorder.cpp | 154 + tests/manual/minimal-player/CMakeLists.txt | 37 + tests/manual/minimal-player/Info.plist.in | 46 + .../manual/minimal-player/minimal-player.cpp | 139 + .../minimal-screen-recorder/CMakeLists.txt | 39 + .../minimal-screen-recorder/Info.plist.in | 46 + .../minimal-screen-recorder.cpp | 75 + .../qml-camera-advanced/AdvancedPanel.qml | 85 + .../qml-camera-advanced/AllCameraControls.qml | 242 + .../manual/qml-camera-advanced/CMakeLists.txt | 58 + .../CameraDeviceSelector.qml | 31 + .../manual/qml-camera-advanced/CameraFeed.qml | 59 + .../qml-camera-advanced/CameraHelper.qml | 197 + .../ImageCaptureHelper.qml | 35 + tests/manual/qml-camera-advanced/Info.plist | 50 + tests/manual/qml-camera-advanced/InfoPage.qml | 121 + tests/manual/qml-camera-advanced/Main.qml | 236 + .../MediaDevicesHelper.qml | 130 + .../qml-camera-advanced/QuickControls.qml | 166 + tests/manual/qml-camera-advanced/main.cpp | 23 + .../qml-gstreamer-pipeline/CMakeLists.txt | 44 + .../qml-gstreamer-pipeline/Info.plist.in | 46 + .../qml-gstreamer-pipeline.cpp | 20 + .../qml-gstreamer-pipeline.qml | 50 + tests/manual/qml-gstreamer-rtp/CMakeLists.txt | 44 + tests/manual/qml-gstreamer-rtp/Info.plist.in | 46 + .../qml-gstreamer-rtp/qml-gstreamer-rtp.cpp | 32 + .../qml-gstreamer-rtp/qml-gstreamer-rtp.qml | 29 + .../qml-minimal-audio-recorder/CMakeLists.txt | 44 + .../qml-minimal-audio-recorder/Info.plist.in | 46 + .../qml-minimal-audio-recorder.cpp | 17 + .../qml-minimal-audio-recorder.qml | 107 + .../manual/qml-minimal-camera/CMakeLists.txt | 44 + tests/manual/qml-minimal-camera/Info.plist.in | 46 + .../qml-minimal-camera/qml-minimal-camera.cpp | 17 + .../qml-minimal-camera/qml-minimal-camera.qml | 34 + .../manual/qml-minimal-player/CMakeLists.txt | 44 + tests/manual/qml-minimal-player/Info.plist.in | 46 + .../qml-minimal-player/qml-minimal-player.cpp | 17 + .../qml-minimal-player/qml-minimal-player.qml | 42 + .../qml-minimal-sound-effect/CMakeLists.txt | 56 + .../qml-minimal-sound-effect/Info.plist.in | 46 + .../qml-minimal-sound-effect/double-drop.wav | Bin 0 -> 20452 bytes .../qml-minimal-sound-effect.cpp | 17 + .../qml-minimal-sound-effect.qml | 92 + .../qml-minimal-sound-effect/triple-click.wav | Bin 0 -> 21256 bytes .../qml-multiple-players/CMakeLists.txt | 52 + .../qml-multiple-players.cpp | 17 + .../qml-multiple-players.qml | 275 + .../qml-multiple-players/testvideo1.mp4 | Bin 0 -> 10021 bytes .../qml-multiple-players/testvideo2.mp4 | Bin 0 -> 9485 bytes .../qml-screencapture-advanced/CMakeLists.txt | 49 + .../qml-screencapture-advanced/Main.qml | 88 + .../ScreenCapturePanel.qml | 156 + .../WindowCapturePanel.qml | 219 + .../android/AndroidManifest.xml | 53 + .../qml-screencapture-advanced/main.cpp | 23 + tests/manual/wasm/CMakeLists.txt | 6 + tests/manual/wasm/camera/CMakeLists.txt | 44 + tests/manual/wasm/camera/main.cpp | 17 + tests/manual/wasm/camera/mainwindow.cpp | 262 + tests/manual/wasm/camera/mainwindow.h | 55 + tests/manual/wasm/camera/mainwindow.ui | 107 + util/REUSE.toml | 8 + util/adt_generate_qt.m | 165 + util/macos_test_audio_config/CMakeLists.txt | 13 + util/macos_test_audio_config/README | 25 + .../compile_and_run.sh | 19 + util/macos_test_audio_config/main.cpp | 498 + 3011 files changed, 494446 insertions(+) create mode 100644 .cmake.conf create mode 100644 .gitreview create mode 100644 .tag create mode 100644 CMakeLists.txt create mode 100644 LICENSES/Apache-2.0.txt create mode 100644 LICENSES/BSD-3-Clause.txt create mode 100644 LICENSES/GFDL-1.3-no-invariants-only.txt create mode 100644 LICENSES/GPL-2.0-only.txt create mode 100644 LICENSES/GPL-3.0-only.txt create mode 100644 LICENSES/LGPL-3.0-only.txt create mode 100644 LICENSES/LicenseRef-Qt-Commercial.txt create mode 100644 LICENSES/MIT-0.txt create mode 100644 LICENSES/MIT.txt create mode 100644 LICENSES/MPL-2.0.txt create mode 100644 LICENSES/Qt-GPL-exception-1.0.txt create mode 100644 REUSE.toml create mode 100644 cmake/FindFFmpeg.cmake create mode 100644 cmake/FindGObject.cmake create mode 100644 cmake/FindGStreamer.cmake create mode 100644 cmake/FindMMRenderer.cmake create mode 100644 cmake/FindMMRendererCore.cmake create mode 100644 cmake/FindPipeWire.cmake create mode 100644 cmake/FindVAAPI.cmake create mode 100644 cmake/FindWrapPulseAudio.cmake create mode 100644 cmake/REUSE.toml create mode 100644 coin/axivion/ci_config_linux.json create mode 100644 coin/instructions/configure_tests_environment_for_ffmpeg_backend.yaml create mode 100644 coin/instructions/run_darwin_backend_tests.yaml create mode 100644 coin/instructions/run_ffmpeg_backend_tests.yaml create mode 100644 coin/instructions/run_gstreamer_backend_tests.yaml create mode 100644 coin/module_config.yaml create mode 100644 config.tests/gpu_vivante/CMakeLists.txt create mode 100644 config.tests/gpu_vivante/main.cpp create mode 100644 config.tests/linux_v4l/CMakeLists.txt create mode 100644 config.tests/linux_v4l/main.cpp create mode 100644 config_help.txt create mode 100644 configure.cmake create mode 100644 dependencies.yaml create mode 100644 dist/REUSE.toml create mode 100644 dist/changes-5.0.1 create mode 100644 dist/changes-5.0.2 create mode 100644 dist/changes-5.1.0 create mode 100644 dist/changes-5.1.1 create mode 100644 dist/changes-5.10.0 create mode 100644 dist/changes-5.10.1 create mode 100644 dist/changes-5.11.0 create mode 100644 dist/changes-5.11.1 create mode 100644 dist/changes-5.11.2 create mode 100644 dist/changes-5.11.3 create mode 100644 dist/changes-5.12.0 create mode 100644 dist/changes-5.12.1 create mode 100644 dist/changes-5.12.2 create mode 100644 dist/changes-5.12.3 create mode 100644 dist/changes-5.12.4 create mode 100644 dist/changes-5.12.5 create mode 100644 dist/changes-5.13.0 create mode 100644 dist/changes-5.13.1 create mode 100644 dist/changes-5.13.2 create mode 100644 dist/changes-5.14.0 create mode 100644 dist/changes-5.14.1 create mode 100644 dist/changes-5.14.2 create mode 100644 dist/changes-5.15.0 create mode 100644 dist/changes-5.15.1 create mode 100644 dist/changes-5.15.2 create mode 100644 dist/changes-5.2.0 create mode 100644 dist/changes-5.2.1 create mode 100644 dist/changes-5.3.1 create mode 100644 dist/changes-5.3.2 create mode 100644 dist/changes-5.4.0 create mode 100644 dist/changes-5.4.1 create mode 100644 dist/changes-5.4.2 create mode 100644 dist/changes-5.5.0 create mode 100644 dist/changes-5.5.1 create mode 100644 dist/changes-5.6.0 create mode 100644 dist/changes-5.6.1 create mode 100644 dist/changes-5.6.2 create mode 100644 dist/changes-5.6.3 create mode 100644 dist/changes-5.7.0 create mode 100644 dist/changes-5.7.1 create mode 100644 dist/changes-5.8.0 create mode 100644 dist/changes-5.9.0 create mode 100644 dist/changes-5.9.1 create mode 100644 dist/changes-5.9.2 create mode 100644 dist/changes-5.9.3 create mode 100644 dist/changes-5.9.4 create mode 100644 dist/changes-5.9.5 create mode 100644 dist/changes-5.9.6 create mode 100644 examples/CMakeLists.txt create mode 100644 examples/examples.pro create mode 100644 examples/multimedia/CMakeLists.txt create mode 100644 examples/multimedia/audiodevices/CMakeLists.txt create mode 100644 examples/multimedia/audiodevices/Info.plist.in create mode 100644 examples/multimedia/audiodevices/Info.qmake.ios.plist create mode 100644 examples/multimedia/audiodevices/Info.qmake.macos.plist create mode 100644 examples/multimedia/audiodevices/audiodevices.cpp create mode 100644 examples/multimedia/audiodevices/audiodevices.h create mode 100644 examples/multimedia/audiodevices/audiodevices.pro create mode 100644 examples/multimedia/audiodevices/audiodevicesbase.ui create mode 100644 examples/multimedia/audiodevices/doc/images/audiodevices.png create mode 100644 examples/multimedia/audiodevices/doc/src/audiodevices.qdoc create mode 100644 examples/multimedia/audiodevices/main.cpp create mode 100644 examples/multimedia/audiooutput/CMakeLists.txt create mode 100644 examples/multimedia/audiooutput/audiooutput.cpp create mode 100644 examples/multimedia/audiooutput/audiooutput.h create mode 100644 examples/multimedia/audiooutput/audiooutput.pro create mode 100644 examples/multimedia/audiooutput/doc/images/audiooutput-example.png create mode 100644 examples/multimedia/audiooutput/doc/src/audiooutput.qdoc create mode 100644 examples/multimedia/audiooutput/main.cpp create mode 100644 examples/multimedia/audiorecorder/CMakeLists.txt create mode 100644 examples/multimedia/audiorecorder/Info.plist.in create mode 100644 examples/multimedia/audiorecorder/Info.qmake.ios.plist create mode 100644 examples/multimedia/audiorecorder/Info.qmake.macos.plist create mode 100644 examples/multimedia/audiorecorder/audiorecorder.cpp create mode 100644 examples/multimedia/audiorecorder/audiorecorder.h create mode 100644 examples/multimedia/audiorecorder/audiorecorder.pro create mode 100644 examples/multimedia/audiorecorder/audiorecorder.ui create mode 100644 examples/multimedia/audiorecorder/doc/images/audiorecorder.png create mode 100644 examples/multimedia/audiorecorder/doc/src/audiorecorder.qdoc create mode 100644 examples/multimedia/audiorecorder/main.cpp create mode 100644 examples/multimedia/audiosource/CMakeLists.txt create mode 100644 examples/multimedia/audiosource/Info.plist.in create mode 100644 examples/multimedia/audiosource/Info.qmake.ios.plist create mode 100644 examples/multimedia/audiosource/Info.qmake.macos.plist create mode 100644 examples/multimedia/audiosource/audiosource.cpp create mode 100644 examples/multimedia/audiosource/audiosource.h create mode 100644 examples/multimedia/audiosource/audiosource.pro create mode 100644 examples/multimedia/audiosource/doc/images/audiosource-example.png create mode 100644 examples/multimedia/audiosource/doc/src/audiosource.qdoc create mode 100644 examples/multimedia/audiosource/main.cpp create mode 100644 examples/multimedia/camera/CMakeLists.txt create mode 100644 examples/multimedia/camera/Info.qmake.ios.plist create mode 100644 examples/multimedia/camera/Info.qmake.macos.plist create mode 100644 examples/multimedia/camera/android/AndroidManifest.xml create mode 100644 examples/multimedia/camera/camera.cpp create mode 100644 examples/multimedia/camera/camera.h create mode 100644 examples/multimedia/camera/camera.pro create mode 100644 examples/multimedia/camera/camera.qrc create mode 100644 examples/multimedia/camera/camera.ui create mode 100644 examples/multimedia/camera/camera_mobile.ui create mode 100644 examples/multimedia/camera/doc/images/camera-example.png create mode 100644 examples/multimedia/camera/doc/src/camera.qdoc create mode 100644 examples/multimedia/camera/images/shutter.svg create mode 100644 examples/multimedia/camera/imagesettings.cpp create mode 100644 examples/multimedia/camera/imagesettings.h create mode 100644 examples/multimedia/camera/imagesettings.ui create mode 100644 examples/multimedia/camera/ios/Info.plist.in create mode 100644 examples/multimedia/camera/macos/Info.plist.in create mode 100644 examples/multimedia/camera/main.cpp create mode 100644 examples/multimedia/camera/metadatadialog.cpp create mode 100644 examples/multimedia/camera/metadatadialog.h create mode 100644 examples/multimedia/camera/videosettings.cpp create mode 100644 examples/multimedia/camera/videosettings.h create mode 100644 examples/multimedia/camera/videosettings.ui create mode 100644 examples/multimedia/camera/videosettings_mobile.ui create mode 100644 examples/multimedia/declarative-camera/CMakeLists.txt create mode 100644 examples/multimedia/declarative-camera/CameraButton.qml create mode 100644 examples/multimedia/declarative-camera/CameraListButton.qml create mode 100644 examples/multimedia/declarative-camera/CameraWhiteBalanceButton.qml create mode 100644 examples/multimedia/declarative-camera/FlashControl.qml create mode 100644 examples/multimedia/declarative-camera/Info.plist.in create mode 100644 examples/multimedia/declarative-camera/Info.qmake.ios.plist create mode 100644 examples/multimedia/declarative-camera/Info.qmake.macos.plist create mode 100644 examples/multimedia/declarative-camera/PhotoCaptureControls.qml create mode 100644 examples/multimedia/declarative-camera/PhotoPreview.qml create mode 100644 examples/multimedia/declarative-camera/VideoCaptureControls.qml create mode 100644 examples/multimedia/declarative-camera/VideoPreview.qml create mode 100644 examples/multimedia/declarative-camera/ZoomControl.qml create mode 100644 examples/multimedia/declarative-camera/declarative-camera.pro create mode 100644 examples/multimedia/declarative-camera/declarative-camera.qml create mode 100644 examples/multimedia/declarative-camera/declarative-camera.qmlproject create mode 100644 examples/multimedia/declarative-camera/declarative-camera.qrc create mode 100644 examples/multimedia/declarative-camera/doc/images/CaptureControls.png create mode 100644 examples/multimedia/declarative-camera/doc/images/FlashControls.png create mode 100644 examples/multimedia/declarative-camera/doc/images/VideoCaptureControls.png create mode 100644 examples/multimedia/declarative-camera/doc/images/ZoomControl.png create mode 100644 examples/multimedia/declarative-camera/doc/images/qml-camera.png create mode 100644 examples/multimedia/declarative-camera/doc/images/qml-declarative-portrait.png create mode 100644 examples/multimedia/declarative-camera/doc/src/declarative-camera.qdoc create mode 100644 examples/multimedia/declarative-camera/images/camera_camera_setting.png create mode 100644 examples/multimedia/declarative-camera/images/camera_flash_auto.png create mode 100644 examples/multimedia/declarative-camera/images/camera_flash_fill.png create mode 100644 examples/multimedia/declarative-camera/images/camera_flash_off.png create mode 100644 examples/multimedia/declarative-camera/images/camera_flash_redeye.png create mode 100644 examples/multimedia/declarative-camera/images/toolbutton.png create mode 100644 examples/multimedia/declarative-camera/images/toolbutton.sci create mode 100644 examples/multimedia/declarative-camera/qmlcamera.cpp create mode 100644 examples/multimedia/multimedia.pro create mode 100644 examples/multimedia/player/CMakeLists.txt create mode 100644 examples/multimedia/player/audiolevelmeter.cpp create mode 100644 examples/multimedia/player/audiolevelmeter.h create mode 100644 examples/multimedia/player/doc/images/mediaplayerex.jpg create mode 100644 examples/multimedia/player/doc/src/player.qdoc create mode 100644 examples/multimedia/player/main.cpp create mode 100644 examples/multimedia/player/player.cpp create mode 100644 examples/multimedia/player/player.h create mode 100644 examples/multimedia/player/player.pro create mode 100644 examples/multimedia/player/playercontrols.cpp create mode 100644 examples/multimedia/player/playercontrols.h create mode 100644 examples/multimedia/player/playlistmodel.cpp create mode 100644 examples/multimedia/player/playlistmodel.h create mode 100644 examples/multimedia/player/qmediaplaylist.cpp create mode 100644 examples/multimedia/player/qmediaplaylist.h create mode 100644 examples/multimedia/player/qmediaplaylist_p.cpp create mode 100644 examples/multimedia/player/qmediaplaylist_p.h create mode 100644 examples/multimedia/player/qplaylistfileparser.cpp create mode 100644 examples/multimedia/player/qplaylistfileparser.h create mode 100644 examples/multimedia/player/videowidget.cpp create mode 100644 examples/multimedia/player/videowidget.h create mode 100644 examples/multimedia/screencapture/CMakeLists.txt create mode 100644 examples/multimedia/screencapture/Info.plist.in create mode 100644 examples/multimedia/screencapture/android/AndroidManifest.xml create mode 100644 examples/multimedia/screencapture/doc/images/screencapture.jpg create mode 100644 examples/multimedia/screencapture/doc/src/screencapture.qdoc create mode 100644 examples/multimedia/screencapture/main.cpp create mode 100644 examples/multimedia/screencapture/screencapture.pro create mode 100644 examples/multimedia/screencapture/screencapturepreview.cpp create mode 100644 examples/multimedia/screencapture/screencapturepreview.h create mode 100644 examples/multimedia/screencapture/screenlistmodel.cpp create mode 100644 examples/multimedia/screencapture/screenlistmodel.h create mode 100644 examples/multimedia/screencapture/windowlistmodel.cpp create mode 100644 examples/multimedia/screencapture/windowlistmodel.h create mode 100644 examples/multimedia/video/CMakeLists.txt create mode 100644 examples/multimedia/video/mediaplayer/CMakeLists.txt create mode 100644 examples/multimedia/video/mediaplayer/Main.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/AudioControl.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/MetadataInfo.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/PlaybackControl.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/PlaybackSeekControl.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/SettingsPopup.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/TracksInfo.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/UrlPopup.qml create mode 100644 examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player-settings.png create mode 100644 examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player.png create mode 100644 examples/multimedia/video/mediaplayer/doc/src/mediaplayer.qdoc create mode 100644 examples/multimedia/video/mediaplayer/images/backward10.svg create mode 100644 examples/multimedia/video/mediaplayer/images/ff.svg create mode 100644 examples/multimedia/video/mediaplayer/images/forward10.svg create mode 100644 examples/multimedia/video/mediaplayer/images/link.svg create mode 100644 examples/multimedia/video/mediaplayer/images/loop.svg create mode 100644 examples/multimedia/video/mediaplayer/images/more.svg create mode 100644 examples/multimedia/video/mediaplayer/images/mute.svg create mode 100644 examples/multimedia/video/mediaplayer/images/open_new.svg create mode 100644 examples/multimedia/video/mediaplayer/images/pause_symbol.svg create mode 100644 examples/multimedia/video/mediaplayer/images/play_symbol.svg create mode 100644 examples/multimedia/video/mediaplayer/images/rewind.svg create mode 100644 examples/multimedia/video/mediaplayer/images/settings.svg create mode 100644 examples/multimedia/video/mediaplayer/images/speaker.svg create mode 100644 examples/multimedia/video/mediaplayer/images/stop_symbol.svg create mode 100644 examples/multimedia/video/mediaplayer/images/url.svg create mode 100644 examples/multimedia/video/mediaplayer/images/volume.svg create mode 100644 examples/multimedia/video/mediaplayer/images/volume_mute.svg create mode 100644 examples/multimedia/video/mediaplayer/images/zoom_maximize.svg create mode 100644 examples/multimedia/video/mediaplayer/images/zoom_minimize.svg create mode 100644 examples/multimedia/video/mediaplayer/main.cpp create mode 100644 examples/multimedia/video/qmlvideo/CMakeLists.txt create mode 100644 examples/multimedia/video/qmlvideo/Info.plist.in create mode 100644 examples/multimedia/video/qmlvideo/doc/images/qmlvideo-menu.jpg create mode 100644 examples/multimedia/video/qmlvideo/doc/images/qmlvideo-overlay.jpg create mode 100644 examples/multimedia/video/qmlvideo/doc/images/video-qml-paint-rate.png create mode 100644 examples/multimedia/video/qmlvideo/doc/src/qmlvideo.qdoc create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/CMakeLists.txt create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/FrequencyItem.qml create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/PerformanceItem.qml create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/frequencymonitor.cpp create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/frequencymonitor.h create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/qmldir create mode 100644 examples/multimedia/video/qmlvideo/main.cpp create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo.png create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo.pro create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo.svg create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CMakeLists.txt create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraBasic.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraDrag.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraDummy.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreen.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreenInverted.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraItem.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraMove.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraOverlay.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraResize.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraRotate.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraSpin.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/Content.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/ErrorDialog.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/Main.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/Scene.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneBasic.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneDrag.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreen.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreenInverted.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneMove.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneMulti.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneOverlay.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneResize.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneRotate.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneSelectionPanel.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneSpin.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SeekControl.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoBasic.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoDrag.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoDummy.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoFillMode.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreen.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreenInverted.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoItem.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoMetadata.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoMove.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoOverlay.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoPlaybackRate.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoResize.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoRotate.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoSeek.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoSpin.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/images/folder.png create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/images/leaves.jpg create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/images/up.png create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/qmldir create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/qmlvideo_global.h create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.cpp create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.h create mode 100644 examples/multimedia/video/qmlvideo/trace.h create mode 100644 examples/multimedia/video/recorder/AudioInputSelect.qml create mode 100644 examples/multimedia/video/recorder/CMakeLists.txt create mode 100644 examples/multimedia/video/recorder/Controls.qml create mode 100644 examples/multimedia/video/recorder/Info.plist.in create mode 100644 examples/multimedia/video/recorder/Main.qml create mode 100644 examples/multimedia/video/recorder/MediaList.qml create mode 100644 examples/multimedia/video/recorder/PermissionHelper.qml create mode 100644 examples/multimedia/video/recorder/Playback.qml create mode 100644 examples/multimedia/video/recorder/RecordButton.qml create mode 100644 examples/multimedia/video/recorder/SettingsEncoder.qml create mode 100644 examples/multimedia/video/recorder/SettingsMetaData.qml create mode 100644 examples/multimedia/video/recorder/Style.qml create mode 100644 examples/multimedia/video/recorder/StyleParameter.qml create mode 100644 examples/multimedia/video/recorder/StyleRectangle.qml create mode 100644 examples/multimedia/video/recorder/VideoSourceSelect.qml create mode 100644 examples/multimedia/video/recorder/android/AndroidManifest.xml create mode 100644 examples/multimedia/video/recorder/doc/images/qml-recorder-control-bar-overview.gif create mode 100644 examples/multimedia/video/recorder/doc/images/qml-recorder-overview.gif create mode 100644 examples/multimedia/video/recorder/doc/images/qmlrecorder.jpg create mode 100644 examples/multimedia/video/recorder/doc/src/recorder.qdoc create mode 100644 examples/multimedia/video/recorder/main.cpp create mode 100644 examples/multimedia/video/video.pro create mode 100644 examples/multimedia/videographicsitem/CMakeLists.txt create mode 100644 examples/multimedia/videographicsitem/doc/images/video-videographicsitem.png create mode 100644 examples/multimedia/videographicsitem/doc/src/videographicsitem.qdoc create mode 100644 examples/multimedia/videographicsitem/main.cpp create mode 100644 examples/multimedia/videographicsitem/videographicsitem.pro create mode 100644 examples/multimedia/videographicsitem/videoplayer.cpp create mode 100644 examples/multimedia/videographicsitem/videoplayer.h create mode 100644 examples/multimedia/videowidget/CMakeLists.txt create mode 100644 examples/multimedia/videowidget/doc/images/video-videowidget.png create mode 100644 examples/multimedia/videowidget/doc/src/videowidget.qdoc create mode 100644 examples/multimedia/videowidget/main.cpp create mode 100644 examples/multimedia/videowidget/videoplayer.cpp create mode 100644 examples/multimedia/videowidget/videoplayer.h create mode 100644 examples/multimedia/videowidget/videowidget.pro create mode 100644 examples/spatialaudio/CMakeLists.txt create mode 100644 examples/spatialaudio/audiopanning/CMakeLists.txt create mode 100644 examples/spatialaudio/audiopanning/audiopanning.pro create mode 100644 examples/spatialaudio/audiopanning/doc/images/audiopanning-example.png create mode 100644 examples/spatialaudio/audiopanning/doc/src/audiopanning.qdoc create mode 100644 examples/spatialaudio/audiopanning/main.cpp create mode 100644 examples/spatialaudio/spatialaudio.pro create mode 100644 licenseRule.json create mode 100644 mkspecs/features/ios/add_ios_ffmpeg_libraries.prf create mode 100644 qt_cmdline.cmake create mode 100644 src/3rdparty/dr_libs/0001-3rdparty-drwav-namespace-implementation.patch create mode 100644 src/3rdparty/dr_libs/LICENSE create mode 100644 src/3rdparty/dr_libs/REUSE.toml create mode 100644 src/3rdparty/dr_libs/dr_wav.h create mode 100644 src/3rdparty/dr_libs/qt_attribution.json create mode 100644 src/3rdparty/eigen/.clang-format create mode 100644 src/3rdparty/eigen/CHANGELOG.md create mode 100644 src/3rdparty/eigen/COPYING.APACHE create mode 100644 src/3rdparty/eigen/COPYING.BSD create mode 100644 src/3rdparty/eigen/COPYING.MINPACK create mode 100644 src/3rdparty/eigen/COPYING.MPL2 create mode 100644 src/3rdparty/eigen/COPYING.README create mode 100644 src/3rdparty/eigen/COPYRIGHTS create mode 100644 src/3rdparty/eigen/Eigen/AccelerateSupport create mode 100644 src/3rdparty/eigen/Eigen/Cholesky create mode 100644 src/3rdparty/eigen/Eigen/CholmodSupport create mode 100644 src/3rdparty/eigen/Eigen/Core create mode 100644 src/3rdparty/eigen/Eigen/Dense create mode 100644 src/3rdparty/eigen/Eigen/Eigen create mode 100644 src/3rdparty/eigen/Eigen/Eigenvalues create mode 100644 src/3rdparty/eigen/Eigen/Geometry create mode 100644 src/3rdparty/eigen/Eigen/Householder create mode 100644 src/3rdparty/eigen/Eigen/IterativeLinearSolvers create mode 100644 src/3rdparty/eigen/Eigen/Jacobi create mode 100644 src/3rdparty/eigen/Eigen/KLUSupport create mode 100644 src/3rdparty/eigen/Eigen/LU create mode 100644 src/3rdparty/eigen/Eigen/MetisSupport create mode 100644 src/3rdparty/eigen/Eigen/OrderingMethods create mode 100644 src/3rdparty/eigen/Eigen/PaStiXSupport create mode 100644 src/3rdparty/eigen/Eigen/PardisoSupport create mode 100644 src/3rdparty/eigen/Eigen/QR create mode 100644 src/3rdparty/eigen/Eigen/QtAlignedMalloc create mode 100644 src/3rdparty/eigen/Eigen/SPQRSupport create mode 100644 src/3rdparty/eigen/Eigen/SVD create mode 100644 src/3rdparty/eigen/Eigen/Sparse create mode 100644 src/3rdparty/eigen/Eigen/SparseCholesky create mode 100644 src/3rdparty/eigen/Eigen/SparseCore create mode 100644 src/3rdparty/eigen/Eigen/SparseLU create mode 100644 src/3rdparty/eigen/Eigen/SparseQR create mode 100644 src/3rdparty/eigen/Eigen/StdDeque create mode 100644 src/3rdparty/eigen/Eigen/StdList create mode 100644 src/3rdparty/eigen/Eigen/StdVector create mode 100644 src/3rdparty/eigen/Eigen/SuperLUSupport create mode 100644 src/3rdparty/eigen/Eigen/ThreadPool create mode 100644 src/3rdparty/eigen/Eigen/UmfPackSupport create mode 100644 src/3rdparty/eigen/Eigen/Version create mode 100644 src/3rdparty/eigen/Eigen/src/AccelerateSupport/AccelerateSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/AccelerateSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/Cholesky/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h create mode 100644 src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h create mode 100644 src/3rdparty/eigen/Eigen/src/Cholesky/LLT_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/CholmodSupport/CholmodSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/CholmodSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ArithmeticSequence.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Array.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ArrayWrapper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Assign.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/AssignEvaluator.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Assign_MKL.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/BandMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Block.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CommaInitializer.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ConditionEstimator.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CoreEvaluators.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CoreIterators.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseBinaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseNullaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseTernaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryView.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DenseBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DenseCoeffsBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DenseStorage.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DeviceWrapper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Diagonal.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DiagonalMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DiagonalProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Dot.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/EigenBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Fill.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/FindCoeff.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ForceAlignedAccess.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/GeneralProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/GenericPacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/GlobalFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/IO.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/IndexedView.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/InnerProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Inverse.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Map.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/MapBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/MathFunctionsImpl.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Matrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/MatrixBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/NestByValue.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/NoAlias.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/NumTraits.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/PartialReduxEvaluator.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/PermutationMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/PlainObjectBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Product.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ProductEvaluators.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Random.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/RandomImpl.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/RealView.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Redux.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Ref.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Replicate.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Reshaped.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ReturnByValue.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Reverse.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Select.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SelfAdjointView.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SelfCwiseBinaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SkewSymmetricMatrix3.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Solve.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SolveTriangular.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SolverBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/StableNorm.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/StlIterators.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Stride.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Swap.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Transpose.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Transpositions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/TriangularMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/VectorBlock.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/VectorwiseOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Visitor.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/Reductions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/GemmKernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/MathFunctionsFP16.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/PacketMathFP16.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/Reductions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/TrsmKernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/TrsmUnrolls.inc create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/TypeCastingFP16.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MatrixProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MatrixProductCommon.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MatrixProductMMA.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MatrixProductMMAbfloat16.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MatrixVectorProduct.inc create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/BFloat16.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/ConjHelper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/GenericPacketMathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/GenericPacketMathFunctionsFwd.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/Half.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/Settings.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/GPU/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/GPU/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/GPU/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/GPU/Tuple.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/GPU/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/HIP/hcc/math_constants.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/HVX/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/LSX/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/LSX/GeneralBlockPanelKernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/LSX/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/LSX/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/LSX/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/MSA/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/MSA/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/MSA/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/GeneralBlockPanelKernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/UnaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/Reductions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SVE/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SVE/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SVE/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/InteropHeaders.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/ZVector/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/ZVector/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/ZVector/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/AssignmentFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/BinaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/NullaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/StlFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/TernaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/UnaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralBlockPanelKernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixMatrixTriangular.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixMatrixTriangular_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixMatrix_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixVector_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/Parallelizer.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointMatrixMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointMatrixMatrix_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointMatrixVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointMatrixVector_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointRank2Update.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularMatrixMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularMatrixMatrix_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularMatrixVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularMatrixVector_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularSolverMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularSolverMatrix_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularSolverVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Assert.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/BlasUtil.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/ConfigureVectorization.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Constants.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/DisableStupidWarnings.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/EmulateArray.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/ForwardDeclarations.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/GpuHipCudaDefines.inc create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/GpuHipCudaUndefines.inc create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/IndexedViewHelper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/IntegralConstant.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/MKL_support.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Macros.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/MaxSizeVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Memory.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Meta.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/MoreMeta.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/ReenableStupidWarnings.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/ReshapedHelper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Serializer.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/StaticAssert.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/SymbolicIndex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/XprHelper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/ComplexEigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/ComplexSchur.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/ComplexSchur_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/EigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/GeneralizedEigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/GeneralizedSelfAdjointEigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/HessenbergDecomposition.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/MatrixBaseEigenvalues.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/RealQZ.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/RealSchur.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/RealSchur_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/SelfAdjointEigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/SelfAdjointEigenSolver_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/Tridiagonalization.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/AlignedBox.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/AngleAxis.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/EulerAngles.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Homogeneous.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Hyperplane.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/OrthoMethods.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/ParametrizedLine.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Quaternion.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Rotation2D.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/RotationBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Scaling.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Transform.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Translation.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Umeyama.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/arch/Geometry_SIMD.h create mode 100644 src/3rdparty/eigen/Eigen/src/Householder/BlockHouseholder.h create mode 100644 src/3rdparty/eigen/Eigen/src/Householder/Householder.h create mode 100644 src/3rdparty/eigen/Eigen/src/Householder/HouseholderSequence.h create mode 100644 src/3rdparty/eigen/Eigen/src/Householder/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/BasicPreconditioners.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/BiCGSTAB.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/ConjugateGradient.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/IncompleteCholesky.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/IncompleteLUT.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/IterativeSolverBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/LeastSquareConjugateGradient.h create mode 100644 src/3rdparty/eigen/Eigen/src/IterativeLinearSolvers/SolveWithGuess.h create mode 100644 src/3rdparty/eigen/Eigen/src/Jacobi/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/Jacobi/Jacobi.h create mode 100644 src/3rdparty/eigen/Eigen/src/KLUSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/KLUSupport/KLUSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/Determinant.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/FullPivLU.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/InverseImpl.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/PartialPivLU.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/PartialPivLU_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/arch/InverseSize4.h create mode 100644 src/3rdparty/eigen/Eigen/src/MetisSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/MetisSupport/MetisSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/OrderingMethods/Amd.h create mode 100644 src/3rdparty/eigen/Eigen/src/OrderingMethods/Eigen_Colamd.h create mode 100644 src/3rdparty/eigen/Eigen/src/OrderingMethods/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/OrderingMethods/Ordering.h create mode 100644 src/3rdparty/eigen/Eigen/src/PaStiXSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/PaStiXSupport/PaStiXSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/PardisoSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/PardisoSupport/PardisoSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/ColPivHouseholderQR.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/ColPivHouseholderQR_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/CompleteOrthogonalDecomposition.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/FullPivHouseholderQR.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/HouseholderQR.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/HouseholderQR_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/SPQRSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/SPQRSupport/SuiteSparseQRSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/BDCSVD.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/BDCSVD_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/JacobiSVD.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/JacobiSVD_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/SVDBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/UpperBidiagonalization.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCholesky/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCholesky/SimplicialCholesky.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCholesky/SimplicialCholesky_impl.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/AmbiVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/CompressedStorage.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/ConservativeSparseSparseProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseAssign.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseBlock.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseColEtree.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseCompressedBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseCwiseBinaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseCwiseUnaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseDenseProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseDiagonalProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseDot.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseFuzzy.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseMap.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseMatrixBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparsePermutation.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseRedux.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseRef.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseSelfAdjointView.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseSolverBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseSparseProductWithPruning.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseTranspose.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseTriangularView.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseUtil.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/SparseView.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseCore/TriangularSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLUImpl.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_Memory.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_Structs.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_SupernodalMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_Utils.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_column_bmod.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_column_dfs.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_copy_to_ucol.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_heap_relax_snode.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_kernel_bmod.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_panel_bmod.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_panel_dfs.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_pivotL.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_pruneL.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseLU/SparseLU_relax_snode.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseQR/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/SparseQR/SparseQR.h create mode 100644 src/3rdparty/eigen/Eigen/src/StlSupport/StdDeque.h create mode 100644 src/3rdparty/eigen/Eigen/src/StlSupport/StdList.h create mode 100644 src/3rdparty/eigen/Eigen/src/StlSupport/StdVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/StlSupport/details.h create mode 100644 src/3rdparty/eigen/Eigen/src/SuperLUSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/SuperLUSupport/SuperLUSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/Barrier.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/CoreThreadPoolDevice.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/EventCount.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/ForkJoin.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/NonBlockingThreadPool.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/RunQueue.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/ThreadCancel.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/ThreadEnvironment.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/ThreadLocal.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/ThreadPoolInterface.h create mode 100644 src/3rdparty/eigen/Eigen/src/ThreadPool/ThreadYield.h create mode 100644 src/3rdparty/eigen/Eigen/src/UmfPackSupport/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/UmfPackSupport/UmfPackSupport.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/Image.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/InternalHeaderCheck.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/Kernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/RealSvd2x2.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/blas.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/lapacke.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/lapacke_helpers.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/lapacke_mangling.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/ArrayCwiseBinaryOps.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/ArrayCwiseUnaryOps.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/BlockMethods.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/CommonCwiseBinaryOps.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/CommonCwiseUnaryOps.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/IndexedViewMethods.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/InternalHeaderCheck.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/MatrixCwiseBinaryOps.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/MatrixCwiseUnaryOps.inc create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/ReshapedMethods.inc create mode 100644 src/3rdparty/eigen/INSTALL create mode 100644 src/3rdparty/eigen/LICENSE create mode 100644 src/3rdparty/eigen/README.md create mode 100644 src/3rdparty/eigen/REUSE.toml create mode 100644 src/3rdparty/eigen/qt_attribution.json create mode 100644 src/3rdparty/ffmpeg/LICENSE.BSD-2-Clause.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.BSD-Source-Code.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.BSL-1.0.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.IJG.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.ISC.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.LGPL-2.1-or-later.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.MIT.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.Zlib.txt create mode 100644 src/3rdparty/ffmpeg/qt_attribution.json create mode 100644 src/3rdparty/pffft/COPYRIGHTS create mode 100644 src/3rdparty/pffft/LICENSE create mode 100644 src/3rdparty/pffft/README.md create mode 100644 src/3rdparty/pffft/REUSE.toml create mode 100644 src/3rdparty/pffft/fftpack.c create mode 100644 src/3rdparty/pffft/fftpack.h create mode 100644 src/3rdparty/pffft/pffft.c create mode 100644 src/3rdparty/pffft/pffft.h create mode 100644 src/3rdparty/pffft/qt_attribution.json create mode 100644 src/3rdparty/pffft/test_pffft.c create mode 100644 src/3rdparty/resonance-audio/.travis.yml create mode 100644 src/3rdparty/resonance-audio/AUTHORS create mode 100644 src/3rdparty/resonance-audio/CMakeLists.txt create mode 100644 src/3rdparty/resonance-audio/CODEOWNERS create mode 100644 src/3rdparty/resonance-audio/CONTRIBUTING.md create mode 100644 src/3rdparty/resonance-audio/COPYRIGHTS create mode 100644 src/3rdparty/resonance-audio/LICENSE create mode 100644 src/3rdparty/resonance-audio/README.md create mode 100644 src/3rdparty/resonance-audio/REUSE.toml create mode 100755 src/3rdparty/resonance-audio/build.sh create mode 100644 src/3rdparty/resonance-audio/patches/0001-resonance-audio-avoid-c-linkage-for-ABI-factory.patch create mode 100644 src/3rdparty/resonance-audio/patches/0001-resonance-audio-namespace-loggers.patch create mode 100644 src/3rdparty/resonance-audio/patches/0001-resonance_audio-fix-C-20-build.patch create mode 100644 src/3rdparty/resonance-audio/platforms/CMakeLists.txt create mode 100644 src/3rdparty/resonance-audio/platforms/common/room_effects_utils.cc create mode 100644 src/3rdparty/resonance-audio/platforms/common/room_effects_utils.h create mode 100644 src/3rdparty/resonance-audio/platforms/common/room_effects_utils_test.cc create mode 100644 src/3rdparty/resonance-audio/platforms/common/room_properties.h create mode 100644 src/3rdparty/resonance-audio/platforms/common/utils.cc create mode 100644 src/3rdparty/resonance-audio/platforms/common/utils.h create mode 100644 src/3rdparty/resonance-audio/platforms/common/utils_test.cc create mode 100644 src/3rdparty/resonance-audio/qt_attribution.json create mode 100644 src/3rdparty/resonance-audio/resonance_audio/CMakeLists.txt create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_binaural_decoder.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_binaural_decoder.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_binaural_decoder_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_codec.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_codec_impl.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_codec_impl_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_lookup_table.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_lookup_table.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_lookup_table_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_spread_coefficients.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/associated_legendre_polynomials_generator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/associated_legendre_polynomials_generator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/associated_legendre_polynomials_generator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/foa_rotator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/foa_rotator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/foa_rotator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/stereo_from_soundfield_converter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/stereo_from_soundfield_converter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/stereo_from_soundfield_converter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/utils.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/utils_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/api/binaural_surround_renderer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/api/binaural_surround_renderer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/api/resonance_audio_api.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/api/resonance_audio_api.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/aligned_allocator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/aligned_allocator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/audio_buffer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/audio_buffer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/audio_buffer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/channel_view.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/channel_view.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/channel_view_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/constants_and_types.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/integral_types.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/logging.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/misc_math.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/misc_math.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/misc_math_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/object_transform.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/simd_macros.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/simd_utils.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/simd_utils.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/simd_utils_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/source_parameters.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/spherical_angle.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/spherical_angle.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/spherical_angle_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/unique_ptr_wrapper.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/config/global_config.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/config/source_config.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/config/source_config.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/biquad_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/biquad_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/biquad_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/channel_converter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/channel_converter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/channel_converter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/circular_buffer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/circular_buffer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/circular_buffer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/delay_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/delay_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/delay_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/distance_attenuation.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/distance_attenuation.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/distance_attenuation_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fft_manager.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fft_manager.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fft_manager_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/filter_coefficient_generators.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/filter_coefficient_generators.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/filter_coefficient_generators_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fir_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fir_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fir_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_mixer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_mixer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_mixer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_processor_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mixer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mixer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mixer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mono_pole_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mono_pole_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mono_pole_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/multi_channel_iir.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/multi_channel_iir.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/multi_channel_iir_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/near_field_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/near_field_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/occlusion_calculator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/occlusion_calculator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/occlusion_calculator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/partitioned_fft_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/partitioned_fft_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/partitioned_fft_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reflection.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reflections_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reflections_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reflections_processor_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/resampler.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/resampler.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/resampler_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reverb_onset_compensator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reverb_onset_compensator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reverb_onset_update_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reverb_onset_update_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/sh_hrir_creator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/sh_hrir_creator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/shoe_box_room.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/shoe_box_room.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/shoe_box_room_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/spectral_reverb.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/spectral_reverb.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/spectral_reverb_constants_and_tables.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/spectral_reverb_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/stereo_panner.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/stereo_panner.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/stereo_panner_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/utils.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/utils.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/utils_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_listener.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_ray.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_ray.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_ray_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_source.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_source_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/collection_kernel.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/collection_kernel.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/collection_kernel_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/estimating_rt60.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/estimating_rt60.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/estimating_rt60_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/impulse_response_computer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/impulse_response_computer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/impulse_response_computer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/mesh.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/parallel_for.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/parallel_for.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/parallel_for_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/path.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/path_tracer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/path_tracer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/path_tracer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/proxy_room_estimator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/proxy_room_estimator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/proxy_room_estimator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/reflection_kernel.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/reflection_kernel.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/reflection_kernel_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/sampling.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/scene_manager.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/scene_manager.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/scene_manager_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/sphere.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/sphere.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/sphere_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/test_util.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/test_util.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_binaural_decoder_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_binaural_decoder_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_mixing_encoder_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_mixing_encoder_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_mixing_encoder_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/binaural_surround_renderer_impl.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/binaural_surround_renderer_impl.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/binaural_surround_renderer_impl_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/buffered_source_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/buffered_source_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/foa_rotator_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/foa_rotator_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_mixer_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_mixer_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_mixer_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/graph_manager.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/graph_manager.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/graph_manager_config.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/hoa_rotator_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/hoa_rotator_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mixer_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mixer_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mixer_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mono_from_soundfield_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mono_from_soundfield_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/near_field_effect_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/near_field_effect_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/near_field_effect_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/occlusion_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/occlusion_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/occlusion_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/reflections_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/reflections_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/resonance_audio_api_impl.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/resonance_audio_api_impl.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/reverb_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/reverb_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/source_graph_config.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/source_parameters_manager.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/source_parameters_manager.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/source_parameters_manager_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/stereo_mixing_panner_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/stereo_mixing_panner_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/system_settings.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/audio_nodes_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/processing_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/processing_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/publisher_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/sink_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/sink_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/source_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/source_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/subscriber_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_crossfader.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_crossfader.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_crossfader_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_partitioner.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_partitioner.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_partitioner_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_unpartitioner.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_unpartitioner.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_unpartitioner_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/lockless_task_queue.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/lockless_task_queue.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/lockless_task_queue_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/ogg_vorbis_recorder.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/ogg_vorbis_recorder.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/planar_interleaved_conversion.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/planar_interleaved_conversion.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/planar_interleaved_conversion_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/pseudoinverse.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/pseudoinverse_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sample_type_conversion.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sample_type_conversion.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sample_type_conversion_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/semi_lockless_fifo.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sum_and_difference_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sum_and_difference_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sum_and_difference_processor_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/task_thread_pool.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/task_thread_pool.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/task_thread_pool_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/test_util.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/test_util.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/test_util_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/threadsafe_fifo.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/vorbis_stream_encoder.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/vorbis_stream_encoder.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/wav.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/wav.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/wav_reader.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/wav_reader.h create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/LICENSE create mode 100755 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/generate_hrtf_assets.py create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/generated/README create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/generated/hrtf_assets.cc create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/generated/hrtf_assets.h create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/hrtf_assets.iad create mode 100644 src/3rdparty/signalsmith-stretch/LICENSE.txt create mode 100644 src/3rdparty/signalsmith-stretch/README.md create mode 100644 src/3rdparty/signalsmith-stretch/REUSE.toml create mode 100644 src/3rdparty/signalsmith-stretch/dsp/LICENSE.txt create mode 100644 src/3rdparty/signalsmith-stretch/dsp/README.md create mode 100644 src/3rdparty/signalsmith-stretch/dsp/common.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/curves.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/delay.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/envelopes.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/fft.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/filters.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/mix.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/perf.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/rates.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/spectral.h create mode 100644 src/3rdparty/signalsmith-stretch/dsp/windows.h create mode 100644 src/3rdparty/signalsmith-stretch/qt_attribution.json create mode 100644 src/3rdparty/signalsmith-stretch/signalsmith-stretch.h create mode 100644 src/3rdparty/tlsf/0001-TLSF-move-implementation-to-QtPrivate-namespace.patch create mode 100644 src/3rdparty/tlsf/CMakeLists.txt create mode 100644 src/3rdparty/tlsf/REUSE.toml create mode 100644 src/3rdparty/tlsf/qt_attribution.json create mode 100644 src/3rdparty/tlsf/tlsf.cpp create mode 100644 src/3rdparty/tlsf/tlsf.h create mode 100644 src/CMakeLists.txt create mode 100644 src/android/CMakeLists.txt create mode 100644 src/android/jar/AndroidManifest.xml create mode 100644 src/android/jar/CMakeLists.txt create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtAndroidMediaPlayer.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtAudioDeviceManager.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtCameraListener.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtMediaRecorderListener.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtMultimediaUtils.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtSurfaceHolderCallback.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtSurfaceTextureHolder.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtSurfaceTextureListener.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/qffmpeg/CameraSettings.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/qffmpeg/QtCamera2.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/qffmpeg/QtCameraAvailabilityListener.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/qffmpeg/QtExifDataHandler.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/qffmpeg/QtScreenCaptureService.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/qffmpeg/QtScreenGrabber.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/qffmpeg/QtVideoDeviceManager.java create mode 100644 src/multimedia/CMakeLists.txt create mode 100644 src/multimedia/Qt6MultimediaMacros.cmake create mode 100644 src/multimedia/alsa/qalsaaudiodevice.cpp create mode 100644 src/multimedia/alsa/qalsaaudiodevice_p.h create mode 100644 src/multimedia/alsa/qalsaaudiodevices.cpp create mode 100644 src/multimedia/alsa/qalsaaudiodevices_p.h create mode 100644 src/multimedia/alsa/qalsaaudiosink.cpp create mode 100644 src/multimedia/alsa/qalsaaudiosink_p.h create mode 100644 src/multimedia/alsa/qalsaaudiosource.cpp create mode 100644 src/multimedia/alsa/qalsaaudiosource_p.h create mode 100644 src/multimedia/android/qaaudiostream.cpp create mode 100644 src/multimedia/android/qaaudiostream_p.h create mode 100644 src/multimedia/android/qandroidaudiodevice.cpp create mode 100644 src/multimedia/android/qandroidaudiodevice_p.h create mode 100644 src/multimedia/android/qandroidaudiodevices.cpp create mode 100644 src/multimedia/android/qandroidaudiodevices_p.h create mode 100644 src/multimedia/android/qandroidaudiojnitypes_p.h create mode 100644 src/multimedia/android/qandroidaudiosink.cpp create mode 100644 src/multimedia/android/qandroidaudiosink_p.h create mode 100644 src/multimedia/android/qandroidaudiosource.cpp create mode 100644 src/multimedia/android/qandroidaudiosource_p.h create mode 100644 src/multimedia/android/qandroidaudioutil.cpp create mode 100644 src/multimedia/android/qandroidaudioutil_p.h create mode 100644 src/multimedia/audio/q_pmr_emulation_p.h create mode 100644 src/multimedia/audio/qaudio.h create mode 100644 src/multimedia/audio/qaudio_alignment_support_p.h create mode 100644 src/multimedia/audio/qaudio_dr_wav.cpp create mode 100644 src/multimedia/audio/qaudio_platform_implementation_support_p.h create mode 100644 src/multimedia/audio/qaudio_qiodevice_support_p.h create mode 100644 src/multimedia/audio/qaudio_qspan_support_p.h create mode 100644 src/multimedia/audio/qaudio_rtsan_support_p.h create mode 100644 src/multimedia/audio/qaudiobuffer.cpp create mode 100644 src/multimedia/audio/qaudiobuffer.h create mode 100644 src/multimedia/audio/qaudiobuffer_support_p.h create mode 100644 src/multimedia/audio/qaudiobufferinput.cpp create mode 100644 src/multimedia/audio/qaudiobufferinput.h create mode 100644 src/multimedia/audio/qaudiobufferoutput.cpp create mode 100644 src/multimedia/audio/qaudiobufferoutput.h create mode 100644 src/multimedia/audio/qaudiobufferoutput_p.h create mode 100644 src/multimedia/audio/qaudiodecoder.cpp create mode 100644 src/multimedia/audio/qaudiodecoder.h create mode 100644 src/multimedia/audio/qaudiodecoder_p.h create mode 100644 src/multimedia/audio/qaudiodevice.cpp create mode 100644 src/multimedia/audio/qaudiodevice.h create mode 100644 src/multimedia/audio/qaudiodevice_p.h create mode 100644 src/multimedia/audio/qaudioformat.cpp create mode 100644 src/multimedia/audio/qaudioformat.h create mode 100644 src/multimedia/audio/qaudioformat_p.h create mode 100644 src/multimedia/audio/qaudiohelpers.cpp create mode 100644 src/multimedia/audio/qaudiohelpers_p.h create mode 100644 src/multimedia/audio/qaudioinput.cpp create mode 100644 src/multimedia/audio/qaudioinput.h create mode 100644 src/multimedia/audio/qaudiooutput.cpp create mode 100644 src/multimedia/audio/qaudiooutput.h create mode 100644 src/multimedia/audio/qaudioringbuffer_p.h create mode 100644 src/multimedia/audio/qaudiosink.cpp create mode 100644 src/multimedia/audio/qaudiosink.h create mode 100644 src/multimedia/audio/qaudiosource.cpp create mode 100644 src/multimedia/audio/qaudiosource.h create mode 100644 src/multimedia/audio/qaudiosystem.cpp create mode 100644 src/multimedia/audio/qaudiosystem_p.h create mode 100644 src/multimedia/audio/qaudiosystem_platform_stream_support.cpp create mode 100644 src/multimedia/audio/qaudiosystem_platform_stream_support_p.h create mode 100644 src/multimedia/audio/qautoresetevent_kqueue.cpp create mode 100644 src/multimedia/audio/qautoresetevent_kqueue_p.h create mode 100644 src/multimedia/audio/qautoresetevent_linux.cpp create mode 100644 src/multimedia/audio/qautoresetevent_linux_p.h create mode 100644 src/multimedia/audio/qautoresetevent_p.h create mode 100644 src/multimedia/audio/qautoresetevent_pipe.cpp create mode 100644 src/multimedia/audio/qautoresetevent_pipe_p.h create mode 100644 src/multimedia/audio/qautoresetevent_win32.cpp create mode 100644 src/multimedia/audio/qautoresetevent_win32_p.h create mode 100644 src/multimedia/audio/qmemory_resource_tlsf.cpp create mode 100644 src/multimedia/audio/qmemory_resource_tlsf_p.h create mode 100644 src/multimedia/audio/qrtaudioengine.cpp create mode 100644 src/multimedia/audio/qrtaudioengine_p.h create mode 100644 src/multimedia/audio/qsamplecache_p.cpp create mode 100644 src/multimedia/audio/qsamplecache_p.h create mode 100644 src/multimedia/audio/qsoundeffect.cpp create mode 100644 src/multimedia/audio/qsoundeffect.h create mode 100644 src/multimedia/audio/qsoundeffect_p.h create mode 100644 src/multimedia/audio/qsoundeffectsynchronous.cpp create mode 100644 src/multimedia/audio/qsoundeffectsynchronous_p.h create mode 100644 src/multimedia/audio/qsoundeffectwithplayer.cpp create mode 100644 src/multimedia/audio/qsoundeffectwithplayer_p.h create mode 100644 src/multimedia/audio/qtaudio.cpp create mode 100644 src/multimedia/audio/qtaudio.h create mode 100644 src/multimedia/audio/qwavedecoder.cpp create mode 100644 src/multimedia/audio/qwavedecoder.h create mode 100644 src/multimedia/camera/qcamera.cpp create mode 100644 src/multimedia/camera/qcamera.h create mode 100644 src/multimedia/camera/qcamera_p.h create mode 100644 src/multimedia/camera/qcameradevice.cpp create mode 100644 src/multimedia/camera/qcameradevice.h create mode 100644 src/multimedia/camera/qcameradevice_p.h create mode 100644 src/multimedia/camera/qimagecapture.cpp create mode 100644 src/multimedia/camera/qimagecapture.h create mode 100644 src/multimedia/compat/removed_api.cpp create mode 100644 src/multimedia/configure.cmake create mode 100644 src/multimedia/darwin/qavfcamerabase.mm create mode 100644 src/multimedia/darwin/qavfcamerabase_p.h create mode 100644 src/multimedia/darwin/qavfcameradebug_p.h create mode 100644 src/multimedia/darwin/qavfcamerautility.mm create mode 100644 src/multimedia/darwin/qavfcamerautility_p.h create mode 100644 src/multimedia/darwin/qavfhelpers.mm create mode 100644 src/multimedia/darwin/qavfhelpers_p.h create mode 100644 src/multimedia/darwin/qavfvideodevices.mm create mode 100644 src/multimedia/darwin/qavfvideodevices_p.h create mode 100644 src/multimedia/darwin/qcoreaudiosessionmanager.mm create mode 100644 src/multimedia/darwin/qcoreaudiosessionmanager_p.h create mode 100644 src/multimedia/darwin/qcoreaudioutils.cpp create mode 100644 src/multimedia/darwin/qcoreaudioutils_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiodevice.cpp create mode 100644 src/multimedia/darwin/qdarwinaudiodevice_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiodevices.mm create mode 100644 src/multimedia/darwin/qdarwinaudiodevices_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiosink.mm create mode 100644 src/multimedia/darwin/qdarwinaudiosink_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiosource.mm create mode 100644 src/multimedia/darwin/qdarwinaudiosource_p.h create mode 100644 src/multimedia/darwin/qdarwinintegrationfactory.mm create mode 100644 src/multimedia/darwin/qdarwinintegrationfactory_p.h create mode 100644 src/multimedia/darwin/qmacosaudiodatautils.cpp create mode 100644 src/multimedia/darwin/qmacosaudiodatautils_p.h create mode 100644 src/multimedia/doc/QtMultimediaDoc create mode 100644 src/multimedia/doc/qtmultimedia.qdocconf create mode 100644 src/multimedia/doc/snippets/CMakeLists.txt create mode 100644 src/multimedia/doc/snippets/custommediainputsnippets/CMakeLists.txt create mode 100644 src/multimedia/doc/snippets/custommediainputsnippets/custommediainputsnippets.cpp create mode 100644 src/multimedia/doc/snippets/custommediainputsnippets/custommediainputsnippets.h create mode 100644 src/multimedia/doc/snippets/custommediainputsnippets/main.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/audio.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/camera.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/devices.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/images/qt-logo.png create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/media.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/multiple-videooutputs.qml create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/qsound.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/qtvideosink.qml create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/soundeffect.qml create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/video.cpp create mode 100644 src/multimedia/doc/src/advanced-ffmpeg-configuration.qdoc create mode 100644 src/multimedia/doc/src/audiooverview.qdoc create mode 100644 src/multimedia/doc/src/backend-notes-gstreamer.qdoc create mode 100644 src/multimedia/doc/src/cameraoverview.qdoc create mode 100644 src/multimedia/doc/src/classic.css create mode 100644 src/multimedia/doc/src/cmake/cmake-variables.qdoc create mode 100644 src/multimedia/doc/src/cmake/qt_add_ios_ffmpeg_libraries.qdoc create mode 100644 src/multimedia/doc/src/images/Zoom.gif create mode 100644 src/multimedia/doc/src/images/annotatedurl.png create mode 100644 src/multimedia/doc/src/images/camera_correctionAngle_90.png create mode 100644 src/multimedia/doc/src/images/codeless.png create mode 100644 src/multimedia/doc/src/images/how-focus-works.gif create mode 100644 src/multimedia/doc/src/images/image_processing.png create mode 100644 src/multimedia/doc/src/images/noun_Media_166644.svg create mode 100644 src/multimedia/doc/src/images/qS1FmgPVL.jpg create mode 100644 src/multimedia/doc/src/images/qmlcamera-menu.png create mode 100644 src/multimedia/doc/src/images/radio-example.png create mode 100644 src/multimedia/doc/src/images/slideshow-img1.png create mode 100644 src/multimedia/doc/src/images/sound-wave-small.jpg create mode 100644 src/multimedia/doc/src/images/video-graphics-memory.png create mode 100644 src/multimedia/doc/src/includes/building-FFmpeg-configure.qdocinc create mode 100644 src/multimedia/doc/src/includes/building-FFmpeg-contents.qdocinc create mode 100644 src/multimedia/doc/src/includes/building-FFmpeg-prerequisites.qdocinc create mode 100644 src/multimedia/doc/src/includes/building-FFmpeg-source.qdocinc create mode 100644 src/multimedia/doc/src/includes/cmake-find-package-multimedia.qdocinc create mode 100644 src/multimedia/doc/src/multimedia-overview.qdoc create mode 100644 src/multimedia/doc/src/platform-notes-apple.qdoc create mode 100644 src/multimedia/doc/src/platform-notes-linux.qdoc create mode 100644 src/multimedia/doc/src/platform-notes-wasm.qdoc create mode 100644 src/multimedia/doc/src/platform-notes-windows.qdoc create mode 100644 src/multimedia/doc/src/qm-external-pages.qdoc create mode 100644 src/multimedia/doc/src/qt6-changes.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-android-linux.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-android-macos.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-android-windows.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-ios.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-linux.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-macos.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-windows.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-from-source.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-cpp.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-examples.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-ffmpeg-stubs.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-index.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-qml-types.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-toc.qdoc create mode 100644 src/multimedia/doc/src/videooverview.qdoc create mode 100644 src/multimedia/pipewire/qpipewire_async_support.cpp create mode 100644 src/multimedia/pipewire/qpipewire_async_support_p.h create mode 100644 src/multimedia/pipewire/qpipewire_audiocontextmanager.cpp create mode 100644 src/multimedia/pipewire/qpipewire_audiocontextmanager_p.h create mode 100644 src/multimedia/pipewire/qpipewire_audiodevice.cpp create mode 100644 src/multimedia/pipewire/qpipewire_audiodevice_p.h create mode 100644 src/multimedia/pipewire/qpipewire_audiodevicemonitor.cpp create mode 100644 src/multimedia/pipewire/qpipewire_audiodevicemonitor_p.h create mode 100644 src/multimedia/pipewire/qpipewire_audiodevices.cpp create mode 100644 src/multimedia/pipewire/qpipewire_audiodevices_p.h create mode 100644 src/multimedia/pipewire/qpipewire_audiosink.cpp create mode 100644 src/multimedia/pipewire/qpipewire_audiosink_p.h create mode 100644 src/multimedia/pipewire/qpipewire_audiosource.cpp create mode 100644 src/multimedia/pipewire/qpipewire_audiosource_p.h create mode 100644 src/multimedia/pipewire/qpipewire_audiostream.cpp create mode 100644 src/multimedia/pipewire/qpipewire_audiostream_p.h create mode 100644 src/multimedia/pipewire/qpipewire_instance.cpp create mode 100644 src/multimedia/pipewire/qpipewire_instance_p.h create mode 100644 src/multimedia/pipewire/qpipewire_propertydict.cpp create mode 100644 src/multimedia/pipewire/qpipewire_propertydict_p.h create mode 100644 src/multimedia/pipewire/qpipewire_registry_support.cpp create mode 100644 src/multimedia/pipewire/qpipewire_registry_support_p.h create mode 100644 src/multimedia/pipewire/qpipewire_screencapture.cpp create mode 100644 src/multimedia/pipewire/qpipewire_screencapture_p.h create mode 100644 src/multimedia/pipewire/qpipewire_screencapturehelper.cpp create mode 100644 src/multimedia/pipewire/qpipewire_screencapturehelper_p.h create mode 100644 src/multimedia/pipewire/qpipewire_spa_compat_p.h create mode 100644 src/multimedia/pipewire/qpipewire_spa_pod_parser_support_p.h create mode 100644 src/multimedia/pipewire/qpipewire_spa_pod_support.cpp create mode 100644 src/multimedia/pipewire/qpipewire_spa_pod_support_p.h create mode 100644 src/multimedia/pipewire/qpipewire_support.cpp create mode 100644 src/multimedia/pipewire/qpipewire_support_p.h create mode 100644 src/multimedia/pipewire/qpipewire_symbolloader.cpp create mode 100644 src/multimedia/pipewire/qpipewire_symbolloader_p.h create mode 100644 src/multimedia/platform/qgstreamer_platformspecificinterface.cpp create mode 100644 src/multimedia/platform/qgstreamer_platformspecificinterface_p.h create mode 100644 src/multimedia/platform/qplatformaudiobufferinput.cpp create mode 100644 src/multimedia/platform/qplatformaudiobufferinput_p.h create mode 100644 src/multimedia/platform/qplatformaudiodecoder.cpp create mode 100644 src/multimedia/platform/qplatformaudiodecoder_p.h create mode 100644 src/multimedia/platform/qplatformaudiodevices.cpp create mode 100644 src/multimedia/platform/qplatformaudiodevices_p.h create mode 100644 src/multimedia/platform/qplatformaudioinput_p.h create mode 100644 src/multimedia/platform/qplatformaudiooutput_p.h create mode 100644 src/multimedia/platform/qplatformaudioresampler_p.h create mode 100644 src/multimedia/platform/qplatformcamera.cpp create mode 100644 src/multimedia/platform/qplatformcamera_p.h create mode 100644 src/multimedia/platform/qplatformcapturablewindows_p.h create mode 100644 src/multimedia/platform/qplatformimagecapture.cpp create mode 100644 src/multimedia/platform/qplatformimagecapture_p.h create mode 100644 src/multimedia/platform/qplatformmediacapture.cpp create mode 100644 src/multimedia/platform/qplatformmediacapture_p.h create mode 100644 src/multimedia/platform/qplatformmediaformatinfo.cpp create mode 100644 src/multimedia/platform/qplatformmediaformatinfo_p.h create mode 100644 src/multimedia/platform/qplatformmediaintegration.cpp create mode 100644 src/multimedia/platform/qplatformmediaintegration_p.h create mode 100644 src/multimedia/platform/qplatformmediaplayer.cpp create mode 100644 src/multimedia/platform/qplatformmediaplayer_p.h create mode 100644 src/multimedia/platform/qplatformmediaplugin.cpp create mode 100644 src/multimedia/platform/qplatformmediaplugin_p.h create mode 100644 src/multimedia/platform/qplatformmediarecorder.cpp create mode 100644 src/multimedia/platform/qplatformmediarecorder_p.h create mode 100644 src/multimedia/platform/qplatformsurfacecapture.cpp create mode 100644 src/multimedia/platform/qplatformsurfacecapture_p.h create mode 100644 src/multimedia/platform/qplatformvideodevices.cpp create mode 100644 src/multimedia/platform/qplatformvideodevices_p.h create mode 100644 src/multimedia/platform/qplatformvideoframeinput.cpp create mode 100644 src/multimedia/platform/qplatformvideoframeinput_p.h create mode 100644 src/multimedia/platform/qplatformvideosink.cpp create mode 100644 src/multimedia/platform/qplatformvideosink_p.h create mode 100644 src/multimedia/platform/qplatformvideosource.cpp create mode 100644 src/multimedia/platform/qplatformvideosource_p.h create mode 100644 src/multimedia/playback/qmediaplayer.cpp create mode 100644 src/multimedia/playback/qmediaplayer.h create mode 100644 src/multimedia/playback/qmediaplayer_p.h create mode 100644 src/multimedia/playback/qplaybackoptions.cpp create mode 100644 src/multimedia/playback/qplaybackoptions.h create mode 100644 src/multimedia/pulseaudio/qpulseaudio_contextmanager.cpp create mode 100644 src/multimedia/pulseaudio/qpulseaudio_contextmanager_p.h create mode 100644 src/multimedia/pulseaudio/qpulseaudiodevice_p.h create mode 100644 src/multimedia/pulseaudio/qpulseaudiodevices.cpp create mode 100644 src/multimedia/pulseaudio/qpulseaudiodevices_p.h create mode 100644 src/multimedia/pulseaudio/qpulseaudiosink.cpp create mode 100644 src/multimedia/pulseaudio/qpulseaudiosink_p.h create mode 100644 src/multimedia/pulseaudio/qpulseaudiosource.cpp create mode 100644 src/multimedia/pulseaudio/qpulseaudiosource_p.h create mode 100644 src/multimedia/pulseaudio/qpulsehelpers.cpp create mode 100644 src/multimedia/pulseaudio/qpulsehelpers_p.h create mode 100644 src/multimedia/qcachedvalue_p.h create mode 100644 src/multimedia/qerrorinfo_p.h create mode 100644 src/multimedia/qmediadevices.cpp create mode 100644 src/multimedia/qmediadevices.h create mode 100644 src/multimedia/qmediaformat.cpp create mode 100644 src/multimedia/qmediaformat.h create mode 100644 src/multimedia/qmediaframeinput.cpp create mode 100644 src/multimedia/qmediaframeinput_p.h create mode 100644 src/multimedia/qmediainputencoderinterface_p.h create mode 100644 src/multimedia/qmediametadata.cpp create mode 100644 src/multimedia/qmediametadata.h create mode 100644 src/multimedia/qmediastoragelocation.cpp create mode 100644 src/multimedia/qmediastoragelocation_p.h create mode 100644 src/multimedia/qmediatimerange.cpp create mode 100644 src/multimedia/qmediatimerange.h create mode 100644 src/multimedia/qmultimedia_enum_to_string_converter_p.h create mode 100644 src/multimedia/qmultimedia_ranges_p.h create mode 100644 src/multimedia/qmultimediautils.cpp create mode 100644 src/multimedia/qmultimediautils_p.h create mode 100644 src/multimedia/qnx/qqnxaudiodevice.cpp create mode 100644 src/multimedia/qnx/qqnxaudiodevice_p.h create mode 100644 src/multimedia/qnx/qqnxaudiodevices.cpp create mode 100644 src/multimedia/qnx/qqnxaudiodevices_p.h create mode 100644 src/multimedia/qnx/qqnxaudiosink.cpp create mode 100644 src/multimedia/qnx/qqnxaudiosink_p.h create mode 100644 src/multimedia/qnx/qqnxaudiosource.cpp create mode 100644 src/multimedia/qnx/qqnxaudiosource_p.h create mode 100644 src/multimedia/qnx/qqnxaudioutils.cpp create mode 100644 src/multimedia/qnx/qqnxaudioutils_p.h create mode 100644 src/multimedia/qrhivaluemapper.cpp create mode 100644 src/multimedia/qrhivaluemapper_p.h create mode 100644 src/multimedia/qsharedhandle_p.h create mode 100644 src/multimedia/qsymbolsresolveutils.cpp create mode 100644 src/multimedia/qsymbolsresolveutils_p.h create mode 100644 src/multimedia/qt_cmdline.cmake create mode 100644 src/multimedia/qtaggedtime_p.h create mode 100644 src/multimedia/qthreadlocalrhi.cpp create mode 100644 src/multimedia/qthreadlocalrhi_p.h create mode 100644 src/multimedia/qtmultimedia_pch_p.h create mode 100644 src/multimedia/qtmultimediaglobal.h create mode 100644 src/multimedia/qtmultimediaglobal_p.h create mode 100644 src/multimedia/qvideotransformation.cpp create mode 100644 src/multimedia/qvideotransformation_p.h create mode 100644 src/multimedia/recording/qcapturablewindow.cpp create mode 100644 src/multimedia/recording/qcapturablewindow.h create mode 100644 src/multimedia/recording/qcapturablewindow_p.h create mode 100644 src/multimedia/recording/qmediacapturesession.cpp create mode 100644 src/multimedia/recording/qmediacapturesession.h create mode 100644 src/multimedia/recording/qmediacapturesession_p.h create mode 100644 src/multimedia/recording/qmediarecorder.cpp create mode 100644 src/multimedia/recording/qmediarecorder.h create mode 100644 src/multimedia/recording/qmediarecorder_p.h create mode 100644 src/multimedia/recording/qscreencapture-limitations.qdocinc create mode 100644 src/multimedia/recording/qscreencapture.cpp create mode 100644 src/multimedia/recording/qscreencapture.h create mode 100644 src/multimedia/recording/qvideoframeinput.cpp create mode 100644 src/multimedia/recording/qvideoframeinput.h create mode 100644 src/multimedia/recording/qwindowcapture-limitations.qdocinc create mode 100644 src/multimedia/recording/qwindowcapture.cpp create mode 100644 src/multimedia/recording/qwindowcapture.h create mode 100644 src/multimedia/shaders/abgr.frag create mode 100644 src/multimedia/shaders/argb.frag create mode 100644 src/multimedia/shaders/ayuv.frag create mode 100644 src/multimedia/shaders/bgra.frag create mode 100644 src/multimedia/shaders/colorconvert.glsl create mode 100644 src/multimedia/shaders/colortransfer.glsl create mode 100755 src/multimedia/shaders/compile.bat create mode 100644 src/multimedia/shaders/externalsampler.frag create mode 100644 src/multimedia/shaders/externalsampler.vert create mode 100644 src/multimedia/shaders/externalsampler_gles.frag create mode 100644 src/multimedia/shaders/hdrtonemapper.glsl create mode 100644 src/multimedia/shaders/imc2.frag create mode 100644 src/multimedia/shaders/imc4.frag create mode 100644 src/multimedia/shaders/nv12.frag create mode 100644 src/multimedia/shaders/nv12_bt2020_hlg.frag create mode 100644 src/multimedia/shaders/nv12_bt2020_pq.frag create mode 100644 src/multimedia/shaders/nv21.frag create mode 100644 src/multimedia/shaders/p016.frag create mode 100644 src/multimedia/shaders/qrhitextureformats_p.h create mode 100644 src/multimedia/shaders/rectsampler.vert create mode 100644 src/multimedia/shaders/rectsampler_bgra.frag create mode 100644 src/multimedia/shaders/rgba.frag create mode 100644 src/multimedia/shaders/texturecomponent.glsl create mode 100644 src/multimedia/shaders/uniformbuffer.glsl create mode 100644 src/multimedia/shaders/uyvy.frag create mode 100644 src/multimedia/shaders/vertex.vert create mode 100644 src/multimedia/shaders/y.frag create mode 100644 src/multimedia/shaders/y16.frag create mode 100644 src/multimedia/shaders/yuv_triplanar.frag create mode 100644 src/multimedia/shaders/yuv_triplanar_p10.frag create mode 100644 src/multimedia/shaders/yuyv.frag create mode 100644 src/multimedia/shaders/yvu_triplanar.frag create mode 100644 src/multimedia/video/qabstractvideobuffer.cpp create mode 100644 src/multimedia/video/qabstractvideobuffer.h create mode 100644 src/multimedia/video/qhwvideobuffer.cpp create mode 100644 src/multimedia/video/qhwvideobuffer_p.h create mode 100644 src/multimedia/video/qimagevideobuffer.cpp create mode 100644 src/multimedia/video/qimagevideobuffer_p.h create mode 100644 src/multimedia/video/qmemoryvideobuffer.cpp create mode 100644 src/multimedia/video/qmemoryvideobuffer_p.h create mode 100644 src/multimedia/video/qtvideo.cpp create mode 100644 src/multimedia/video/qtvideo.h create mode 100644 src/multimedia/video/qvideoframe.cpp create mode 100644 src/multimedia/video/qvideoframe.h create mode 100644 src/multimedia/video/qvideoframe_p.h create mode 100644 src/multimedia/video/qvideoframeconversionhelper.cpp create mode 100644 src/multimedia/video/qvideoframeconversionhelper_avx2.cpp create mode 100644 src/multimedia/video/qvideoframeconversionhelper_p.h create mode 100644 src/multimedia/video/qvideoframeconversionhelper_sse2.cpp create mode 100644 src/multimedia/video/qvideoframeconversionhelper_ssse3.cpp create mode 100644 src/multimedia/video/qvideoframeconverter.cpp create mode 100644 src/multimedia/video/qvideoframeconverter_p.h create mode 100644 src/multimedia/video/qvideoframeformat.cpp create mode 100644 src/multimedia/video/qvideoframeformat.h create mode 100644 src/multimedia/video/qvideoframetexturefromsource.cpp create mode 100644 src/multimedia/video/qvideoframetexturefromsource_p.h create mode 100644 src/multimedia/video/qvideoframetexturepool.cpp create mode 100644 src/multimedia/video/qvideoframetexturepool_p.h create mode 100644 src/multimedia/video/qvideooutputorientationhandler.cpp create mode 100644 src/multimedia/video/qvideooutputorientationhandler_p.h create mode 100644 src/multimedia/video/qvideosink.cpp create mode 100644 src/multimedia/video/qvideosink.h create mode 100644 src/multimedia/video/qvideotexturehelper.cpp create mode 100644 src/multimedia/video/qvideotexturehelper_p.h create mode 100644 src/multimedia/video/qvideowindow.cpp create mode 100644 src/multimedia/video/qvideowindow_p.h create mode 100644 src/multimedia/wasm/qwasmaudiodevice.cpp create mode 100644 src/multimedia/wasm/qwasmaudiodevice_p.h create mode 100644 src/multimedia/wasm/qwasmaudiosink.cpp create mode 100644 src/multimedia/wasm/qwasmaudiosink_p.h create mode 100644 src/multimedia/wasm/qwasmaudiosource.cpp create mode 100644 src/multimedia/wasm/qwasmaudiosource_p.h create mode 100644 src/multimedia/wasm/qwasmjs.cpp create mode 100644 src/multimedia/wasm/qwasmjs_p.h create mode 100644 src/multimedia/wasm/qwasmmediadevices.cpp create mode 100644 src/multimedia/wasm/qwasmmediadevices_p.h create mode 100644 src/multimedia/windows/qcomtaskresource_p.h create mode 100644 src/multimedia/windows/qwindows_propertystore.cpp create mode 100644 src/multimedia/windows/qwindows_propertystore_p.h create mode 100644 src/multimedia/windows/qwindows_scopedpropvariant_p.h create mode 100644 src/multimedia/windows/qwindows_wasapi_warmup_client.cpp create mode 100644 src/multimedia/windows/qwindows_wasapi_warmup_client_p.h create mode 100644 src/multimedia/windows/qwindowsaudiodevice.cpp create mode 100644 src/multimedia/windows/qwindowsaudiodevice_p.h create mode 100644 src/multimedia/windows/qwindowsaudiodevices.cpp create mode 100644 src/multimedia/windows/qwindowsaudiodevices_p.h create mode 100644 src/multimedia/windows/qwindowsaudiosink.cpp create mode 100644 src/multimedia/windows/qwindowsaudiosink_p.h create mode 100644 src/multimedia/windows/qwindowsaudiosource.cpp create mode 100644 src/multimedia/windows/qwindowsaudiosource_p.h create mode 100644 src/multimedia/windows/qwindowsaudioutils.cpp create mode 100644 src/multimedia/windows/qwindowsaudioutils_p.h create mode 100644 src/multimedia/windows/qwindowsmediafoundation.cpp create mode 100644 src/multimedia/windows/qwindowsmediafoundation_p.h create mode 100644 src/multimedia/windows/qwindowsmultimediautils.cpp create mode 100644 src/multimedia/windows/qwindowsmultimediautils_p.h create mode 100644 src/multimedia/windows/qwindowsresampler.cpp create mode 100644 src/multimedia/windows/qwindowsresampler_p.h create mode 100644 src/multimedia/windows/qwindowsvideodevices.cpp create mode 100644 src/multimedia/windows/qwindowsvideodevices_p.h create mode 100644 src/multimedia/windows/qwmf_support.cpp create mode 100644 src/multimedia/windows/qwmf_support_p.h create mode 100644 src/multimediaquick/CMakeLists.txt create mode 100644 src/multimediaquick/Video.qml create mode 100644 src/multimediaquick/multimedia_plugin.cpp create mode 100644 src/multimediaquick/qquickimagecapture.cpp create mode 100644 src/multimediaquick/qquickimagecapture_p.h create mode 100644 src/multimediaquick/qquickimagepreviewprovider.cpp create mode 100644 src/multimediaquick/qquickimagepreviewprovider_p.h create mode 100644 src/multimediaquick/qquickmediaplayer.cpp create mode 100644 src/multimediaquick/qquickmediaplayer_p.h create mode 100644 src/multimediaquick/qquickscreencapture.cpp create mode 100644 src/multimediaquick/qquickscreencapture_p.h create mode 100644 src/multimediaquick/qquicksoundeffect.cpp create mode 100644 src/multimediaquick/qquicksoundeffect_p.h create mode 100644 src/multimediaquick/qquickvideooutput.cpp create mode 100644 src/multimediaquick/qquickvideooutput_p.h create mode 100644 src/multimediaquick/qsgvideonode_p.cpp create mode 100644 src/multimediaquick/qsgvideonode_p.h create mode 100644 src/multimediaquick/qsgvideotexture.cpp create mode 100644 src/multimediaquick/qsgvideotexture_p.h create mode 100644 src/multimediaquick/qtmultimediaquickglobal_p.h create mode 100644 src/multimediaquick/qtmultimediaquicktypes.cpp create mode 100644 src/multimediaquick/qtmultimediaquicktypes_p.h create mode 100644 src/multimediatestlib/CMakeLists.txt create mode 100644 src/multimediatestlib/audiogenerationutils_p.h create mode 100644 src/multimediatestlib/capturesessionfixture.cpp create mode 100644 src/multimediatestlib/capturesessionfixture_p.h create mode 100644 src/multimediatestlib/formatutils.cpp create mode 100644 src/multimediatestlib/formatutils_p.h create mode 100644 src/multimediatestlib/framegenerator.cpp create mode 100644 src/multimediatestlib/framegenerator_p.h create mode 100644 src/multimediatestlib/mediabackendutils_p.h create mode 100644 src/multimediatestlib/mediafileselector_p.h create mode 100644 src/multimediatestlib/mediainfo_p.h create mode 100644 src/multimediatestlib/multimedia_debug_support_p.h create mode 100644 src/multimediatestlib/osdetection_p.h create mode 100644 src/multimediatestlib/qcolorutil.cpp create mode 100644 src/multimediatestlib/qcolorutil_p.h create mode 100644 src/multimediatestlib/qfileutil.cpp create mode 100644 src/multimediatestlib/qfileutil_p.h create mode 100644 src/multimediatestlib/qmockiodevice_p.h create mode 100644 src/multimediatestlib/qscopedenvironmentvariable_p.h create mode 100644 src/multimediatestlib/qsequentialfileadaptor_p.h create mode 100644 src/multimediatestlib/qsinewavevalidator.cpp create mode 100644 src/multimediatestlib/qsinewavevalidator_p.h create mode 100644 src/multimediatestlib/testvideosink_p.h create mode 100644 src/multimediawidgets/CMakeLists.txt create mode 100644 src/multimediawidgets/doc/snippets/multimedia-snippets/camera.cpp create mode 100644 src/multimediawidgets/doc/snippets/multimedia-snippets/video.cpp create mode 100644 src/multimediawidgets/doc/src/qtmultimediawidgets-index.qdoc create mode 100644 src/multimediawidgets/doc/src/qtmultimediawidgets.qdoc create mode 100644 src/multimediawidgets/qgraphicsvideoitem.cpp create mode 100644 src/multimediawidgets/qgraphicsvideoitem.h create mode 100644 src/multimediawidgets/qtmultimediawidgetsglobal.h create mode 100644 src/multimediawidgets/qvideowidget.cpp create mode 100644 src/multimediawidgets/qvideowidget.h create mode 100644 src/multimediawidgets/qvideowidget_p.h create mode 100644 src/plugins/CMakeLists.txt create mode 100644 src/plugins/multimedia/CMakeLists.txt create mode 100644 src/plugins/multimedia/android/CMakeLists.txt create mode 100644 src/plugins/multimedia/android/android.json create mode 100644 src/plugins/multimedia/android/audio/qandroidaudiodecoder.cpp create mode 100644 src/plugins/multimedia/android/audio/qandroidaudiodecoder_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidaudioinput.cpp create mode 100644 src/plugins/multimedia/android/common/qandroidaudioinput_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidaudiooutput_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidglobal_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidmultimediautils.cpp create mode 100644 src/plugins/multimedia/android/common/qandroidmultimediautils_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidvideooutput.cpp create mode 100644 src/plugins/multimedia/android/common/qandroidvideooutput_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidvideosink.cpp create mode 100644 src/plugins/multimedia/android/common/qandroidvideosink_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcamera.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcamera_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcamerasession.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcamerasession_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcapturesession.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcapturesession_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidimagecapture.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidimagecapture_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidmediacapturesession.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidmediacapturesession_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidmediaencoder.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidmediaencoder_p.h create mode 100644 src/plugins/multimedia/android/mediaplayer/qandroidmediaplayer.cpp create mode 100644 src/plugins/multimedia/android/mediaplayer/qandroidmediaplayer_p.h create mode 100644 src/plugins/multimedia/android/mediaplayer/qandroidmetadata.cpp create mode 100644 src/plugins/multimedia/android/mediaplayer/qandroidmetadata_p.h create mode 100644 src/plugins/multimedia/android/qandroidformatsinfo.cpp create mode 100644 src/plugins/multimedia/android/qandroidformatsinfo_p.h create mode 100644 src/plugins/multimedia/android/qandroidintegration.cpp create mode 100644 src/plugins/multimedia/android/qandroidintegration_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidcamera.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidcamera_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediametadataretriever.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediametadataretriever_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediaplayer.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediaplayer_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediarecorder.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediarecorder_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmultimediautils.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmultimediautils_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidsurfacetexture.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidsurfacetexture_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidsurfaceview.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidsurfaceview_p.h create mode 100644 src/plugins/multimedia/darwin/CMakeLists.txt create mode 100644 src/plugins/multimedia/darwin/avfaudiodecoder.mm create mode 100644 src/plugins/multimedia/darwin/avfaudiodecoder_p.h create mode 100644 src/plugins/multimedia/darwin/avfvideobuffer.mm create mode 100644 src/plugins/multimedia/darwin/avfvideobuffer_p.h create mode 100644 src/plugins/multimedia/darwin/avfvideosink.mm create mode 100644 src/plugins/multimedia/darwin/avfvideosink_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfaudiopreviewdelegate.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfaudiopreviewdelegate_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcamera.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcamera_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerarenderer.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerarenderer_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcameraservice.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcameraservice_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerasession.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerasession_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfimagecapture.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfimagecapture_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfmediaassetwriter.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfmediaassetwriter_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfmediaencoder.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfmediaencoder_p.h create mode 100644 src/plugins/multimedia/darwin/common/avfmetadata.mm create mode 100644 src/plugins/multimedia/darwin/common/avfmetadata_p.h create mode 100644 src/plugins/multimedia/darwin/darwin.json create mode 100644 src/plugins/multimedia/darwin/darwin_pch.h create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfdisplaylink.mm create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfdisplaylink_p.h create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfmediaplayer.mm create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfmediaplayer_p.h create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfvideorenderercontrol.mm create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfvideorenderercontrol_p.h create mode 100644 src/plugins/multimedia/darwin/qdarwinformatsinfo.mm create mode 100644 src/plugins/multimedia/darwin/qdarwinformatsinfo_p.h create mode 100644 src/plugins/multimedia/darwin/qdarwinintegration.mm create mode 100644 src/plugins/multimedia/darwin/qdarwinintegration_p.h create mode 100644 src/plugins/multimedia/ffmpeg/CMakeLists.txt create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidcamera.cpp create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidcamera_p.h create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidimagecapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidimagecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidscreencapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidscreencapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidvideodevices.cpp create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidvideodevices_p.h create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidvideoframebuffer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidvideoframebuffer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidvideoframefactory.cpp create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidvideoframefactory_p.h create mode 100644 src/plugins/multimedia/ffmpeg/android/qandroidvideojnitypes_p.h create mode 100644 src/plugins/multimedia/ffmpeg/android/qffmpeghwaccel_mediacodec.cpp create mode 100644 src/plugins/multimedia/ffmpeg/android/qffmpeghwaccel_mediacodec_p.h create mode 100644 src/plugins/multimedia/ffmpeg/cmake/QtAddFFmpegStubs.cmake create mode 100644 src/plugins/multimedia/ffmpeg/cmake/QtDeployFFmpeg.cmake create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfcamera.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfcamera_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfcamerarotationtracker.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfcamerarotationtracker_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfcapturephotooutputdelegate.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfcapturephotooutputdelegate_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfimagecapture.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfimagecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfsamplebufferdelegate.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfsamplebufferdelegate_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfscreencapture.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfscreencapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfstillphotonotifier.cpp create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qavfstillphotonotifier_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qcgcapturablewindows.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qcgcapturablewindows_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qcgwindowcapture.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qcgwindowcapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qcvimagevideobuffer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qcvimagevideobuffer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qffmpegdarwinhwframehelpers.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qffmpegdarwinhwframehelpers_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qffmpegdarwinintegrationfactory_p.h create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qffmpeghwaccel_videotoolbox.mm create mode 100644 src/plugins/multimedia/ffmpeg/darwin/qffmpeghwaccel_videotoolbox_p.h create mode 100644 src/plugins/multimedia/ffmpeg/ffmpeg.json create mode 100644 src/plugins/multimedia/ffmpeg/ffmpeg_pch.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegaudioframeconverter.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegaudioframeconverter_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegaudiorenderer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegaudiorenderer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegcodeccontext.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegcodeccontext_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegdemuxer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegdemuxer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegframe_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegmediadataholder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegmediadataholder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegpacket_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegplaybackenginedefs_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegplaybackengineobject.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegplaybackengineobject_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegplaybackutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegrenderer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegrenderer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegstreamdecoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegstreamdecoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegsubtitlerenderer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegsubtitlerenderer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegtime_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegtimecontroller.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegtimecontroller_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegvideorenderer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegvideorenderer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qeglfsscreencapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qeglfsscreencapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeg.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeg_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegaudiodecoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegaudiodecoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegaudioinput.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegaudioinput_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegavaudioformat.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegavaudioformat_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegcodec.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegcodec_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegcodecstorage.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegcodecstorage_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegconverter.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegconverter_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegdefs_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegencodingformatcontext.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegencodingformatcontext_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_d3d11.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_d3d11_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_vaapi.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_vaapi_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegimagecapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegimagecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegioutils.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegioutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediacapturesession.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediacapturesession_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaformatinfo.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaformatinfo_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaintegration.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaintegration_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediametadata.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediametadata_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaplayer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaplayer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediarecorder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediarecorder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegplaybackengine.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegplaybackengine_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegplugin.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegresampler.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegresampler_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegscreencapture_dxgi.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegscreencapture_dxgi_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegsurfacecapturegrabber.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegsurfacecapturegrabber_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegtextureconverter.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegtextureconverter_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegthread.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegthread_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegvideobuffer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegvideobuffer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegvideosink.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegvideosink_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegwindowcapture_uwp.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegwindowcapture_uwp_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qgdiwindowcapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qgdiwindowcapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qgrabwindowsurfacecapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qgrabwindowsurfacecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qopenglvideobuffer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qopenglvideobuffer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2camera.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2camera_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2cameradevices.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2cameradevices_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2filedescriptor.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2filedescriptor_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2memorytransfer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2memorytransfer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qwincapturablewindows.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qwincapturablewindows_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qwindowscamera.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qwindowscamera_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qx11capturablewindows.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qx11capturablewindows_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qx11surfacecapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qx11surfacecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegaudioencoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegaudioencoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegaudioencoderutils.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegaudioencoderutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencoderoptions.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencoderoptions_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencoderthread.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencoderthread_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencodinginitializer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencodinginitializer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegmuxer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegmuxer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegrecordingengine.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegrecordingengine_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegrecordingengineutils.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegrecordingengineutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoencoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoencoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoencoderutils.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoencoderutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoframeencoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoframeencoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/openssl3.ver create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-crypto.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-ssl.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-va-drm.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-va-x11.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-va.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/va.ver create mode 100644 src/plugins/multimedia/gstreamer/CMakeLists.txt create mode 100644 src/plugins/multimedia/gstreamer/audio/qgstreameraudiodecoder.cpp create mode 100644 src/plugins/multimedia/gstreamer/audio/qgstreameraudiodecoder_p.h create mode 100644 src/plugins/multimedia/gstreamer/audio/qgstreameraudiodevice.cpp create mode 100644 src/plugins/multimedia/gstreamer/audio/qgstreameraudiodevice_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qglist_helper_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_bus_observer.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_bus_observer_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_debug.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_debug_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_discoverer.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_discoverer_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_handle_types_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_play.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_play_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstpipeline.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstpipeline_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameraudioinput.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameraudioinput_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameraudiooutput.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameraudiooutput_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamerbufferprobe.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamerbufferprobe_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameregldisplay.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameregldisplay_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermediaplayer.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermediaplayer_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermessage_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermetadata.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermetadata_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamervideooutput.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamervideooutput_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamervideosink.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamervideosink_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstsubtitlesink.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstsubtitlesink_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstutils.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstutils_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstvideobuffer.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstvideobuffer_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstvideorenderersink.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstvideorenderersink_p.h create mode 100644 src/plugins/multimedia/gstreamer/gstreamer.json create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamercamera.cpp create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamercamera_p.h create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamerimagecapture.cpp create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamerimagecapture_p.h create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamermediacapturesession.cpp create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamermediacapturesession_p.h create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamermediarecorder.cpp create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamermediarecorder_p.h create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerformatinfo.cpp create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerformatinfo_p.h create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerintegration.cpp create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerintegration_p.h create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerplugin.cpp create mode 100644 src/plugins/multimedia/gstreamer/qgstreamervideodevices.cpp create mode 100644 src/plugins/multimedia/gstreamer/qgstreamervideodevices_p.h create mode 100644 src/plugins/multimedia/gstreamer/uri_handler/qgstreamer_qiodevice_handler.cpp create mode 100644 src/plugins/multimedia/gstreamer/uri_handler/qgstreamer_qiodevice_handler_p.h create mode 100644 src/plugins/multimedia/gstreamer/uri_handler/qgstreamer_qrc_handler.cpp create mode 100644 src/plugins/multimedia/gstreamer/uri_handler/qgstreamer_qrc_handler_p.h create mode 100644 src/plugins/multimedia/qnx/CMakeLists.txt create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcamera.cpp create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcamera_p.h create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcameraframebuffer.cpp create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcameraframebuffer_p.h create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcamerahandle_p.h create mode 100644 src/plugins/multimedia/qnx/camera/qqnximagecapture.cpp create mode 100644 src/plugins/multimedia/qnx/camera/qqnximagecapture_p.h create mode 100644 src/plugins/multimedia/qnx/camera/qqnxplatformcamera.cpp create mode 100644 src/plugins/multimedia/qnx/camera/qqnxplatformcamera_p.h create mode 100644 src/plugins/multimedia/qnx/capture/qqnxaudiorecorder.cpp create mode 100644 src/plugins/multimedia/qnx/capture/qqnxaudiorecorder_p.h create mode 100644 src/plugins/multimedia/qnx/capture/qqnxmediacapturesession.cpp create mode 100644 src/plugins/multimedia/qnx/capture/qqnxmediacapturesession_p.h create mode 100644 src/plugins/multimedia/qnx/capture/qqnxmediarecorder.cpp create mode 100644 src/plugins/multimedia/qnx/capture/qqnxmediarecorder_p.h create mode 100644 src/plugins/multimedia/qnx/common/mmrenderertypes.h create mode 100644 src/plugins/multimedia/qnx/common/qqnxaudioinput.cpp create mode 100644 src/plugins/multimedia/qnx/common/qqnxaudioinput_p.h create mode 100644 src/plugins/multimedia/qnx/common/qqnxaudiooutput.cpp create mode 100644 src/plugins/multimedia/qnx/common/qqnxaudiooutput_p.h create mode 100644 src/plugins/multimedia/qnx/common/qqnxmediaeventthread.cpp create mode 100644 src/plugins/multimedia/qnx/common/qqnxmediaeventthread_p.h create mode 100644 src/plugins/multimedia/qnx/common/qqnxwindowgrabber.cpp create mode 100644 src/plugins/multimedia/qnx/common/qqnxwindowgrabber_p.h create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediametadata.cpp create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediametadata_p.h create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediaplayer.cpp create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediaplayer_p.h create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediautil.cpp create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediautil_p.h create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxvideosink.cpp create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxvideosink_p.h create mode 100644 src/plugins/multimedia/qnx/qnx.json create mode 100644 src/plugins/multimedia/qnx/qqnxformatinfo.cpp create mode 100644 src/plugins/multimedia/qnx/qqnxformatinfo_p.h create mode 100644 src/plugins/multimedia/qnx/qqnxmediaintegration.cpp create mode 100644 src/plugins/multimedia/qnx/qqnxmediaintegration_p.h create mode 100644 src/plugins/multimedia/qnx/qqnxvideodevices.cpp create mode 100644 src/plugins/multimedia/qnx/qqnxvideodevices_p.h create mode 100644 src/plugins/multimedia/wasm/CMakeLists.txt create mode 100644 src/plugins/multimedia/wasm/common/qwasmaudioinput.cpp create mode 100644 src/plugins/multimedia/wasm/common/qwasmaudioinput_p.h create mode 100644 src/plugins/multimedia/wasm/common/qwasmaudiooutput.cpp create mode 100644 src/plugins/multimedia/wasm/common/qwasmaudiooutput_p.h create mode 100644 src/plugins/multimedia/wasm/common/qwasmvideooutput.cpp create mode 100644 src/plugins/multimedia/wasm/common/qwasmvideooutput_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmcamera.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmcamera_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmcapturablewindows.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmcapturablewindows_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmimagecapture.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmimagecapture_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmmediacapturesession.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmmediacapturesession_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmmediarecorder.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmmediarecorder_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmscreencapture.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmscreencapture_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmwindowcapture.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmwindowcapture_p.h create mode 100644 src/plugins/multimedia/wasm/mediaplayer/qwasmmediaplayer.cpp create mode 100644 src/plugins/multimedia/wasm/mediaplayer/qwasmmediaplayer_p.h create mode 100644 src/plugins/multimedia/wasm/mediaplayer/qwasmvideosink.cpp create mode 100644 src/plugins/multimedia/wasm/mediaplayer/qwasmvideosink_p.h create mode 100644 src/plugins/multimedia/wasm/qwasmmediaintegration.cpp create mode 100644 src/plugins/multimedia/wasm/qwasmmediaintegration_p.h create mode 100644 src/plugins/multimedia/wasm/wasm.json create mode 100644 src/plugins/multimedia/windows/CMakeLists.txt create mode 100644 src/plugins/multimedia/windows/common/mfmetadata.cpp create mode 100644 src/plugins/multimedia/windows/common/mfmetadata_p.h create mode 100644 src/plugins/multimedia/windows/decoder/mfaudiodecodercontrol.cpp create mode 100644 src/plugins/multimedia/windows/decoder/mfaudiodecodercontrol_p.h create mode 100644 src/plugins/multimedia/windows/decoder/mfdecodersourcereader.cpp create mode 100644 src/plugins/multimedia/windows/decoder/mfdecodersourcereader_p.h create mode 100644 src/plugins/multimedia/windows/decoder/mfdecodersourcereadercallback.cpp create mode 100644 src/plugins/multimedia/windows/decoder/mfdecodersourcereadercallback_p.h create mode 100644 src/plugins/multimedia/windows/evr/evrcustompresenter.cpp create mode 100644 src/plugins/multimedia/windows/evr/evrcustompresenter_p.h create mode 100644 src/plugins/multimedia/windows/evr/evrd3dpresentengine.cpp create mode 100644 src/plugins/multimedia/windows/evr/evrd3dpresentengine_p.h create mode 100644 src/plugins/multimedia/windows/evr/evrhelpers.cpp create mode 100644 src/plugins/multimedia/windows/evr/evrhelpers_p.h create mode 100644 src/plugins/multimedia/windows/evr/evrvideowindowcontrol.cpp create mode 100644 src/plugins/multimedia/windows/evr/evrvideowindowcontrol_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowscamera.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowscamera_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsimagecapture.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsimagecapture_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediacapture.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediacapture_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediadevicereader.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediadevicereader_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediadevicesession.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediadevicesession_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediaencoder.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediaencoder_p.h create mode 100644 src/plugins/multimedia/windows/mfstream.cpp create mode 100644 src/plugins/multimedia/windows/mfstream_p.h create mode 100644 src/plugins/multimedia/windows/player/mfactivate.cpp create mode 100644 src/plugins/multimedia/windows/player/mfactivate_p.h create mode 100644 src/plugins/multimedia/windows/player/mfevrvideowindowcontrol.cpp create mode 100644 src/plugins/multimedia/windows/player/mfevrvideowindowcontrol_p.h create mode 100644 src/plugins/multimedia/windows/player/mfplayercontrol.cpp create mode 100644 src/plugins/multimedia/windows/player/mfplayercontrol_p.h create mode 100644 src/plugins/multimedia/windows/player/mfplayersession.cpp create mode 100644 src/plugins/multimedia/windows/player/mfplayersession_p.h create mode 100644 src/plugins/multimedia/windows/player/mfvideorenderercontrol.cpp create mode 100644 src/plugins/multimedia/windows/player/mfvideorenderercontrol_p.h create mode 100644 src/plugins/multimedia/windows/qwindowsformatinfo.cpp create mode 100644 src/plugins/multimedia/windows/qwindowsformatinfo_p.h create mode 100644 src/plugins/multimedia/windows/qwindowsintegration.cpp create mode 100644 src/plugins/multimedia/windows/qwindowsintegration_p.h create mode 100644 src/plugins/multimedia/windows/sourceresolver.cpp create mode 100644 src/plugins/multimedia/windows/sourceresolver_p.h create mode 100644 src/plugins/multimedia/windows/windows.json create mode 100644 src/resonance-audio/CMakeLists.txt create mode 100644 src/resonance-audio/resonance_audio.cpp create mode 100644 src/resonance-audio/resonance_audio.h create mode 100644 src/spatialaudio/CMakeLists.txt create mode 100644 src/spatialaudio/doc/qtspatialaudio.qdocconf create mode 100644 src/spatialaudio/doc/src/qtspatialaudio-cpp.qdoc create mode 100644 src/spatialaudio/doc/src/qtspatialaudio-examples.qdoc create mode 100644 src/spatialaudio/doc/src/qtspatialaudio-index.qdoc create mode 100644 src/spatialaudio/doc/src/qtspatialaudio-qml-types.qdoc create mode 100644 src/spatialaudio/doc/src/spatialaudiooverview.qdoc create mode 100644 src/spatialaudio/qambientsound.cpp create mode 100644 src/spatialaudio/qambientsound.h create mode 100644 src/spatialaudio/qambientsound_p.h create mode 100644 src/spatialaudio/qambisonicdecoder.cpp create mode 100644 src/spatialaudio/qambisonicdecoder_p.h create mode 100644 src/spatialaudio/qambisonicdecoderdata_p.h create mode 100644 src/spatialaudio/qaudioengine.cpp create mode 100644 src/spatialaudio/qaudioengine.h create mode 100644 src/spatialaudio/qaudioengine_p.h create mode 100644 src/spatialaudio/qaudioengine_threaded.cpp create mode 100644 src/spatialaudio/qaudioengine_threaded_p.h create mode 100644 src/spatialaudio/qaudiolistener.cpp create mode 100644 src/spatialaudio/qaudiolistener.h create mode 100644 src/spatialaudio/qaudioroom.cpp create mode 100644 src/spatialaudio/qaudioroom.h create mode 100644 src/spatialaudio/qaudioroom_p.h create mode 100644 src/spatialaudio/qspatialsound.cpp create mode 100644 src/spatialaudio/qspatialsound.h create mode 100644 src/spatialaudio/qspatialsound_p.h create mode 100644 src/spatialaudio/qtspatialaudioglobal.h create mode 100644 src/spatialaudio/qtspatialaudioglobal_p.h create mode 100644 src/spatialaudioquick3d/CMakeLists.txt create mode 100644 src/spatialaudioquick3d/qquick3dambientsound.cpp create mode 100644 src/spatialaudioquick3d/qquick3dambientsound_p.h create mode 100644 src/spatialaudioquick3d/qquick3daudio-qml-types.qdoc create mode 100644 src/spatialaudioquick3d/qquick3daudioengine.cpp create mode 100644 src/spatialaudioquick3d/qquick3daudioengine_p.h create mode 100644 src/spatialaudioquick3d/qquick3daudiolistener.cpp create mode 100644 src/spatialaudioquick3d/qquick3daudiolistener_p.h create mode 100644 src/spatialaudioquick3d/qquick3daudioroom.cpp create mode 100644 src/spatialaudioquick3d/qquick3daudioroom_p.h create mode 100644 src/spatialaudioquick3d/qquick3dspatialaudio_plugin.cpp create mode 100644 src/spatialaudioquick3d/qquick3dspatialsound.cpp create mode 100644 src/spatialaudioquick3d/qquick3dspatialsound_p.h create mode 100644 src/spatialaudioquick3d/qtquick3daudioglobal_p.h create mode 100644 src/spatialaudioquick3d/qtquick3daudiotypes_p.h create mode 100644 tests/CMakeLists.txt create mode 100644 tests/auto/CMakeLists.txt create mode 100644 tests/auto/cmake/CMakeLists.txt create mode 100644 tests/auto/integration/CMakeLists.txt create mode 100644 tests/auto/integration/backends/CMakeLists.txt create mode 100644 tests/auto/integration/backends/tst_backends.cpp create mode 100644 tests/auto/integration/multiapp/CMakeLists.txt create mode 100644 tests/auto/integration/multiapp/double-drop.wav create mode 100644 tests/auto/integration/multiapp/tst_multiapp.cpp create mode 100644 tests/auto/integration/qaudiodecoderbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qaudiodecoderbackend/testdata/test-corrupted.wav create mode 100644 tests/auto/integration/qaudiodecoderbackend/testdata/test-no-audio-track.mp4 create mode 100644 tests/auto/integration/qaudiodecoderbackend/testdata/test-unsupported.avi create mode 100644 tests/auto/integration/qaudiodecoderbackend/testdata/test.wav create mode 100644 tests/auto/integration/qaudiodecoderbackend/tst_qaudiodecoderbackend.cpp create mode 100644 tests/auto/integration/qaudiodevicebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qaudiodevicebackend/tst_qaudiodevicebackend.cpp create mode 100644 tests/auto/integration/qaudiosink/CMakeLists.txt create mode 100644 tests/auto/integration/qaudiosink/tst_qaudiosink.cpp create mode 100644 tests/auto/integration/qaudiosource/CMakeLists.txt create mode 100644 tests/auto/integration/qaudiosource/Info.plist create mode 100644 tests/auto/integration/qaudiosource/tst_qaudiosource.cpp create mode 100644 tests/auto/integration/qcamerabackend/BLACKLIST create mode 100644 tests/auto/integration/qcamerabackend/CMakeLists.txt create mode 100644 tests/auto/integration/qcamerabackend/Info.plist create mode 100644 tests/auto/integration/qcamerabackend/tst_qcamerabackend.cpp create mode 100644 tests/auto/integration/qmediacapturesession/BLACKLIST create mode 100644 tests/auto/integration/qmediacapturesession/CMakeLists.txt create mode 100644 tests/auto/integration/qmediacapturesession/Info.plist create mode 100644 tests/auto/integration/qmediacapturesession/tst_qmediacapturesession.cpp create mode 100644 tests/auto/integration/qmediaformatbackend/BLACKLIST create mode 100644 tests/auto/integration/qmediaformatbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaformatbackend/tst_qmediaformatbackend.cpp create mode 100644 tests/auto/integration/qmediaframeinputsbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaframeinputsbackend/tst_qmediaframeinputsbackend.cpp create mode 100644 tests/auto/integration/qmediaframeinputsbackend/tst_qmediaframeinputsbackend.h create mode 100644 tests/auto/integration/qmediaplayer_concurrent/3colors_with_sound_1s.mp4 create mode 100644 tests/auto/integration/qmediaplayer_concurrent/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaplayer_concurrent/tst_qmediaplayer_concurrent.cpp create mode 100644 tests/auto/integration/qmediaplayerbackend/BLACKLIST create mode 100644 tests/auto/integration/qmediaplayerbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaplayerbackend/LazyLoad.qml create mode 100644 tests/auto/integration/qmediaplayerbackend/fake.h create mode 100644 tests/auto/integration/qmediaplayerbackend/fixture.h create mode 100644 tests/auto/integration/qmediaplayerbackend/mediaplayerstate.h create mode 100644 tests/auto/integration/qmediaplayerbackend/server.h create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/15s.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/3colors_with_sound_1s.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/BigBuckBunny.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/_test.wav create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/audio_video_with_jpg_thumbnail.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/audio_video_with_png_thumbnail.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/busAv1.webm create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/busMpeg4.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_180_deg_clockwise.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_180_deg_clockwise_mirrored.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_270_deg_clockwise.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_270_deg_clockwise_mirrored.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_90_deg_clockwise.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_90_deg_clockwise_mirrored.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_mirrored.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/colors.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/colors.ogv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/corrupt_end.ogg create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/duration_issues.webm create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/h264_avc1_yuv420p10le_tv_bt2020.mov create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/invalid_media.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/invalid_media2.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/multitrack-subtitle-start-at-zero.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/multitrack.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/nested1.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/nested2.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/nokia-tune.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/nokia-tune.mp3 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/one_red_frame.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/par_2_3.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/par_3_2.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/recursive.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/recursive_master.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/sample.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/subtitletest.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/test.wav create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/with_creation_time.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/with_date.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/with_date_and_creation_time.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/with_qtdate_and_creation_time.mov create mode 100644 tests/auto/integration/qmediaplayerbackend/tst_qmediaplayerbackend.cpp create mode 100644 tests/auto/integration/qmediaplayerformatsupport/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/README.md create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.avi create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.mkv create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.mpeg create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.wmv create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/unsupported/container.webp create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/flipable.gif create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_bgr0.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_bgr24.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_gray.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_gray10le.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_nv12.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_nv16.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_nv21.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_rgb24.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv420p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv420p10.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv420p10le.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv422p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv422p10.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv422p10le.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv444p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv444p10.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuvj420p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuvj422p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuvj444p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/tst_qmediaplayerformatsupport.cpp create mode 100644 tests/auto/integration/qmediarecorderbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qmediarecorderbackend/tst_qmediarecorderbackend.cpp create mode 100644 tests/auto/integration/qml/CMakeLists.txt create mode 100644 tests/auto/integration/qml/mediaplayer/tst_mediaplayer.qml create mode 100644 tests/auto/integration/qml/playbackoptions/tst_playbackoptions.qml create mode 100644 tests/auto/integration/qml/soundeffect/tst_soundeffect.qml create mode 100644 tests/auto/integration/qml/tst_qml.cpp create mode 100644 tests/auto/integration/qquickscreencapturebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qquickscreencapturebackend/tst_qquickscreencapturebackend.cpp create mode 100644 tests/auto/integration/qquickvideooutput/CMakeLists.txt create mode 100644 tests/auto/integration/qquickvideooutput/main.qml create mode 100644 tests/auto/integration/qquickvideooutput/tst_qquickvideooutput.cpp create mode 100644 tests/auto/integration/qquickvideooutput_window/CMakeLists.txt create mode 100644 tests/auto/integration/qquickvideooutput_window/main.qml create mode 100644 tests/auto/integration/qquickvideooutput_window/tst_qquickvideooutput_window.cpp create mode 100644 tests/auto/integration/qrtaudioengine/CMakeLists.txt create mode 100644 tests/auto/integration/qrtaudioengine/tst_qrtaudioengine.cpp create mode 100644 tests/auto/integration/qscreencapturebackend/BLACKLIST create mode 100644 tests/auto/integration/qscreencapturebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qscreencapturebackend/android/AndroidManifest.xml create mode 100644 tests/auto/integration/qscreencapturebackend/tst_qscreencapturebackend.cpp create mode 100644 tests/auto/integration/qsoundeffect/CMakeLists.txt create mode 100644 tests/auto/integration/qsoundeffect/test.wav create mode 100644 tests/auto/integration/qsoundeffect/test_corrupted.wav create mode 100644 tests/auto/integration/qsoundeffect/test_tone.wav create mode 100644 tests/auto/integration/qsoundeffect/tst_qsoundeffect.cpp create mode 100644 tests/auto/integration/qsoundeffect_concurrent/CMakeLists.txt create mode 100644 tests/auto/integration/qsoundeffect_concurrent/double-drop.wav create mode 100644 tests/auto/integration/qsoundeffect_concurrent/tst_qsoundeffect_concurrent.cpp create mode 100644 tests/auto/integration/qspatialaudio/CMakeLists.txt create mode 100644 tests/auto/integration/qspatialaudio/test.wav create mode 100644 tests/auto/integration/qspatialaudio/tst_qspatialaudio.cpp create mode 100644 tests/auto/integration/qvideoframebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qvideoframebackend/testdata/colors.mp4 create mode 100644 tests/auto/integration/qvideoframebackend/testdata/one_red_frame.mp4 create mode 100644 tests/auto/integration/qvideoframebackend/tst_qvideoframebackend.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/BLACKLIST create mode 100644 tests/auto/integration/qwindowcapturebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qwindowcapturebackend/fixture.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/fixture.h create mode 100644 tests/auto/integration/qwindowcapturebackend/grabber.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/grabber.h create mode 100644 tests/auto/integration/qwindowcapturebackend/tst_qwindowcapturebackend.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/widget.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/widget.h create mode 100644 tests/auto/integration/spatialaudio_qml/CMakeLists.txt create mode 100644 tests/auto/integration/spatialaudio_qml/qml/test.wav create mode 100644 tests/auto/integration/spatialaudio_qml/qml/tst_ambientsound.qml create mode 100644 tests/auto/integration/spatialaudio_qml/qml/tst_audioengine.qml create mode 100644 tests/auto/integration/spatialaudio_qml/qml/tst_audiolistener.qml create mode 100644 tests/auto/integration/spatialaudio_qml/qml/tst_audioroom.qml create mode 100644 tests/auto/integration/spatialaudio_qml/qml/tst_spatialsound.qml create mode 100644 tests/auto/integration/spatialaudio_qml/tst_qml.cpp create mode 100644 tests/auto/integration/static_linking/CMakeLists.txt create mode 100644 tests/auto/integration/static_linking/tst_multimedia_static_linking.cpp create mode 100755 tests/auto/runautotests.py create mode 100644 tests/auto/unit/CMakeLists.txt create mode 100644 tests/auto/unit/mockbackend/CMakeLists.txt create mode 100644 tests/auto/unit/mockbackend/mock.json create mode 100644 tests/auto/unit/mockbackend/qmockaudiodecoder.cpp create mode 100644 tests/auto/unit/mockbackend/qmockaudiodecoder.h create mode 100644 tests/auto/unit/mockbackend/qmockaudiodevices.cpp create mode 100644 tests/auto/unit/mockbackend/qmockaudiodevices.h create mode 100644 tests/auto/unit/mockbackend/qmockaudiooutput.h create mode 100644 tests/auto/unit/mockbackend/qmockcamera.cpp create mode 100644 tests/auto/unit/mockbackend/qmockcamera.h create mode 100644 tests/auto/unit/mockbackend/qmockimagecapture.cpp create mode 100644 tests/auto/unit/mockbackend/qmockimagecapture.h create mode 100644 tests/auto/unit/mockbackend/qmockintegration.cpp create mode 100644 tests/auto/unit/mockbackend/qmockintegration.h create mode 100644 tests/auto/unit/mockbackend/qmockmediacapturesession.h create mode 100644 tests/auto/unit/mockbackend/qmockmediaencoder.h create mode 100644 tests/auto/unit/mockbackend/qmockmediaplayer.h create mode 100644 tests/auto/unit/mockbackend/qmocksurfacecapture.h create mode 100644 tests/auto/unit/mockbackend/qmockvideobuffer.h create mode 100644 tests/auto/unit/mockbackend/qmockvideodevices.cpp create mode 100644 tests/auto/unit/mockbackend/qmockvideodevices.h create mode 100644 tests/auto/unit/mockbackend/qmockvideosink.h create mode 100644 tests/auto/unit/multimedia/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qabstractvideobuffer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qabstractvideobuffer/tst_qabstractvideobuffer.cpp create mode 100644 tests/auto/unit/multimedia/qaudiobuffer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiobuffer/tst_qaudiobuffer.cpp create mode 100644 tests/auto/unit/multimedia/qaudiodecoder/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiodecoder/tst_qaudiodecoder.cpp create mode 100644 tests/auto/unit/multimedia/qaudiodevice/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiodevice/tst_qaudiodevice.cpp create mode 100644 tests/auto/unit/multimedia/qaudioformat/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudioformat/tst_qaudioformat.cpp create mode 100644 tests/auto/unit/multimedia/qaudiohelpers/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiohelpers/tst_qaudiohelpers.cpp create mode 100644 tests/auto/unit/multimedia/qaudionamespace/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudionamespace/tst_qaudionamespace.cpp create mode 100644 tests/auto/unit/multimedia/qaudiorecorder/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiorecorder/tst_qaudiorecorder.cpp create mode 100644 tests/auto/unit/multimedia/qaudioringbuffer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudioringbuffer/tst_qaudioringbuffer.cpp create mode 100644 tests/auto/unit/multimedia/qautoresetevent/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qautoresetevent/tst_qautoresetevent.cpp create mode 100644 tests/auto/unit/multimedia/qcamera/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qcamera/tst_qcamera.cpp create mode 100644 tests/auto/unit/multimedia/qcameradevice/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qcameradevice/tst_qcameradevice.cpp create mode 100644 tests/auto/unit/multimedia/qerrorinfo/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qerrorinfo/tst_qerrorinfo.cpp create mode 100644 tests/auto/unit/multimedia/qimagecapture/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qimagecapture/tst_qimagecapture.cpp create mode 100644 tests/auto/unit/multimedia/qmediadevices/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediadevices/tst_qmediadevices.cpp create mode 100644 tests/auto/unit/multimedia/qmediaformat/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediaformat/tst_qmediaformat.cpp create mode 100644 tests/auto/unit/multimedia/qmediametadata/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediametadata/tst_qmediametadata.cpp create mode 100644 tests/auto/unit/multimedia/qmediaplayer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediaplayer/testdata/nokia-tune.mp3 create mode 100644 tests/auto/unit/multimedia/qmediaplayer/tst_qmediaplayer.cpp create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/empty.pls create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/test.m3u create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/test.pls create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/testfile create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/testfile2#suffix create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/totem-pl-example.pls create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/tst_qmediaplaylist.cpp create mode 100644 tests/auto/unit/multimedia/qmediarecorder/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediarecorder/tst_qmediarecorder.cpp create mode 100644 tests/auto/unit/multimedia/qmediastoragelocation/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediastoragelocation/tst_qmediastoragelocation.cpp create mode 100644 tests/auto/unit/multimedia/qmediatimerange/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediatimerange/tst_qmediatimerange.cpp create mode 100644 tests/auto/unit/multimedia/qmultimediautils/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmultimediautils/tst_qmultimediautils.cpp create mode 100644 tests/auto/unit/multimedia/qplaybackoptions/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qplaybackoptions/tst_qplaybackoptions.cpp create mode 100644 tests/auto/unit/multimedia/qrhivaluemapper/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qrhivaluemapper/tst_qrhivaluemapper.cpp create mode 100644 tests/auto/unit/multimedia/qsamplecache/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qsamplecache/testdata/corrupted.wav create mode 100644 tests/auto/unit/multimedia/qsamplecache/testdata/drwav_heap-buffer-overflow.wav create mode 100644 tests/auto/unit/multimedia/qsamplecache/testdata/drwav_integer-underflow.wav create mode 100644 tests/auto/unit/multimedia/qsamplecache/testdata/test.wav create mode 100644 tests/auto/unit/multimedia/qsamplecache/testdata/test2.wav create mode 100644 tests/auto/unit/multimedia/qsamplecache/tst_qsamplecache.cpp create mode 100644 tests/auto/unit/multimedia/qscreencapture/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qscreencapture/tst_qscreencapture.cpp create mode 100644 tests/auto/unit/multimedia/qsharedhandle/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qsharedhandle/tst_qsharedhandle.cpp create mode 100644 tests/auto/unit/multimedia/qvideobuffers/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideobuffers/tst_qvideobuffers.cpp create mode 100644 tests/auto/unit/multimedia/qvideoframe/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideoframe/tst_qvideoframe.cpp create mode 100644 tests/auto/unit/multimedia/qvideoframe/umbrellas.jpg create mode 100644 tests/auto/unit/multimedia/qvideoframe_nogui/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideoframe_nogui/tst_qvideoframe_nogui.cpp create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/BLACKLIST create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/tst_qvideoframecolormanagement.cpp create mode 100644 tests/auto/unit/multimedia/qvideoframeformat/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideoframeformat/tst_qvideoframeformat.cpp create mode 100644 tests/auto/unit/multimedia/qvideotexturehelper/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideotexturehelper/tst_qvideotexturehelper.cpp create mode 100644 tests/auto/unit/multimedia/qvideotransformation/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideotransformation/tst_qvideotransformation.cpp create mode 100644 tests/auto/unit/multimedia/qwavedecoder/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/corrupt_datadesc_1_16_8000.le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/corrupt_fmtdesc_1_16_8000.le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/corrupt_fmtstring_1_16_8000.le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/empty.wav create mode 100755 tests/auto/unit/multimedia/qwavedecoder/data/gendata.sh create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_16_44100_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_16_44100_le_2.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_16_8000_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_24_44100_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_24_8000_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_32_44100_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_32_8000_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_8_44100.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_8_8000.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_8_8000_even_bext.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_8_8000_odd_bext.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_f32_44100_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_f32_8000_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_16_44100_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_16_8000_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_24_44100_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_24_8000_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_32_44100_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_32_8000_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_8_44100.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_8_8000.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_f32_44100_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_f32_8000_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/nosampledata.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/notawav.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/onebyte.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/tst_qwavedecoder.cpp create mode 100644 tests/auto/unit/multimedia/qwindowsresampler/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qwindowsresampler/tst_qwindowsresampler.cpp create mode 100644 tests/auto/unit/multimediawidgets/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qcamerawidgets/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qcamerawidgets/tst_qcamerawidgets.cpp create mode 100644 tests/auto/unit/multimediawidgets/qgraphicsvideoitem/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qgraphicsvideoitem/tst_qgraphicsvideoitem.cpp create mode 100644 tests/auto/unit/multimediawidgets/qmediaplayerwidgets/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qmediaplayerwidgets/tst_qmediaplayerwidgets.cpp create mode 100644 tests/auto/unit/multimediawidgets/qvideowidget/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qvideowidget/tst_qvideowidget.cpp create mode 100644 tests/auto/unit/plugins/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/qffmpegmath/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/qffmpegmath/tst_qffmpegmath.cpp create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/qffmpegvideoencoderutils/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/qffmpegvideoencoderutils/tst_qffmpegvideoencoderutils.cpp create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/texturebridge/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/texturebridge/devicecontext.cpp create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/texturebridge/devicecontext.h create mode 100644 tests/auto/unit/plugins/multimedia/ffmpeg/texturebridge/tst_texturebridge.cpp create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/gstreamer_backend/BLACKLIST create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/gstreamer_backend/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/gstreamer_backend/color_matrix_90_deg_clockwise.m2v create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/gstreamer_backend/color_matrix_90_deg_clockwise.mp4 create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/gstreamer_backend/metadata_test_file.mp4 create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/gstreamer_backend/readme.txt create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/gstreamer_backend/tst_gstreamer_backend.cpp create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/gstreamer_backend/tst_gstreamer_backend.h create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/qmediacapture_gstreamer/BLACKLIST create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/qmediacapture_gstreamer/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/qmediacapture_gstreamer/tst_qmediacapture_gstreamer.cpp create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/qmediaplayer_gstreamer/BLACKLIST create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/qmediaplayer_gstreamer/CMakeLists.txt create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/qmediaplayer_gstreamer/testdata/color_matrix.mp4 create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/qmediaplayer_gstreamer/tst_qmediaplayer_gstreamer.cpp create mode 100644 tests/auto/unit/plugins/multimedia/gstreamer/qmediaplayer_gstreamer/tst_qmediaplayer_gstreamer.h create mode 100644 tests/global/global.cfg create mode 100644 tests/manual/CMakeLists.txt create mode 100644 tests/manual/audiodecoder/CMakeLists.txt create mode 100644 tests/manual/audiodecoder/audiodecoder.cpp create mode 100644 tests/manual/audiodecoder/audiodecoder.h create mode 100644 tests/manual/audiodecoder/main.cpp create mode 100644 tests/manual/gstreamer-custom-camera-rtp/CMakeLists.txt create mode 100644 tests/manual/gstreamer-custom-camera-rtp/Info.plist.in create mode 100644 tests/manual/gstreamer-custom-camera-rtp/gstreamer-custom-camera-rtp.cpp create mode 100644 tests/manual/gstreamer-custom-camera/CMakeLists.txt create mode 100644 tests/manual/gstreamer-custom-camera/Info.plist.in create mode 100644 tests/manual/gstreamer-custom-camera/gstreamer-custom-camera.cpp create mode 100644 tests/manual/media-metadata/CMakeLists.txt create mode 100644 tests/manual/media-metadata/Info.plist.in create mode 100644 tests/manual/media-metadata/media-metadata.cpp create mode 100644 tests/manual/mediadevices/CMakeLists.txt create mode 100644 tests/manual/mediadevices/main.cpp create mode 100644 tests/manual/mediaformats/CMakeLists.txt create mode 100644 tests/manual/mediaformats/main.cpp create mode 100644 tests/manual/mediaframeinputs/CMakeLists.txt create mode 100644 tests/manual/mediaframeinputs/commandlineparser.cpp create mode 100644 tests/manual/mediaframeinputs/commandlineparser.h create mode 100644 tests/manual/mediaframeinputs/main.cpp create mode 100644 tests/manual/mediaframeinputs/mediaframeinputqueue.h create mode 100644 tests/manual/mediaframeinputs/mediagenerator.cpp create mode 100644 tests/manual/mediaframeinputs/mediagenerator.h create mode 100644 tests/manual/mediaframeinputs/previewrunner.cpp create mode 100644 tests/manual/mediaframeinputs/previewrunner.h create mode 100644 tests/manual/mediaframeinputs/pushmodemediasource.h create mode 100644 tests/manual/mediaframeinputs/recordingrunner.cpp create mode 100644 tests/manual/mediaframeinputs/recordingrunner.h create mode 100644 tests/manual/mediaframeinputs/settings.h create mode 100644 tests/manual/minimal-audio-callback-io/CMakeLists.txt create mode 100644 tests/manual/minimal-audio-callback-io/Info.plist.in create mode 100644 tests/manual/minimal-audio-callback-io/minimal-audio-callback-io.cpp create mode 100644 tests/manual/minimal-audio-recorder/CMakeLists.txt create mode 100644 tests/manual/minimal-audio-recorder/info.plist.in create mode 100644 tests/manual/minimal-audio-recorder/minimal-audio-recorder.cpp create mode 100644 tests/manual/minimal-camera-recorder/CMakeLists.txt create mode 100644 tests/manual/minimal-camera-recorder/Info.plist.in create mode 100644 tests/manual/minimal-camera-recorder/minimal-camera-recorder.cpp create mode 100644 tests/manual/minimal-player/CMakeLists.txt create mode 100644 tests/manual/minimal-player/Info.plist.in create mode 100644 tests/manual/minimal-player/minimal-player.cpp create mode 100644 tests/manual/minimal-screen-recorder/CMakeLists.txt create mode 100644 tests/manual/minimal-screen-recorder/Info.plist.in create mode 100644 tests/manual/minimal-screen-recorder/minimal-screen-recorder.cpp create mode 100644 tests/manual/qml-camera-advanced/AdvancedPanel.qml create mode 100644 tests/manual/qml-camera-advanced/AllCameraControls.qml create mode 100644 tests/manual/qml-camera-advanced/CMakeLists.txt create mode 100644 tests/manual/qml-camera-advanced/CameraDeviceSelector.qml create mode 100644 tests/manual/qml-camera-advanced/CameraFeed.qml create mode 100644 tests/manual/qml-camera-advanced/CameraHelper.qml create mode 100644 tests/manual/qml-camera-advanced/ImageCaptureHelper.qml create mode 100644 tests/manual/qml-camera-advanced/Info.plist create mode 100644 tests/manual/qml-camera-advanced/InfoPage.qml create mode 100644 tests/manual/qml-camera-advanced/Main.qml create mode 100644 tests/manual/qml-camera-advanced/MediaDevicesHelper.qml create mode 100644 tests/manual/qml-camera-advanced/QuickControls.qml create mode 100644 tests/manual/qml-camera-advanced/main.cpp create mode 100644 tests/manual/qml-gstreamer-pipeline/CMakeLists.txt create mode 100644 tests/manual/qml-gstreamer-pipeline/Info.plist.in create mode 100644 tests/manual/qml-gstreamer-pipeline/qml-gstreamer-pipeline.cpp create mode 100644 tests/manual/qml-gstreamer-pipeline/qml-gstreamer-pipeline.qml create mode 100644 tests/manual/qml-gstreamer-rtp/CMakeLists.txt create mode 100644 tests/manual/qml-gstreamer-rtp/Info.plist.in create mode 100644 tests/manual/qml-gstreamer-rtp/qml-gstreamer-rtp.cpp create mode 100644 tests/manual/qml-gstreamer-rtp/qml-gstreamer-rtp.qml create mode 100644 tests/manual/qml-minimal-audio-recorder/CMakeLists.txt create mode 100644 tests/manual/qml-minimal-audio-recorder/Info.plist.in create mode 100644 tests/manual/qml-minimal-audio-recorder/qml-minimal-audio-recorder.cpp create mode 100644 tests/manual/qml-minimal-audio-recorder/qml-minimal-audio-recorder.qml create mode 100644 tests/manual/qml-minimal-camera/CMakeLists.txt create mode 100644 tests/manual/qml-minimal-camera/Info.plist.in create mode 100644 tests/manual/qml-minimal-camera/qml-minimal-camera.cpp create mode 100644 tests/manual/qml-minimal-camera/qml-minimal-camera.qml create mode 100644 tests/manual/qml-minimal-player/CMakeLists.txt create mode 100644 tests/manual/qml-minimal-player/Info.plist.in create mode 100644 tests/manual/qml-minimal-player/qml-minimal-player.cpp create mode 100644 tests/manual/qml-minimal-player/qml-minimal-player.qml create mode 100644 tests/manual/qml-minimal-sound-effect/CMakeLists.txt create mode 100644 tests/manual/qml-minimal-sound-effect/Info.plist.in create mode 100644 tests/manual/qml-minimal-sound-effect/double-drop.wav create mode 100644 tests/manual/qml-minimal-sound-effect/qml-minimal-sound-effect.cpp create mode 100644 tests/manual/qml-minimal-sound-effect/qml-minimal-sound-effect.qml create mode 100644 tests/manual/qml-minimal-sound-effect/triple-click.wav create mode 100644 tests/manual/qml-multiple-players/CMakeLists.txt create mode 100644 tests/manual/qml-multiple-players/qml-multiple-players.cpp create mode 100644 tests/manual/qml-multiple-players/qml-multiple-players.qml create mode 100644 tests/manual/qml-multiple-players/testvideo1.mp4 create mode 100644 tests/manual/qml-multiple-players/testvideo2.mp4 create mode 100644 tests/manual/qml-screencapture-advanced/CMakeLists.txt create mode 100644 tests/manual/qml-screencapture-advanced/Main.qml create mode 100644 tests/manual/qml-screencapture-advanced/ScreenCapturePanel.qml create mode 100644 tests/manual/qml-screencapture-advanced/WindowCapturePanel.qml create mode 100644 tests/manual/qml-screencapture-advanced/android/AndroidManifest.xml create mode 100644 tests/manual/qml-screencapture-advanced/main.cpp create mode 100644 tests/manual/wasm/CMakeLists.txt create mode 100644 tests/manual/wasm/camera/CMakeLists.txt create mode 100644 tests/manual/wasm/camera/main.cpp create mode 100644 tests/manual/wasm/camera/mainwindow.cpp create mode 100644 tests/manual/wasm/camera/mainwindow.h create mode 100644 tests/manual/wasm/camera/mainwindow.ui create mode 100644 util/REUSE.toml create mode 100644 util/adt_generate_qt.m create mode 100644 util/macos_test_audio_config/CMakeLists.txt create mode 100644 util/macos_test_audio_config/README create mode 100755 util/macos_test_audio_config/compile_and_run.sh create mode 100644 util/macos_test_audio_config/main.cpp diff --git a/.cmake.conf b/.cmake.conf new file mode 100644 index 0000000..07a6785 --- /dev/null +++ b/.cmake.conf @@ -0,0 +1,17 @@ +set(QT_REPO_MODULE_VERSION "6.11.2") +set(QT_REPO_MODULE_PRERELEASE_VERSION_SEGMENT "alpha1") +set(QT_EXTRA_INTERNAL_TARGET_DEFINES + "QT_ENABLE_STRICT_MODE_UP_TO=QT_VERSION_CHECK(6,11,0)" + # not yet in strict mode: + "QT_LEAN_HEADERS=1" + "QT_NO_QPAIR=1" + "QT_NO_SINGLE_ARGUMENT_QHASH_OVERLOAD=1" +) + +set(QT_EXTRA_EXAMPLE_TARGET_DEFINES + "QT_ENABLE_STRICT_MODE_UP_TO=QT_VERSION_CHECK(6,11,0)" + # not yet in strict mode: + "QT_LEAN_HEADERS=1" + "QT_NO_QPAIR=1" + "QT_NO_SINGLE_ARGUMENT_QHASH_OVERLOAD=1" +) diff --git a/.gitreview b/.gitreview new file mode 100644 index 0000000..5643d8e --- /dev/null +++ b/.gitreview @@ -0,0 +1,4 @@ +[gerrit] +host=codereview.qt-project.org +project=qt/qtmultimedia +defaultbranch=dev diff --git a/.tag b/.tag new file mode 100644 index 0000000..007dca0 --- /dev/null +++ b/.tag @@ -0,0 +1 @@ +6f162ccac1425edbd7b4d1582fabab5973b43d6c diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100644 index 0000000..13cda51 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,99 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# Generated from qtmultimedia.pro. + +cmake_minimum_required(VERSION 3.16) + +include(.cmake.conf) +project(QtMultimedia + VERSION "${QT_REPO_MODULE_VERSION}" + DESCRIPTION "Qt Multimedia Libraries" + HOMEPAGE_URL "https://qt.io/" + LANGUAGES CXX C +) + +find_package(Qt6 ${PROJECT_VERSION} CONFIG REQUIRED COMPONENTS BuildInternals) + +# This should be called as early as possible, just after find_package(BuildInternals) where it is +# defined. +qt_internal_project_setup() + +find_package(Qt6 ${PROJECT_VERSION} CONFIG REQUIRED Core) +find_package(Qt6 ${PROJECT_VERSION} QUIET CONFIG + OPTIONAL_COMPONENTS + Gui + Network + Svg + Widgets + Quick + Qml + Test + QuickTest + QuickControls2 + Quick3D + OpenGLPrivate + Concurrent) + +if(NOT TARGET Qt::Gui) + message(NOTICE "Skipping the build as the condition \"TARGET Qt::Gui\" is not met.") + return() +endif() + +if(QNX AND CMAKE_SYSTEM_VERSION GREATER_EQUAL 800) + message(NOTICE "Skipping the build as multimedia is not supported on QNX8.0.") + return() +endif() + +include(src/multimedia/Qt6MultimediaMacros.cmake) + +set(QT_BUILD_EXTRA_IDE_FILE_PATTERNS + src/multimedia/doc/QtMultimediaDoc + src/multimedia/doc/qtmultimedia.qdocconf + src/multimedia/doc/snippets/CMakeLists.txt + src/multimedia/doc/snippets/multimedia-snippets/audio.cpp + src/multimedia/doc/snippets/multimedia-snippets/camera.cpp + src/multimedia/doc/snippets/multimedia-snippets/devices.cpp + src/multimedia/doc/snippets/multimedia-snippets/images/qt-logo.png + src/multimedia/doc/snippets/multimedia-snippets/media.cpp + src/multimedia/doc/snippets/multimedia-snippets/multiple-videooutputs.qml + src/multimedia/doc/snippets/multimedia-snippets/qsound.cpp + src/multimedia/doc/snippets/multimedia-snippets/qtvideosink.qml + src/multimedia/doc/snippets/multimedia-snippets/soundeffect.qml + src/multimedia/doc/snippets/multimedia-snippets/video.cpp + src/multimedia/doc/src/audiooverview.qdoc + src/multimedia/doc/src/backend-notes-apple.qdoc + src/multimedia/doc/src/cameraoverview.qdoc + src/multimedia/doc/src/classic.css + src/multimedia/doc/src/multimedia-overview.qdoc + src/multimedia/doc/src/platform-notes-apple.qdoc + src/multimedia/doc/src/platform-notes-wasm.qdoc + src/multimedia/doc/src/platform-notes-wayland.qdoc + src/multimedia/doc/src/platform-notes-linux.qdoc + src/multimedia/doc/src/backend-notes-gstreamer.qdoc + src/multimedia/doc/src/qm-external-pages.qdoc + src/multimedia/doc/src/qt6-changes.qdoc + src/multimedia/doc/src/qtmultimedia-building-from-source.qdoc + src/multimedia/doc/src/qtmultimedia-cpp.qdoc + src/multimedia/doc/src/qtmultimedia-examples.qdoc + src/multimedia/doc/src/qtmultimedia-index.qdoc + src/multimedia/doc/src/qtmultimedia-qml-types.qdoc + src/multimedia/doc/src/videooverview.qdoc + src/multimedia/doc/src/advanced-ffmpeg-configuration.qdoc + src/multimedia/doc/src/images/Zoom.gif + src/multimedia/doc/src/images/annotatedurl.png + src/multimedia/doc/src/images/camera_correctionAngle_90.png + src/multimedia/doc/src/images/codeless.png + src/multimedia/doc/src/images/how-focus-works.gif + src/multimedia/doc/src/images/image_processing.png + src/multimedia/doc/src/images/noun_Media_166644.svg + src/multimedia/doc/src/images/qS1FmgPVL.jpg + src/multimedia/doc/src/images/qmlcamera-menu.png + src/multimedia/doc/src/images/radio-example.png + src/multimedia/doc/src/images/slideshow-img1.png + src/multimedia/doc/src/images/sound-wave-small.jpg + src/multimedia/doc/src/images/video-graphics-memory.png + +) + +qt_build_repo() diff --git a/LICENSES/Apache-2.0.txt b/LICENSES/Apache-2.0.txt new file mode 100644 index 0000000..136d900 --- /dev/null +++ b/LICENSES/Apache-2.0.txt @@ -0,0 +1,61 @@ +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. + + "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. + 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. + 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. + 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: + (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and + (b) You must cause any modified files to carry prominent notices stating that You changed the files; and + (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and + (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. + + You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. + 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. + 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. + 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. + 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. + 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. + +To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. + +Copyright [yyyy] [name of copyright owner] + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/LICENSES/BSD-3-Clause.txt b/LICENSES/BSD-3-Clause.txt new file mode 100644 index 0000000..b91bbd8 --- /dev/null +++ b/LICENSES/BSD-3-Clause.txt @@ -0,0 +1,9 @@ +Copyright (c) . + +Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. + 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/LICENSES/GFDL-1.3-no-invariants-only.txt b/LICENSES/GFDL-1.3-no-invariants-only.txt new file mode 100644 index 0000000..857214d --- /dev/null +++ b/LICENSES/GFDL-1.3-no-invariants-only.txt @@ -0,0 +1,451 @@ + + GNU Free Documentation License + Version 1.3, 3 November 2008 + + + Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. + + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +0. PREAMBLE + +The purpose of this License is to make a manual, textbook, or other +functional and useful document "free" in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible +for modifications made by others. + +This License is a kind of "copyleft", which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft +license designed for free software. + +We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; +it can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + + +1. APPLICABILITY AND DEFINITIONS + +This License applies to any manual or other work, in any medium, that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. Such a notice grants a +world-wide, royalty-free license, unlimited in duration, to use that +work under the conditions stated herein. The "Document", below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as "you". You accept the license if you +copy, modify or distribute the work in a way requiring permission +under copyright law. + +A "Modified Version" of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + +A "Secondary Section" is a named appendix or a front-matter section of +the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall +subject (or to related matters) and contains nothing that could fall +directly within that overall subject. (Thus, if the Document is in +part a textbook of mathematics, a Secondary Section may not explain +any mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding +them. + +The "Invariant Sections" are certain Secondary Sections whose titles +are designated, as being those of Invariant Sections, in the notice +that says that the Document is released under this License. If a +section does not fit the above definition of Secondary then it is not +allowed to be designated as Invariant. The Document may contain zero +Invariant Sections. If the Document does not identify any Invariant +Sections then there are none. + +The "Cover Texts" are certain short passages of text that are listed, +as Front-Cover Texts or Back-Cover Texts, in the notice that says that +the Document is released under this License. A Front-Cover Text may +be at most 5 words, and a Back-Cover Text may be at most 25 words. + +A "Transparent" copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input +to text formatters. A copy made in an otherwise Transparent file +format whose markup, or absence of markup, has been arranged to thwart +or discourage subsequent modification by readers is not Transparent. +An image format is not Transparent if used for any substantial amount +of text. A copy that is not "Transparent" is called "Opaque". + +Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, LaTeX input format, SGML +or XML using a publicly available DTD, and standard-conforming simple +HTML, PostScript or PDF designed for human modification. Examples of +transparent image formats include PNG, XCF and JPG. Opaque formats +include proprietary formats that can be read and edited only by +proprietary word processors, SGML or XML for which the DTD and/or +processing tools are not generally available, and the +machine-generated HTML, PostScript or PDF produced by some word +processors for output purposes only. + +The "Title Page" means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the material +this License requires to appear in the title page. For works in +formats which do not have any title page as such, "Title Page" means +the text near the most prominent appearance of the work's title, +preceding the beginning of the body of the text. + +The "publisher" means any person or entity that distributes copies of +the Document to the public. + +A section "Entitled XYZ" means a named subunit of the Document whose +title either is precisely XYZ or contains XYZ in parentheses following +text that translates XYZ in another language. (Here XYZ stands for a +specific section name mentioned below, such as "Acknowledgements", +"Dedications", "Endorsements", or "History".) To "Preserve the Title" +of such a section when you modify the Document means that it remains a +section "Entitled XYZ" according to this definition. + +The Document may include Warranty Disclaimers next to the notice which +states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this +License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and has +no effect on the meaning of this License. + +2. VERBATIM COPYING + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies +to the Document are reproduced in all copies, and that you add no +other conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further +copying of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + + +3. COPYING IN QUANTITY + +If you publish printed copies (or copies in media that commonly have +printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on +the back cover. Both covers must also clearly and legibly identify +you as the publisher of these copies. The front cover must present +the full title with all words of the title equally prominent and +visible. You may add other material on the covers in addition. +Copying with changes limited to the covers, as long as they preserve +the title of the Document and satisfy these conditions, can be treated +as verbatim copying in other respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy +a computer-network location from which the general network-using +public has access to download using public-standard network protocols +a complete Transparent copy of the Document, free of added material. +If you use the latter option, you must take reasonably prudent steps, +when you begin distribution of Opaque copies in quantity, to ensure +that this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you distribute an +Opaque copy (directly or through your agents or retailers) of that +edition to the public. + +It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to +give them a chance to provide you with an updated version of the +Document. + + +4. MODIFICATIONS + +You may copy and distribute a Modified Version of the Document under +the conditions of sections 2 and 3 above, provided that you release +the Modified Version under precisely this License, with the Modified +Version filling the role of the Document, thus licensing distribution +and modification of the Modified Version to whoever possesses a copy +of it. In addition, you must do these things in the Modified Version: + +A. Use in the Title Page (and on the covers, if any) a title distinct + from that of the Document, and from those of previous versions + (which should, if there were any, be listed in the History section + of the Document). You may use the same title as a previous version + if the original publisher of that version gives permission. +B. List on the Title Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the Modified + Version, together with at least five of the principal authors of the + Document (all of its principal authors, if it has fewer than five), + unless they release you from this requirement. +C. State on the Title page the name of the publisher of the + Modified Version, as the publisher. +D. Preserve all the copyright notices of the Document. +E. Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. +F. Include, immediately after the copyright notices, a license notice + giving the public permission to use the Modified Version under the + terms of this License, in the form shown in the Addendum below. +G. Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice. +H. Include an unaltered copy of this License. +I. Preserve the section Entitled "History", Preserve its Title, and add + to it an item stating at least the title, year, new authors, and + publisher of the Modified Version as given on the Title Page. If + there is no section Entitled "History" in the Document, create one + stating the title, year, authors, and publisher of the Document as + given on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence. +J. Preserve the network location, if any, given in the Document for + public access to a Transparent copy of the Document, and likewise + the network locations given in the Document for previous versions + it was based on. These may be placed in the "History" section. + You may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission. +K. For any section Entitled "Acknowledgements" or "Dedications", + Preserve the Title of the section, and preserve in the section all + the substance and tone of each of the contributor acknowledgements + and/or dedications given therein. +L. Preserve all the Invariant Sections of the Document, + unaltered in their text and in their titles. Section numbers + or the equivalent are not considered part of the section titles. +M. Delete any section Entitled "Endorsements". Such a section + may not be included in the Modified Version. +N. Do not retitle any existing section to be Entitled "Endorsements" + or to conflict in title with any Invariant Section. +O. Preserve any Warranty Disclaimers. + +If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + +You may add a section Entitled "Endorsements", provided it contains +nothing but endorsements of your Modified Version by various +parties--for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + +You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + + +5. COMBINING DOCUMENTS + +You may combine the Document with other documents released under this +License, under the terms defined in section 4 above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its +license notice, and that you preserve all their Warranty Disclaimers. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by +adding at the end of it, in parentheses, the name of the original +author or publisher of that section if known, or else a unique number. +Make the same adjustment to the section titles in the list of +Invariant Sections in the license notice of the combined work. + +In the combination, you must combine any sections Entitled "History" +in the various original documents, forming one section Entitled +"History"; likewise combine any sections Entitled "Acknowledgements", +and any sections Entitled "Dedications". You must delete all sections +Entitled "Endorsements". + + +6. COLLECTIONS OF DOCUMENTS + +You may make a collection consisting of the Document and other +documents released under this License, and replace the individual +copies of this License in the various documents with a single copy +that is included in the collection, provided that you follow the rules +of this License for verbatim copying of each of the documents in all +other respects. + +You may extract a single document from such a collection, and +distribute it individually under this License, provided you insert a +copy of this License into the extracted document, and follow this +License in all other respects regarding verbatim copying of that +document. + + +7. AGGREGATION WITH INDEPENDENT WORKS + +A compilation of the Document or its derivatives with other separate +and independent documents or works, in or on a volume of a storage or +distribution medium, is called an "aggregate" if the copyright +resulting from the compilation is not used to limit the legal rights +of the compilation's users beyond what the individual works permit. +When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves +derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one half of +the entire aggregate, the Document's Cover Texts may be placed on +covers that bracket the Document within the aggregate, or the +electronic equivalent of covers if the Document is in electronic form. +Otherwise they must appear on printed covers that bracket the whole +aggregate. + + +8. TRANSLATION + +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section 4. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License, and all the license notices in the +Document, and any Warranty Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between +the translation and the original version of this License or a notice +or disclaimer, the original version will prevail. + +If a section in the Document is Entitled "Acknowledgements", +"Dedications", or "History", the requirement (section 4) to Preserve +its Title (section 1) will typically require changing the actual +title. + + +9. TERMINATION + +You may not copy, modify, sublicense, or distribute the Document +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense, or distribute it is void, and +will automatically terminate your rights under this License. + +However, if you cease all violation of this License, then your license +from a particular copyright holder is reinstated (a) provisionally, +unless and until the copyright holder explicitly and finally +terminates your license, and (b) permanently, if the copyright holder +fails to notify you of the violation by some reasonable means prior to +60 days after the cessation. + +Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + +Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, receipt of a copy of some or all of the same material does +not give you any rights to use it. + + +10. FUTURE REVISIONS OF THIS LICENSE + +The Free Software Foundation may publish new, revised versions of the +GNU Free Documentation License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in +detail to address new problems or concerns. See +https://www.gnu.org/licenses/. + +Each version of the License is given a distinguishing version number. +If the Document specifies that a particular numbered version of this +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. If the Document +specifies that a proxy can decide which future versions of this +License can be used, that proxy's public statement of acceptance of a +version permanently authorizes you to choose that version for the +Document. + +11. RELICENSING + +"Massive Multiauthor Collaboration Site" (or "MMC Site") means any +World Wide Web server that publishes copyrightable works and also +provides prominent facilities for anybody to edit those works. A +public wiki that anybody can edit is an example of such a server. A +"Massive Multiauthor Collaboration" (or "MMC") contained in the site +means any set of copyrightable works thus published on the MMC site. + +"CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 +license published by Creative Commons Corporation, a not-for-profit +corporation with a principal place of business in San Francisco, +California, as well as future copyleft versions of that license +published by that same organization. + +"Incorporate" means to publish or republish a Document, in whole or in +part, as part of another Document. + +An MMC is "eligible for relicensing" if it is licensed under this +License, and if all works that were first published under this License +somewhere other than this MMC, and subsequently incorporated in whole or +in part into the MMC, (1) had no cover texts or invariant sections, and +(2) were thus incorporated prior to November 1, 2008. + +The operator of an MMC Site may republish an MMC contained in the site +under CC-BY-SA on the same site at any time before August 1, 2009, +provided the MMC is eligible for relicensing. + + +ADDENDUM: How to use this License for your documents + +To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and +license notices just after the title page: + + Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.3 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + A copy of the license is included in the section entitled "GNU + Free Documentation License". + +If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the "with...Texts." line with this: + + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + +If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, +to permit their use in free software. diff --git a/LICENSES/GPL-2.0-only.txt b/LICENSES/GPL-2.0-only.txt new file mode 100644 index 0000000..d159169 --- /dev/null +++ b/LICENSES/GPL-2.0-only.txt @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License along + with this program; if not, write to the Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. diff --git a/LICENSES/GPL-3.0-only.txt b/LICENSES/GPL-3.0-only.txt new file mode 100644 index 0000000..94a9ed0 --- /dev/null +++ b/LICENSES/GPL-3.0-only.txt @@ -0,0 +1,674 @@ + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/LICENSES/LGPL-3.0-only.txt b/LICENSES/LGPL-3.0-only.txt new file mode 100644 index 0000000..65c5ca8 --- /dev/null +++ b/LICENSES/LGPL-3.0-only.txt @@ -0,0 +1,165 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + + This version of the GNU Lesser General Public License incorporates +the terms and conditions of version 3 of the GNU General Public +License, supplemented by the additional permissions listed below. + + 0. Additional Definitions. + + As used herein, "this License" refers to version 3 of the GNU Lesser +General Public License, and the "GNU GPL" refers to version 3 of the GNU +General Public License. + + "The Library" refers to a covered work governed by this License, +other than an Application or a Combined Work as defined below. + + An "Application" is any work that makes use of an interface provided +by the Library, but which is not otherwise based on the Library. +Defining a subclass of a class defined by the Library is deemed a mode +of using an interface provided by the Library. + + A "Combined Work" is a work produced by combining or linking an +Application with the Library. The particular version of the Library +with which the Combined Work was made is also called the "Linked +Version". + + The "Minimal Corresponding Source" for a Combined Work means the +Corresponding Source for the Combined Work, excluding any source code +for portions of the Combined Work that, considered in isolation, are +based on the Application, and not on the Linked Version. + + The "Corresponding Application Code" for a Combined Work means the +object code and/or source code for the Application, including any data +and utility programs needed for reproducing the Combined Work from the +Application, but excluding the System Libraries of the Combined Work. + + 1. Exception to Section 3 of the GNU GPL. + + You may convey a covered work under sections 3 and 4 of this License +without being bound by section 3 of the GNU GPL. + + 2. Conveying Modified Versions. + + If you modify a copy of the Library, and, in your modifications, a +facility refers to a function or data to be supplied by an Application +that uses the facility (other than as an argument passed when the +facility is invoked), then you may convey a copy of the modified +version: + + a) under this License, provided that you make a good faith effort to + ensure that, in the event an Application does not supply the + function or data, the facility still operates, and performs + whatever part of its purpose remains meaningful, or + + b) under the GNU GPL, with none of the additional permissions of + this License applicable to that copy. + + 3. Object Code Incorporating Material from Library Header Files. + + The object code form of an Application may incorporate material from +a header file that is part of the Library. You may convey such object +code under terms of your choice, provided that, if the incorporated +material is not limited to numerical parameters, data structure +layouts and accessors, or small macros, inline functions and templates +(ten or fewer lines in length), you do both of the following: + + a) Give prominent notice with each copy of the object code that the + Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the object code with a copy of the GNU GPL and this license + document. + + 4. Combined Works. + + You may convey a Combined Work under terms of your choice that, +taken together, effectively do not restrict modification of the +portions of the Library contained in the Combined Work and reverse +engineering for debugging such modifications, if you also do each of +the following: + + a) Give prominent notice with each copy of the Combined Work that + the Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the Combined Work with a copy of the GNU GPL and this license + document. + + c) For a Combined Work that displays copyright notices during + execution, include the copyright notice for the Library among + these notices, as well as a reference directing the user to the + copies of the GNU GPL and this license document. + + d) Do one of the following: + + 0) Convey the Minimal Corresponding Source under the terms of this + License, and the Corresponding Application Code in a form + suitable for, and under terms that permit, the user to + recombine or relink the Application with a modified version of + the Linked Version to produce a modified Combined Work, in the + manner specified by section 6 of the GNU GPL for conveying + Corresponding Source. + + 1) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (a) uses at run time + a copy of the Library already present on the user's computer + system, and (b) will operate properly with a modified version + of the Library that is interface-compatible with the Linked + Version. + + e) Provide Installation Information, but only if you would otherwise + be required to provide such information under section 6 of the + GNU GPL, and only to the extent that such information is + necessary to install and execute a modified version of the + Combined Work produced by recombining or relinking the + Application with a modified version of the Linked Version. (If + you use option 4d0, the Installation Information must accompany + the Minimal Corresponding Source and Corresponding Application + Code. If you use option 4d1, you must provide the Installation + Information in the manner specified by section 6 of the GNU GPL + for conveying Corresponding Source.) + + 5. Combined Libraries. + + You may place library facilities that are a work based on the +Library side by side in a single library together with other library +facilities that are not Applications and are not covered by this +License, and convey such a combined library under terms of your +choice, if you do both of the following: + + a) Accompany the combined library with a copy of the same work based + on the Library, uncombined with any other library facilities, + conveyed under the terms of this License. + + b) Give prominent notice with the combined library that part of it + is a work based on the Library, and explaining where to find the + accompanying uncombined form of the same work. + + 6. Revised Versions of the GNU Lesser General Public License. + + The Free Software Foundation may publish revised and/or new versions +of the GNU Lesser General Public License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. + + Each version is given a distinguishing version number. If the +Library as you received it specifies that a certain numbered version +of the GNU Lesser General Public License "or any later version" +applies to it, you have the option of following the terms and +conditions either of that published version or of any later version +published by the Free Software Foundation. If the Library as you +received it does not specify a version number of the GNU Lesser +General Public License, you may choose any version of the GNU Lesser +General Public License ever published by the Free Software Foundation. + + If the Library as you received it specifies that a proxy can decide +whether future versions of the GNU Lesser General Public License shall +apply, that proxy's public statement of acceptance of any version is +permanent authorization for you to choose that version for the +Library. diff --git a/LICENSES/LicenseRef-Qt-Commercial.txt b/LICENSES/LicenseRef-Qt-Commercial.txt new file mode 100644 index 0000000..825b1f3 --- /dev/null +++ b/LICENSES/LicenseRef-Qt-Commercial.txt @@ -0,0 +1,8 @@ +Licensees holding valid commercial Qt licenses may use this software in +accordance with the the terms contained in a written agreement between +you and The Qt Company. Alternatively, the terms and conditions that were +accepted by the licensee when buying and/or downloading the +software do apply. + +For the latest licensing terms and conditions, see https://www.qt.io/terms-conditions. +For further information use the contact form at https://www.qt.io/contact-us. diff --git a/LICENSES/MIT-0.txt b/LICENSES/MIT-0.txt new file mode 100644 index 0000000..9c5dd0f --- /dev/null +++ b/LICENSES/MIT-0.txt @@ -0,0 +1,18 @@ +The MIT-Zero License + +Copyright (c) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/LICENSES/MIT.txt b/LICENSES/MIT.txt new file mode 100644 index 0000000..bc65af3 --- /dev/null +++ b/LICENSES/MIT.txt @@ -0,0 +1,11 @@ + + +MIT License + +Copyright (c) + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/LICENSES/MPL-2.0.txt b/LICENSES/MPL-2.0.txt new file mode 100644 index 0000000..ee6256c --- /dev/null +++ b/LICENSES/MPL-2.0.txt @@ -0,0 +1,373 @@ +Mozilla Public License Version 2.0 +================================== + +1. Definitions +-------------- + +1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + +1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + +1.3. "Contribution" + means Covered Software of a particular Contributor. + +1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + +1.5. "Incompatible With Secondary Licenses" + means + + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + +1.6. "Executable Form" + means any form of the work other than Source Code Form. + +1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + +1.8. "License" + means this document. + +1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + +1.10. "Modifications" + means any of the following: + + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + + (b) any new file in Source Code Form that contains any Covered + Software. + +1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + +1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + +1.13. "Source Code Form" + means the form of the work preferred for making modifications. + +1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + +2. License Grants and Conditions +-------------------------------- + +2.1. Grants + +Each Contributor hereby grants You a world-wide, royalty-free, +non-exclusive license: + +(a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + +(b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + +2.2. Effective Date + +The licenses granted in Section 2.1 with respect to any Contribution +become effective for each Contribution on the date the Contributor first +distributes such Contribution. + +2.3. Limitations on Grant Scope + +The licenses granted in this Section 2 are the only rights granted under +this License. No additional rights or licenses will be implied from the +distribution or licensing of Covered Software under this License. +Notwithstanding Section 2.1(b) above, no patent license is granted by a +Contributor: + +(a) for any code that a Contributor has removed from Covered Software; + or + +(b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + +(c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + +This License does not grant any rights in the trademarks, service marks, +or logos of any Contributor (except as may be necessary to comply with +the notice requirements in Section 3.4). + +2.4. Subsequent Licenses + +No Contributor makes additional grants as a result of Your choice to +distribute the Covered Software under a subsequent version of this +License (see Section 10.2) or under the terms of a Secondary License (if +permitted under the terms of Section 3.3). + +2.5. Representation + +Each Contributor represents that the Contributor believes its +Contributions are its original creation(s) or it has sufficient rights +to grant the rights to its Contributions conveyed by this License. + +2.6. Fair Use + +This License is not intended to limit any rights You have under +applicable copyright doctrines of fair use, fair dealing, or other +equivalents. + +2.7. Conditions + +Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted +in Section 2.1. + +3. Responsibilities +------------------- + +3.1. Distribution of Source Form + +All distribution of Covered Software in Source Code Form, including any +Modifications that You create or to which You contribute, must be under +the terms of this License. You must inform recipients that the Source +Code Form of the Covered Software is governed by the terms of this +License, and how they can obtain a copy of this License. You may not +attempt to alter or restrict the recipients' rights in the Source Code +Form. + +3.2. Distribution of Executable Form + +If You distribute Covered Software in Executable Form then: + +(a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + +(b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + +You may create and distribute a Larger Work under terms of Your choice, +provided that You also comply with the requirements of this License for +the Covered Software. If the Larger Work is a combination of Covered +Software with a work governed by one or more Secondary Licenses, and the +Covered Software is not Incompatible With Secondary Licenses, this +License permits You to additionally distribute such Covered Software +under the terms of such Secondary License(s), so that the recipient of +the Larger Work may, at their option, further distribute the Covered +Software under the terms of either this License or such Secondary +License(s). + +3.4. Notices + +You may not remove or alter the substance of any license notices +(including copyright notices, patent notices, disclaimers of warranty, +or limitations of liability) contained within the Source Code Form of +the Covered Software, except that You may alter any license notices to +the extent required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + +You may choose to offer, and to charge a fee for, warranty, support, +indemnity or liability obligations to one or more recipients of Covered +Software. However, You may do so only on Your own behalf, and not on +behalf of any Contributor. You must make it absolutely clear that any +such warranty, support, indemnity, or liability obligation is offered by +You alone, and You hereby agree to indemnify every Contributor for any +liability incurred by such Contributor as a result of warranty, support, +indemnity or liability terms You offer. You may include additional +disclaimers of warranty and limitations of liability specific to any +jurisdiction. + +4. Inability to Comply Due to Statute or Regulation +--------------------------------------------------- + +If it is impossible for You to comply with any of the terms of this +License with respect to some or all of the Covered Software due to +statute, judicial order, or regulation then You must: (a) comply with +the terms of this License to the maximum extent possible; and (b) +describe the limitations and the code they affect. Such description must +be placed in a text file included with all distributions of the Covered +Software under this License. Except to the extent prohibited by statute +or regulation, such description must be sufficiently detailed for a +recipient of ordinary skill to be able to understand it. + +5. Termination +-------------- + +5.1. The rights granted under this License will terminate automatically +if You fail to comply with any of its terms. However, if You become +compliant, then the rights granted under this License from a particular +Contributor are reinstated (a) provisionally, unless and until such +Contributor explicitly and finally terminates Your grants, and (b) on an +ongoing basis, if such Contributor fails to notify You of the +non-compliance by some reasonable means prior to 60 days after You have +come back into compliance. Moreover, Your grants from a particular +Contributor are reinstated on an ongoing basis if such Contributor +notifies You of the non-compliance by some reasonable means, this is the +first time You have received notice of non-compliance with this License +from such Contributor, and You become compliant prior to 30 days after +Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent +infringement claim (excluding declaratory judgment actions, +counter-claims, and cross-claims) alleging that a Contributor Version +directly or indirectly infringes any patent, then the rights granted to +You by any and all Contributors for the Covered Software under Section +2.1 of this License shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all +end user license agreements (excluding distributors and resellers) which +have been validly granted by You or Your distributors under this License +prior to termination shall survive termination. + +************************************************************************ +* * +* 6. Disclaimer of Warranty * +* ------------------------- * +* * +* Covered Software is provided under this License on an "as is" * +* basis, without warranty of any kind, either expressed, implied, or * +* statutory, including, without limitation, warranties that the * +* Covered Software is free of defects, merchantable, fit for a * +* particular purpose or non-infringing. The entire risk as to the * +* quality and performance of the Covered Software is with You. * +* Should any Covered Software prove defective in any respect, You * +* (not any Contributor) assume the cost of any necessary servicing, * +* repair, or correction. This disclaimer of warranty constitutes an * +* essential part of this License. No use of any Covered Software is * +* authorized under this License except under this disclaimer. * +* * +************************************************************************ + +************************************************************************ +* * +* 7. Limitation of Liability * +* -------------------------- * +* * +* Under no circumstances and under no legal theory, whether tort * +* (including negligence), contract, or otherwise, shall any * +* Contributor, or anyone who distributes Covered Software as * +* permitted above, be liable to You for any direct, indirect, * +* special, incidental, or consequential damages of any character * +* including, without limitation, damages for lost profits, loss of * +* goodwill, work stoppage, computer failure or malfunction, or any * +* and all other commercial damages or losses, even if such party * +* shall have been informed of the possibility of such damages. This * +* limitation of liability shall not apply to liability for death or * +* personal injury resulting from such party's negligence to the * +* extent applicable law prohibits such limitation. Some * +* jurisdictions do not allow the exclusion or limitation of * +* incidental or consequential damages, so this exclusion and * +* limitation may not apply to You. * +* * +************************************************************************ + +8. Litigation +------------- + +Any litigation relating to this License may be brought only in the +courts of a jurisdiction where the defendant maintains its principal +place of business and such litigation shall be governed by laws of that +jurisdiction, without reference to its conflict-of-law provisions. +Nothing in this Section shall prevent a party's ability to bring +cross-claims or counter-claims. + +9. Miscellaneous +---------------- + +This License represents the complete agreement concerning the subject +matter hereof. If any provision of this License is held to be +unenforceable, such provision shall be reformed only to the extent +necessary to make it enforceable. Any law or regulation which provides +that the language of a contract shall be construed against the drafter +shall not be used to construe this License against a Contributor. + +10. Versions of the License +--------------------------- + +10.1. New Versions + +Mozilla Foundation is the license steward. Except as provided in Section +10.3, no one other than the license steward has the right to modify or +publish new versions of this License. Each version will be given a +distinguishing version number. + +10.2. Effect of New Versions + +You may distribute the Covered Software under the terms of the version +of the License under which You originally received the Covered Software, +or under the terms of any subsequent version published by the license +steward. + +10.3. Modified Versions + +If you create software not governed by this License, and you want to +create a new license for such software, you may create and use a +modified version of this License if you rename the license and remove +any references to the name of the license steward (except to note that +such modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary +Licenses + +If You choose to distribute Source Code Form that is Incompatible With +Secondary Licenses under the terms of this version of the License, the +notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice +------------------------------------------- + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at https://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular +file, then You may include the notice in a location (such as a LICENSE +file in a relevant directory) where a recipient would be likely to look +for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - "Incompatible With Secondary Licenses" Notice +--------------------------------------------------------- + + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. diff --git a/LICENSES/Qt-GPL-exception-1.0.txt b/LICENSES/Qt-GPL-exception-1.0.txt new file mode 100644 index 0000000..d0322bf --- /dev/null +++ b/LICENSES/Qt-GPL-exception-1.0.txt @@ -0,0 +1,22 @@ +The Qt Company GPL Exception 1.0 + +Exception 1: + +As a special exception you may create a larger work which contains the +output of this application and distribute that work under terms of your +choice, so long as the work is not otherwise derived from or based on +this application and so long as the work does not in itself generate +output that contains the output from this application in its original +or modified form. + +Exception 2: + +As a special exception, you have permission to combine this application +with Plugins licensed under the terms of your choice, to produce an +executable, and to copy and distribute the resulting executable under +the terms of your choice. However, the executable must be accompanied +by a prominent notice offering all users of the executable the entire +source code to this application, excluding the source code of the +independent modules, but including any changes you have made to this +application, under the terms of this license. + diff --git a/REUSE.toml b/REUSE.toml new file mode 100644 index 0000000..6243801 --- /dev/null +++ b/REUSE.toml @@ -0,0 +1,61 @@ +version = 1 + +[[annotations]] +path = ["src/android/jar/AndroidManifest.xml", + "src/plugins/**"] +precedence = "closest" +comment = "source and plugins" +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only" + +[[annotations]] +path = "tests/**" +precedence = "closest" +comment = "test" +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR GPL-3.0-only" + +[[annotations]] +path = ["**.pro", "**.qrc", ".cmake.conf", "**.yaml", "**/ci_config_linux.json", + "**.cfg", "**BLACKLIST", "**.plist.in", "**.pri", "**.plist", "**/CMakeLists.txt", + "coin/instructions/tests_pipewire", ".tag"] +precedence = "closest" +comment = "build system" +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "BSD-3-Clause" + +[[annotations]] +path = ["**/.gitattributes", "**.gitignore", "**.gitreview"] +comment = "version control system. Infrastructure" +precedence = "closest" +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR BSD-3-Clause" + +[[annotations]] +path = ["examples/**", "**/doc/snippets/**"] +comment = "this must be after the build system table because example and snippets take precedence over build system" +precedence = "closest" +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR BSD-3-Clause" + +[[annotations]] +path = ["util/macos_test_audio_config/README", "**.qdocconf", "**.qdocinc", "src/multimedia/doc/src/classic.css", + "**/doc/src/images/**", "config_help.txt"] +comment = "documentation" +precedence = "closest" +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only" + +[[annotations]] +path = ["**.toml", "licenseRule.json"] +comment = "infrastructure" +precedence = "override" +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR BSD-3-Clause" + +[[annotations]] +path = ["**/qt_attribution.json"] +comment = "documentation" +precedence = "override" +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only" diff --git a/cmake/FindFFmpeg.cmake b/cmake/FindFFmpeg.cmake new file mode 100644 index 0000000..f4b0369 --- /dev/null +++ b/cmake/FindFFmpeg.cmake @@ -0,0 +1,414 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause +#.rst: +# FindFFmpeg +# ---------- +# +# Try to find the required ffmpeg components (default: AVFORMAT, AVUTIL, AVCODEC) +# +# Next variables can be used to hint FFmpeg libs search: +# +# :: +# +# PC__LIBRARY_DIRS +# PC_FFMPEG_LIBRARY_DIRS +# PC__INCLUDE_DIRS +# PC_FFMPEG_INCLUDE_DIRS +# +# Once done this will define +# +# :: +# +# FFMPEG_FOUND - System has the all required components. +# FFMPEG_SHARED_LIBRARIES - Found FFmpeg shared libraries. +# +# For each of the components it will additionally set. +# +# :: +# +# AVCODEC +# AVDEVICE +# AVFORMAT +# AVFILTER +# AVUTIL +# POSTPROC +# SWSCALE +# +# the following variables will be defined +# +# :: +# +# _FOUND - System has +# FFMPEG__FOUND - System has (as checked by FHSPA) +# _INCLUDE_DIRS - Include directory necessary for using the headers +# _LIBRARIES - Link these to use +# _LIBRARY_DIRS - Link directories +# _DEFINITIONS - Compiler switches required for using +# _VERSION - The components version +# +# the following import targets is created +# +# :: +# +# FFmpeg::FFmpeg - for all components +# FFmpeg:: - where in lower case (FFmpeg::avcodec) for each components +# +# Copyright (c) 2006, Matthias Kretz, +# Copyright (c) 2008, Alexander Neundorf, +# Copyright (c) 2011, Michael Jansen, +# Copyright (c) 2017, Alexander Drozdov, +# + +include(FindPackageHandleStandardArgs) + +# The default components were taken from a survey over other FindFFMPEG.cmake files +if (NOT FFmpeg_FIND_COMPONENTS) + set(FFmpeg_FIND_COMPONENTS AVCODEC AVFORMAT AVUTIL) +endif () + +if (QT_DEPLOY_FFMPEG AND BUILD_SHARED_LIBS) + set(shared_libs_desired TRUE) +endif() + +if(IOS) + set(QT_FFMPEG_SHARED_LIBRARY_SUFFIX ".xcframework") +else() + set(QT_FFMPEG_SHARED_LIBRARY_SUFFIX "${CMAKE_SHARED_LIBRARY_SUFFIX}") +endif() + +# finds FFmpeg libs, including symlinks, for the specified component. +macro(find_shared_libs_for_component _component) + # the searching pattern is pretty rough but it seems to be sufficient to gather dynamic libs + get_filename_component(name_we ${${_component}_LIBRARY} NAME_WE) + + if (WIN32) + get_filename_component(dir_name ${${_component}_LIBRARY_DIR} NAME) + if (${dir_name} STREQUAL "lib" AND EXISTS "${${_component}_LIBRARY_DIR}/../bin") + # llvm-mingv builds aux ffmpeg static libs like lib/libavutil.dll.a and cmake finds + # only them even though the folder bin/ contains proper *.dll and *.lib. + + string(REGEX REPLACE "^lib" "" name_we "${name_we}") + set(shared_lib_pattern "../bin/${name_we}*${QT_FFMPEG_SHARED_LIBRARY_SUFFIX}") + else() + set(shared_lib_pattern "${name_we}*${QT_FFMPEG_SHARED_LIBRARY_SUFFIX}") + endif() + + else() + set(shared_lib_pattern "${name_we}*${QT_FFMPEG_SHARED_LIBRARY_SUFFIX}*") + endif() + + file(GLOB ${_component}_SHARED_LIBRARIES "${${_component}_LIBRARY_DIR}/${shared_lib_pattern}") +endmacro() + +# +### Macro: set_component_found +# +# Marks the given component as found if both *_LIBRARY_NAME AND *_INCLUDE_DIRS is present. +# +macro(set_component_found _component) + if (${_component}_LIBRARY_NAME AND ${_component}_INCLUDE_DIR) + # message(STATUS " - ${_component} found.") + set(${_component}_FOUND TRUE) + set(${CMAKE_FIND_PACKAGE_NAME}_${_component}_FOUND TRUE) + else () + # message(STATUS " - ${_component} not found.") + endif () +endmacro() + +find_package(PkgConfig QUIET) +if (FFMPEG_DIR) + if(NOT EXISTS "${FFMPEG_DIR}" OR NOT IS_DIRECTORY "${FFMPEG_DIR}") + message(FATAL_ERROR "Explicitly set FFmpeg directory '${FFMPEG_DIR}' is invalid") + endif() +endif() +if (NOT PKG_CONFIG_FOUND AND NOT FFMPEG_DIR) + set(FFMPEG_DIR "/usr/local") +endif() +# +### Macro: find_component +# +# Checks for the given component by invoking pkgconfig and then looking up the libraries and +# include directories. +# +macro(find_component _component _pkgconfig _library _header) + if (FFMPEG_DIR) + set(backup_cmake_find_root_path "${CMAKE_FIND_ROOT_PATH}") + list(APPEND CMAKE_FIND_ROOT_PATH "${FFMPEG_DIR}") + elseif(PKG_CONFIG_FOUND) + # use pkg-config to get the directories and then use these values + # in the FIND_PATH() and FIND_LIBRARY() calls + pkg_check_modules(PC_${_component} ${_pkgconfig}) + endif() + + if (${_component}_INCLUDE_DIR AND NOT EXISTS ${${_component}_INCLUDE_DIR}) + message(STATUS "Cached include dir ${${_component}_INCLUDE_DIR} doesn't exist") + unset(${_component}_INCLUDE_DIR CACHE) + endif() + + find_path(${_component}_INCLUDE_DIR ${_header} + HINTS + ${PC_${_component}_INCLUDEDIR} + ${PC_${_component}_INCLUDE_DIRS} + ${PC_FFMPEG_INCLUDE_DIRS} + PATHS + ${FFMPEG_DIR} + PATH_SUFFIXES + ffmpeg include + ) + if (${_component}_INCLUDE_DIR) + mark_as_advanced(${_component}_INCLUDE_DIR) + endif() + + if (shared_libs_desired AND NOT WIN32) + set(CMAKE_FIND_LIBRARY_SUFFIXES "${QT_FFMPEG_SHARED_LIBRARY_SUFFIX};${CMAKE_STATIC_LIBRARY_SUFFIX}") + endif() + + if (${_component}_LIBRARY AND NOT EXISTS ${${_component}_LIBRARY}) + message(STATUS "Cached library ${${_component}_LIBRARY} doesn't exist") + unset(${_component}_LIBRARY CACHE) + endif() + + # On iOS we use .xcframework for shared libraries, but this is not + # picked up by standard find_library behavior because .xcframework + # files count as directories. We first search for shared libraries + # on iOS, then we fallback to regular search if we can't find them. + if (IOS) + find_path(${_component}_LIBRARY + NAMES lib${_library}${QT_FFMPEG_SHARED_LIBRARY_SUFFIX} + PATHS + ${FFMPEG_DIR} + PATH_SUFFIXES + lib bin + ) + # There is a quirk here where find_path will return the parent + # directory of the target directory if it's found. We append the + # specific filename. + if (${_component}_LIBRARY) + set(${_component}_LIBRARY "${${_component}_LIBRARY}/lib${_library}${QT_FFMPEG_SHARED_LIBRARY_SUFFIX}") + endif() + endif() + + if (NOT ${_component}_LIBRARY) + find_library(${_component}_LIBRARY + NAMES ${PC_${_component}_LIBRARIES} ${_library} + HINTS + ${PC_${_component}_LIBDIR} + ${PC_${_component}_LIBRARY_DIRS} + ${PC_FFMPEG_LIBRARY_DIRS} + PATHS + ${FFMPEG_DIR} + PATH_SUFFIXES + lib bin + ) + endif() + + if(FFMPEG_DIR) + set(CMAKE_FIND_ROOT_PATH "${backup_cmake_find_root_path}") + endif() + + if (${_component}_LIBRARY) + get_filename_component(${_component}_LIBRARY_DIR ${${_component}_LIBRARY} DIRECTORY) + get_filename_component(${_component}_LIBRARY_NAME ${${_component}_LIBRARY} NAME) + + # On Windows, shared linking goes through 'integration' static libs, so we should look for shared ones anyway + # On Unix, we gather symlinks as well so that we could install them. + if (WIN32 OR ${${_component}_LIBRARY_NAME} MATCHES "\\${QT_FFMPEG_SHARED_LIBRARY_SUFFIX}$") + find_shared_libs_for_component(${_component}) + endif() + + mark_as_advanced(${_component}_LIBRARY) + endif() + + set(${_component}_CFLAGS ${PC_${_component}_CFLAGS} ${PC_${_component}_CFLAGS_OTHER}) + + if (${_component}_INCLUDE_DIR AND ${_component}_LIBRARY) + set_component_found(${_component}) + endif() +endmacro() + +# Clear the previously cached variables, because they are recomputed every time +# the Find script is included. +unset(FFMPEG_INCLUDE_DIRS CACHE) +unset(FFMPEG_SHARED_LIBRARIES CACHE) +unset(FFMPEG_STUBS CACHE) + +# Check for components. +foreach (_component ${FFmpeg_FIND_COMPONENTS}) + string(TOLOWER ${_component} library) + find_component(${_component} "lib${library}" ${library} "lib${library}/${library}.h") + + if (${_component}_FOUND) + list(APPEND FFMPEG_LIBRARIES ${${_component}_LIBRARY_NAME}) + list(APPEND FFMPEG_DEFINITIONS ${${_component}_DEFINITIONS}) + list(APPEND FFMPEG_INCLUDE_DIRS ${${_component}_INCLUDE_DIR}) + list(APPEND FFMPEG_LIBRARY_DIRS ${${_component}_LIBRARY_DIR}) + + if (${_component}_SHARED_LIBRARIES) + list(APPEND FFMPEG_SHARED_LIBRARIES ${${_component}_SHARED_LIBRARIES}) + list(APPEND FFMPEG_SHARED_COMPONENTS ${_component}) + else() + list(APPEND FFMPEG_STATIC_COMPONENTS ${_component}) + endif() + + mark_as_advanced(${_component}_LIBRARY_NAME ${_component}_DEFINITIONS ${_component}_INCLUDE_DIR + ${_component}_LIBRARY_DIR ${_component}_SHARED_LIBRARIES) + endif() +endforeach() + + +function(qt_internal_multimedia_try_add_dynamic_resolve_dependency _component dep) + set(dynamic_resolve_added FALSE PARENT_SCOPE) + + if (NOT QT_FEATURE_library) + return() + endif() + + if (NOT ANDROID AND NOT LINUX) + return() + endif() + + set(supported_stubs "ssl|crypto|va|va-drm|va-x11") + set(stub_prefix "Qt${PROJECT_VERSION_MAJOR}FFmpegStub-") + if (${dep} MATCHES "^${stub_prefix}(${supported_stubs})$") + string(REPLACE "${stub_prefix}" "" dep "${dep}") + set(FFMPEG_STUBS ${FFMPEG_STUBS} ${dep} CACHE INTERNAL "") + set(dynamic_resolve_added TRUE PARENT_SCOPE) + endif() +endfunction() + +# Function parses package config file to find the static library dependencies +# and adds them to the target library. +function(__ffmpeg_internal_set_dependencies _component) + string(TOLOWER ${_component} lib) + + if (WIN32) + set(PC_FILE ${${_component}_LIBRARY_DIR}/../lib/pkgconfig/lib${lib}.pc) + else() + set(PC_FILE ${${_component}_LIBRARY_DIR}/pkgconfig/lib${lib}.pc) + endif() + + if(EXISTS ${PC_FILE}) + file(READ ${PC_FILE} pcfile) + + set(prefix_l "(^| )\\-l") + set(suffix_lib "\\.lib($| )") + set(framework_regex "-framework [A-Za-z0-9_]*") + + string(REGEX REPLACE ".*Libs:([^\n\r]+).*" "\\1" out "${pcfile}") + string(REGEX MATCHALL "${prefix_l}[^ ]+" libs_dependency ${out}) + string(REGEX MATCHALL "[^ ]+${suffix_lib}" libs_dependency_lib ${out}) + string(REGEX MATCHALL "${framework_regex}" framework_dependencies ${out}) + + foreach(dependency IN LISTS libs_dependency) + string(REGEX REPLACE ${prefix_l} "" dependency ${dependency}) + if(NOT ${lib} STREQUAL ${dependency}) + qt_internal_multimedia_try_add_dynamic_resolve_dependency(${_component} ${dependency}) + if(NOT dynamic_resolve_added) + target_link_libraries(FFmpeg::${lib} INTERFACE ${dependency}) + endif() + endif() + endforeach() + + # we don't link private dependencies, but just populate the FFMPEG_STUBS + string(REGEX REPLACE ".*Libs.private:([^\n\r]+).*" "\\1" out "${pcfile}") + string(REGEX MATCHALL "${prefix_l}[^ ]+" libs_private_dependency ${out}) + string(REGEX MATCHALL "[^ ]+${suffix_lib}" libs_private_dependency_lib ${out}) + + foreach(dependency IN LISTS libs_private_dependency) + string(REGEX REPLACE ${prefix_l} "" dependency ${dependency}) + qt_internal_multimedia_try_add_dynamic_resolve_dependency(${_component} ${dependency}) + endforeach() + + foreach(dependency IN LISTS framework_dependencies) + target_link_libraries(FFmpeg::${lib} INTERFACE "${dependency}") + endforeach() + else() + message(WARNING "FFmpeg pc file ${PC_FILE} is not found") + endif() +endfunction() + +# Check for cached results. If there are skip the costly part. +#if (NOT FFMPEG_LIBRARIES) + + # Check if the required components were found and add their stuff to the FFMPEG_* vars. + + +foreach (_component ${FFmpeg_FIND_COMPONENTS}) + if (${_component}_FOUND) + string(TOLOWER ${_component} _lowerComponent) + set(_target FFmpeg::${_lowerComponent}) + if (NOT TARGET ${_target}) + add_library(${_target} INTERFACE IMPORTED) + target_compile_options(${_target} INTERFACE "${${_component}_CFLAGS}") + target_include_directories(${_target} INTERFACE "${${_component}_INCLUDE_DIR}") + target_link_libraries(${_target} INTERFACE "${${_component}_LIBRARY}") + + __ffmpeg_internal_set_dependencies(${_component}) + if (UNIX AND NOT APPLE) + target_link_options(${_target} INTERFACE "-Wl,--exclude-libs=lib${_lowerComponent}") + endif () + endif() + endif() +endforeach () + +# Build the include path with duplicates removed. +list(REMOVE_DUPLICATES FFMPEG_INCLUDE_DIRS) +list(REMOVE_DUPLICATES FFMPEG_LIBRARY_DIRS) +list(REMOVE_DUPLICATES FFMPEG_SHARED_LIBRARIES) +list(REMOVE_DUPLICATES FFMPEG_STUBS) + +message(STATUS "FFmpeg shared libs: ${FFMPEG_SHARED_LIBRARIES}") +message(STATUS "FFmpeg stubs: ${FFMPEG_STUBS}") + +# cache the vars. +set(FFMPEG_INCLUDE_DIRS ${FFMPEG_INCLUDE_DIRS} CACHE STRING "The FFmpeg include directories." FORCE) +set(FFMPEG_SHARED_LIBRARIES ${FFMPEG_SHARED_LIBRARIES} CACHE STRING "The FFmpeg dynamic libraries." FORCE) +set(FFMPEG_STUBS ${FFMPEG_STUBS} CACHE STRING "The FFmpeg stubs." FORCE) + +mark_as_advanced(FFMPEG_INCLUDE_DIRS) +mark_as_advanced(FFMPEG_SHARED_LIBRARIES) +mark_as_advanced(FFMPEG_STUBS) + +# endif () + +list(LENGTH FFMPEG_LIBRARY_DIRS DIRS_COUNT) +if (${DIRS_COUNT} GREATER 1) + message(WARNING "One ffmpeg library dir is expected, found dirs: ${FFMPEG_LIBRARY_DIRS}") +endif() + +if(FFMPEG_SHARED_COMPONENTS AND FFMPEG_STATIC_COMPONENTS) + message(WARNING + "Only static or shared components are expected\n" + " static components: ${FFMPEG_STATIC_COMPONENTS}\n" + " shared components: ${FFMPEG_SHARED_COMPONENTS}") +endif() + +if (shared_libs_desired AND NOT FFMPEG_SHARED_COMPONENTS) + message(WARNING + "Shared FFmpeg libs are desired as QT_DEPLOY_FFMPEG=TRUE, but haven't been found!\n" + "Remove QT_DEPLOY_FFMPEG or set the proper path to shared FFmpeg via FFMPEG_DIR.") +endif() + +# Compile the list of required vars +set(_FFmpeg_REQUIRED_VARS FFMPEG_LIBRARIES FFMPEG_INCLUDE_DIRS) +foreach (_component ${FFmpeg_FIND_COMPONENTS}) + list(APPEND _FFmpeg_REQUIRED_VARS ${_component}_LIBRARY ${_component}_INCLUDE_DIR) +endforeach () + +set(FIND_FFMPEG_HELP_STRING +[=[FFMPEG_DIR CMake variable is not correct. + Make sure that the FFMPEG_DIR CMake variable is set to a path that + contains FFmpeg 'lib' and 'include' directories and that the FFmpeg + installation is built with the avformat, avcodec, swresample, + swscale, and avutil libraries. To resolve the issue, please delete + CMakeCache.txt and run configure again with the correct FFMPEG_DIR + CMake variable set. +]=]) + +# Give a nice error message if some of the required vars are missing. +find_package_handle_standard_args(FFmpeg + REQUIRED_VARS ${_FFmpeg_REQUIRED_VARS} + HANDLE_COMPONENTS + REASON_FAILURE_MESSAGE + ${FIND_FFMPEG_HELP_STRING} +) diff --git a/cmake/FindGObject.cmake b/cmake/FindGObject.cmake new file mode 100644 index 0000000..89a0243 --- /dev/null +++ b/cmake/FindGObject.cmake @@ -0,0 +1,58 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindGObject +# --------- +# +# Try to locate the gobject-2.0 library. +# If found, this will define the following variables: +# +# ``GObject_FOUND`` +# True if the gobject-2.0 library is available +# +# If ``GObject_FOUND`` is TRUE, it will also define the following +# imported target: +# +# ``GObject::GObject`` +# The gobject-2.0 library + +include(CMakeFindDependencyMacro) +find_dependency(GLIB2) +qt_internal_disable_find_package_global_promotion(GLIB2::GLIB2) + +if(NOT TARGET GObject::GObject) + find_package(PkgConfig QUIET) + pkg_check_modules(PC_GOBJECT gobject-2.0 IMPORTED_TARGET) + if(TARGET PkgConfig::PC_GOBJECT) + add_library(GObject::GObject INTERFACE IMPORTED) + target_link_libraries(GObject::GObject INTERFACE + PkgConfig::PC_GOBJECT + GLIB2::GLIB2 + ) + else() + find_path(GObject_INCLUDE_DIR + NAMES gobject.h + PATH_SUFFIXES glib-2.0/gobject/ + ) + find_library(GObject_LIBRARY NAMES gobject-2.0) + if(GObject_LIBRARY AND GObject_INCLUDE_DIR) + add_library(GObject::GObject INTERFACE IMPORTED) + target_include_directories(GObject::GObject INTERFACE + ${GObject_INCLUDE_DIR} + ) + target_link_libraries(GObject::GObject INTERFACE + ${GObject_LIBRARY} + GLIB2::GLIB2 + ) + endif() + include(FindPackageHandleStandardArgs) + find_package_handle_standard_args(GObject REQUIRED_VARS + GObject_LIBRARY + GObject_INCLUDE_DIR + ) + endif() +endif() + +if(TARGET GObject::GObject) + set(GObject_FOUND TRUE) +endif() diff --git a/cmake/FindGStreamer.cmake b/cmake/FindGStreamer.cmake new file mode 100644 index 0000000..a19b731 --- /dev/null +++ b/cmake/FindGStreamer.cmake @@ -0,0 +1,261 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindGStreamer +# --------- +# +# Locate the gstreamer-1.0 library and some of its plugins. +# Defines the following imported target: +# +# ``GStreamer::GStreamer`` +# If the gstreamer-1.0 library is available and target GStreamer::Base, +# GStreamer::Audio, GStreamer::Video, GStreamer::Pbutils and +# GStreamer::Allocators exist +# +# If target GStreamer::GStreamer exists, the following targets may be defined: +# +# ``GStreamer::App`` +# If the gstapp-1.0 library is available and its dependencies exist +# ``GStreamer::Photography`` +# If the gstphotography-1.0 library is available and its dependencies exist +# ``GStreamer::Gl`` +# If the gstgl-1.0 library is available and its dependencies exist +# ``GStreamer::GlEgl`` +# If the gstreamer-gl-egl-1.0 library is available and its dependencies exist +# ``GStreamer::GlWayland`` +# If the gstreamer-gl-wayland-1.0 library is available and its dependencies exist +# ``GStreamer::GlX11`` +# If the gstreamer-gl-x11-1.0 library is available and its dependencies exist +# + +include(CMakeFindDependencyMacro) +find_dependency(GObject) + +find_package(PkgConfig QUIET) + +function(find_gstreamer_component component) + cmake_parse_arguments(PARSE_ARGV 1 ARGS "" "PC_NAME;HEADER;LIBRARY" "DEPENDENCIES") + + set(pkgconfig_name ${ARGS_PC_NAME}) + set(header ${ARGS_HEADER}) + set(library ${ARGS_LIBRARY}) + + set(target GStreamer::${component}) + + if(NOT TARGET ${target}) + if(PKG_CONFIG_FOUND) + string(TOUPPER ${component} upper) + pkg_check_modules(PC_GSTREAMER_${upper} IMPORTED_TARGET ${pkgconfig_name}>=${GStreamer_FIND_VERSION} ) + if(TARGET PkgConfig::PC_GSTREAMER_${upper}) + add_library(GStreamer::${component} INTERFACE IMPORTED) + target_link_libraries(GStreamer::${component} INTERFACE PkgConfig::PC_GSTREAMER_${upper}) + endif() + else() + foreach(dependency IN LISTS ARGS_DEPENDENCIES) + if (NOT TARGET ${dependency}) + set(GStreamer_${component}_FOUND FALSE PARENT_SCOPE) + return() + endif() + endforeach() + + find_path(GStreamer_${component}_INCLUDE_DIR + NAMES ${header} + PATH_SUFFIXES gstreamer-1.0 + ) + find_library(GStreamer_${component}_LIBRARY + NAMES ${library} + ) + + if(${component} STREQUAL "Gl") + # search the gstglconfig.h include dir under the same root where the library is found + get_filename_component(gstglLibDir "${GStreamer_Gl_LIBRARY}" PATH) + find_path(GStreamer_GlConfig_INCLUDE_DIR + NAMES gst/gl/gstglconfig.h + PATH_SUFFIXES gstreamer-1.0/include + HINTS ${PC_GSTREAMER_GL_INCLUDE_DIRS} ${PC_GSTREAMER_GL_INCLUDEDIR} "${gstglLibDir}" + ) + if(GStreamer_GlConfig_INCLUDE_DIR) + list(APPEND GStreamer_Gl_INCLUDE_DIR "${GStreamer_GlConfig_INCLUDE_DIR}") + list(REMOVE_DUPLICATES GStreamer_Gl_INCLUDE_DIR) + endif() + endif() + if(GStreamer_${component}_LIBRARY AND GStreamer_${component}_INCLUDE_DIR) + + if (NOT TARGET DUMMY_GStreamer::${component}) + + string(REGEX MATCH "^([0-9]+)\\.([0-9]+)" GStreamerVersionMatch ${GStreamer_FIND_VERSION}) + set(VERSION_MAJOR ${CMAKE_MATCH_1}) + set(VERSION_MINOR ${CMAKE_MATCH_2}) + + # hack alert: we cannot obtain the installed gstreamer version without a try_compile. however we + # cannot try_compile without creating a target, as try_compile does not accept include paths. So we + # need to create a dummy target + + add_library(DUMMY_GStreamer::${component} INTERFACE IMPORTED) + target_include_directories(DUMMY_GStreamer::${component} INTERFACE ${GStreamer_${component}_INCLUDE_DIR}) + target_link_libraries(DUMMY_GStreamer::${component} INTERFACE ${GStreamer_${component}_LIBRARY}) + if(ARGS_DEPENDENCIES) + target_link_libraries(DUMMY_GStreamer::${component} INTERFACE ${ARGS_DEPENDENCIES}) + endif() + + qt_config_compile_test(gstreamer_version_check_${component} + LABEL "GStreamer Version test" + LIBRARIES + DUMMY_GStreamer::${component} + CODE + "#include + + static_assert(GST_CHECK_VERSION(${VERSION_MAJOR}, ${VERSION_MINOR}, 0), + \"Minimum required GStreamer version is ${VERSION_MAJOR}.${VERSION_MINOR}\"); + + int main() + { + return 0; + }") + + # Run the test immediately because we can't rely on lazy evaluation here + qt_run_config_compile_test("gstreamer_version_check_${component}") + + if (${TEST_gstreamer_version_check_${component}}) + add_library(GStreamer::${component} INTERFACE IMPORTED) + + target_include_directories(GStreamer::${component} INTERFACE ${GStreamer_${component}_INCLUDE_DIR}) + target_link_libraries(GStreamer::${component} INTERFACE ${GStreamer_${component}_LIBRARY}) + if(ARGS_DEPENDENCIES) + target_link_libraries(GStreamer::${component} INTERFACE ${ARGS_DEPENDENCIES}) + endif() + endif() + endif() + endif() + mark_as_advanced(GStreamer_${component}_INCLUDE_DIR GStreamer_${component}_LIBRARY) + endif() + endif() + + if(TARGET ${target}) + set(GStreamer_${component}_FOUND TRUE PARENT_SCOPE) + endif() +endfunction() + +# GStreamer required dependencies +find_gstreamer_component(Core + PC_NAME gstreamer-1.0 + HEADER gst/gst.h + LIBRARY gstreamer-1.0 + DEPENDENCIES GObject::GObject) +find_gstreamer_component(Base + PC_NAME gstreamer-base-1.0 + HEADER gst/gst.h + LIBRARY gstbase-1.0 + DEPENDENCIES GStreamer::Core) +find_gstreamer_component(Audio + PC_NAME gstreamer-audio-1.0 + HEADER gst/audio/audio.h + LIBRARY gstaudio-1.0 + DEPENDENCIES GStreamer::Base) +find_gstreamer_component(Video + PC_NAME gstreamer-video-1.0 + HEADER gst/video/video.h + LIBRARY gstvideo-1.0 + DEPENDENCIES GStreamer::Base) +find_gstreamer_component(Pbutils + PC_NAME gstreamer-pbutils-1.0 + HEADER gst/pbutils/pbutils.h + LIBRARY gstpbutils-1.0 + DEPENDENCIES GStreamer::Audio GStreamer::Video) +find_gstreamer_component(Allocators + PC_NAME gstreamer-allocators-1.0 + HEADER gst/allocators/allocators.h + LIBRARY gstallocators-1.0 + DEPENDENCIES GStreamer::Core) + +if(Play IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(Play + PC_NAME gstreamer-play-1.0 + HEADER gst/gst.h + LIBRARY gstplay-1.0 + DEPENDENCIES GStreamer::Core GStreamer::Video) +endif() + +if(App IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(App + PC_NAME gstreamer-app-1.0 + HEADER gst/app/gstappsink.h + LIBRARY gstapp-1.0 + DEPENDENCIES GStreamer::Base) +endif() + +if(Photography IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(Photography + PC_NAME gstreamer-photography-1.0 + HEADER gst/interfaces/photography.h + LIBRARY gstphotography-1.0 + DEPENDENCIES GStreamer::Core) +endif() + +if(Gl IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(Gl + PC_NAME gstreamer-gl-1.0 + HEADER gst/gl/gl.h + LIBRARY gstgl-1.0 + DEPENDENCIES GStreamer::Core) +endif() + +if(GlEgl IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(GlEgl + PC_NAME gstreamer-gl-egl-1.0 + HEADER gst/gl/egl/gstgldisplay_egl.h + LIBRARY gstgl-1.0 + DEPENDENCIES GStreamer::Video GStreamer::Base GStreamer::Core GStreamer::Gl EGL::EGL ) +endif() + +if(GlX11 IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(GlX11 + PC_NAME gstreamer-gl-x11-1.0 + HEADER gst/gl/x11/gstgldisplay_x11.h + LIBRARY gstgl-1.0 + DEPENDENCIES GStreamer::Video GStreamer::Base GStreamer::Core GStreamer::Gl XCB::XCB ) +endif() + +if(GlWayland IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(GlWayland + PC_NAME gstreamer-gl-wayland-1.0 + HEADER gst/gl/wayland/gstgldisplay_wayland.h + LIBRARY gstgl-1.0 + DEPENDENCIES GStreamer::Video GStreamer::Base GStreamer::Core GStreamer::Gl Wayland::Client ) +endif() + +# Create target GStreamer::GStreamer +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(GStreamer + REQUIRED_VARS + GStreamer_Core_FOUND + GStreamer_Base_FOUND + GStreamer_Audio_FOUND + GStreamer_Video_FOUND + GStreamer_Pbutils_FOUND + GStreamer_Allocators_FOUND + HANDLE_COMPONENTS +) + +if(GStreamer_FOUND AND NOT TARGET GStreamer::GStreamer) + add_library(GStreamer::GStreamer INTERFACE IMPORTED) + target_link_libraries(GStreamer::GStreamer INTERFACE + GStreamer::Core + GStreamer::Base + GStreamer::Audio + GStreamer::Video + GStreamer::Pbutils + GStreamer::Allocators + ) +endif() + +if(TARGET PkgConfig::PC_GSTREAMER_GL) + get_target_property(_qt_incs PkgConfig::PC_GSTREAMER_GL INTERFACE_INCLUDE_DIRECTORIES) + set(__qt_fixed_incs) + foreach(path IN LISTS _qt_incs) + if(IS_DIRECTORY "${path}") + list(APPEND __qt_fixed_incs "${path}") + endif() + endforeach() + set_property(TARGET PkgConfig::PC_GSTREAMER_GL PROPERTY INTERFACE_INCLUDE_DIRECTORIES "${__qt_fixed_incs}") +endif() diff --git a/cmake/FindMMRenderer.cmake b/cmake/FindMMRenderer.cmake new file mode 100644 index 0000000..43dcf3f --- /dev/null +++ b/cmake/FindMMRenderer.cmake @@ -0,0 +1,29 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindMMRenderer +# --------- +# +# Try to locate the mm-renderer library. +# If found, this will define the following variables: +# +# ``MMRenderer_FOUND`` +# True if the mm-renderer library is available +# ``MMRenderer_LIBRARY`` +# The mm-renderer library +# +# If ``MMRenderer_FOUND`` is TRUE, it will also define the following +# imported target: +# +# ``MMRenderer::MMRenderer`` +# The mm-renderer library to link to + +find_library(MMRenderer_LIBRARY NAMES mmrndclient) +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(MMRenderer DEFAULT_MSG MMRenderer_LIBRARY) +if(MMRenderer_FOUND AND NOT TARGET MMRenderer::MMRenderer) + add_library(MMRenderer::MMRenderer INTERFACE IMPORTED) + target_link_libraries(MMRenderer::MMRenderer + INTERFACE "${MMRenderer_LIBRARY}") +endif() +mark_as_advanced(MMRenderer_LIBRARY) diff --git a/cmake/FindMMRendererCore.cmake b/cmake/FindMMRendererCore.cmake new file mode 100644 index 0000000..3f07e37 --- /dev/null +++ b/cmake/FindMMRendererCore.cmake @@ -0,0 +1,12 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +find_library(MMRendererCore_LIBRARY NAMES mmrndcore) +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(MMRendererCore DEFAULT_MSG MMRendererCore_LIBRARY) +if(MMRendererCore_FOUND AND NOT TARGET MMRendererCore::MMRendererCore) + add_library(MMRendererCore::MMRendererCore INTERFACE IMPORTED) + target_link_libraries(MMRendererCore::MMRendererCore + INTERFACE "${MMRendererCore_LIBRARY}") +endif() +mark_as_advanced(MMRendererCore_LIBRARY) diff --git a/cmake/FindPipeWire.cmake b/cmake/FindPipeWire.cmake new file mode 100644 index 0000000..5812bac --- /dev/null +++ b/cmake/FindPipeWire.cmake @@ -0,0 +1,123 @@ +#.rst: +# FindPipeWire +# ------- +# +# Try to find PipeWire on a Unix system. +# +# This will define the following variables: +# +# ``PipeWire_FOUND`` +# True if (the requested version of) PipeWire is available +# ``PipeWire_VERSION`` +# The version of PipeWire +# ``PipeWire_LIBRARIES`` +# This can be passed to target_link_libraries() instead of the ``PipeWire::PipeWire`` +# target +# ``PipeWire_INCLUDE_DIRS`` +# This should be passed to target_include_directories() if the target is not +# used for linking +# ``PipeWire_DEFINITIONS`` +# This should be passed to target_compile_options() if the target is not +# used for linking +# +# If ``PipeWire_FOUND`` is TRUE, it will also define the following imported target: +# +# ``PipeWire::PipeWire`` +# The PipeWire library +# +# In general we recommend using the imported target, as it is easier to use. +# Bear in mind, however, that if the target is in the link interface of an +# exported library, it must be made available by the package config file. + +#============================================================================= +# Copyright 2014 Alex Merry +# Copyright 2014 Martin Gräßlin +# Copyright 2018-2020 Jan Grulich +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions +# are met: +# +# 1. Redistributions of source code must retain the copyright +# notice, this list of conditions and the following disclaimer. +# 2. Redistributions in binary form must reproduce the copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution. +# 3. The name of the author may not be used to endorse or promote products +# derived from this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +#============================================================================= + +# Use pkg-config to get the directories and then use these values +# in the FIND_PATH() and FIND_LIBRARY() calls +find_package(PkgConfig QUIET) + +if(PkgConfig_FOUND) + pkg_search_module(PKG_PipeWire QUIET libpipewire-0.3) + pkg_search_module(PKG_Spa QUIET libspa-0.2) +endif() + +set(PipeWire_DEFINITIONS "${PKG_PipeWire_CFLAGS}" "${PKG_Spa_CFLAGS}") +set(PipeWire_VERSION "${PKG_PipeWire_VERSION}") + +find_path(PipeWire_INCLUDE_DIRS + NAMES + pipewire/pipewire.h + HINTS + ${PKG_PipeWire_INCLUDE_DIRS} + ${PKG_PipeWire_INCLUDE_DIRS}/pipewire-0.3 +) + +find_path(Spa_INCLUDE_DIRS + NAMES + spa/param/props.h + HINTS + ${PKG_Spa_INCLUDE_DIRS} + ${PKG_Spa_INCLUDE_DIRS}/spa-0.2 +) + +find_library(PipeWire_LIBRARIES + NAMES + pipewire-0.3 + HINTS + ${PKG_PipeWire_LIBRARY_DIRS} +) + +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(PipeWire + FOUND_VAR + PipeWire_FOUND + REQUIRED_VARS + PipeWire_LIBRARIES + PipeWire_INCLUDE_DIRS + Spa_INCLUDE_DIRS + VERSION_VAR + PipeWire_VERSION +) + +if(PipeWire_FOUND AND NOT TARGET PipeWire::PipeWire) + add_library(PipeWire::PipeWire UNKNOWN IMPORTED) + set_target_properties(PipeWire::PipeWire PROPERTIES + IMPORTED_LOCATION "${PipeWire_LIBRARIES}" + INTERFACE_COMPILE_OPTIONS "${PipeWire_DEFINITIONS}" + INTERFACE_INCLUDE_DIRECTORIES "${PipeWire_INCLUDE_DIRS};${Spa_INCLUDE_DIRS}" + ) +endif() + +mark_as_advanced(PipeWire_LIBRARIES PipeWire_INCLUDE_DIRS) + +include(FeatureSummary) +set_package_properties(PipeWire PROPERTIES + URL "https://www.pipewire.org" + DESCRIPTION "PipeWire - multimedia processing" +) diff --git a/cmake/FindVAAPI.cmake b/cmake/FindVAAPI.cmake new file mode 100644 index 0000000..b1170dc --- /dev/null +++ b/cmake/FindVAAPI.cmake @@ -0,0 +1,92 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + + +find_package(PkgConfig QUIET) + +function(qt_internal_multimedia_set_va_outputs component include_dir lib_path) + if ("${component}" STREQUAL "VA") + set(VAAPI_INCLUDE_DIR "${include_dir}" CACHE INTERNAL "") + get_filename_component(lib_realpath "${lib_path}" REALPATH) + + string(REGEX MATCH "[0-9]+(\\.[0-9]+)*$" VAAPI_SUFFIX "${lib_realpath}") + set(VAAPI_SUFFIX "${VAAPI_SUFFIX}" CACHE INTERNAL "") + + mark_as_advanced(VAAPI_SUFFIX VAAPI_INCLUDE_DIR) + endif() +endfunction() + +function(find_component component prefix header library) + if(NOT TARGET VAAPI::${component}) + string(TOUPPER ${component} upper) + pkg_search_module(PC_VAAPI_${upper} ${prefix} IMPORTED_TARGET) + if(TARGET PkgConfig::PC_VAAPI_${upper}) + add_library(VAAPI::${component} INTERFACE IMPORTED) + target_link_libraries(VAAPI::${component} INTERFACE PkgConfig::PC_VAAPI_${upper}) + + if (NOT PC_VAAPI_${upper}_LINK_LIBRARIES) + get_target_property(PC_VAAPI_${upper}_LINK_LIBRARIES PkgConfig::PC_VAAPI_${upper} INTERFACE_LINK_LIBRARIES) + message(STATUS "PC_VAAPI_${upper}_LINK_LIBRARIES is not defined by PkgConfig; " + "Get the value from target properties: ${PC_VAAPI_${upper}_LINK_LIBRARIES}") + endif() + + foreach (lib_path ${PC_VAAPI_${upper}_LINK_LIBRARIES}) + get_filename_component(lib_name "${lib_path}" NAME_WLE) + if (${lib_name} STREQUAL ${prefix}) + qt_internal_multimedia_set_va_outputs(${component} + "${PC_VAAPI_${upper}_INCLUDEDIR}" "${lib_path}") + break() + endif() + endforeach() + else() + find_path(VAAPI_${component}_INCLUDE_DIR + NAMES ${header} + PATH_SUFFIXES VAAPI-1.0 + ) + find_library(VAAPI_${component}_LIBRARY + NAMES ${library} + ) + if(VAAPI_${component}_LIBRARY AND VAAPI_${component}_INCLUDE_DIR) + add_library(VAAPI::${component} INTERFACE IMPORTED) + target_include_directories(VAAPI::${component} INTERFACE ${VAAPI_${component}_INCLUDE_DIR}) + target_link_libraries(VAAPI::${component} INTERFACE ${VAAPI_${component}_LIBRARY}) + endif() + mark_as_advanced(VAAPI_${component}_INCLUDE_DIR VAAPI_${component}_LIBRARY) + + qt_internal_multimedia_set_va_outputs(${component} + "${VAAPI_${component}_INCLUDE_DIR}" "${VAAPI_${component}_LIBRARY}") + endif() + endif() + + if(TARGET VAAPI::${component}) + set(VAAPI_${component}_FOUND TRUE PARENT_SCOPE) + endif() +endfunction() + +find_component(VA libva va/va.h libva) +find_component(DRM libva-drm va/va-drm.h libva-drm) + +if(TARGET VAAPI::VA) + target_link_libraries(VAAPI::VA) +endif() +if(TARGET VAAPI::VA AND TARGET VAAPI::DRM) + target_link_libraries(VAAPI::DRM INTERFACE VAAPI::VA) +endif() + +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(VAAPI + REQUIRED_VARS + VAAPI_VA_FOUND + VAAPI_DRM_FOUND + VAAPI_INCLUDE_DIR + VAAPI_SUFFIX + HANDLE_COMPONENTS +) + +if(VAAPI_FOUND AND NOT TARGET VAAPI::VAAPI) + add_library(VAAPI::VAAPI INTERFACE IMPORTED) + target_link_libraries(VAAPI::VAAPI INTERFACE + VAAPI::VA + VAAPI::DRM + ) +endif() diff --git a/cmake/FindWrapPulseAudio.cmake b/cmake/FindWrapPulseAudio.cmake new file mode 100644 index 0000000..ce170da --- /dev/null +++ b/cmake/FindWrapPulseAudio.cmake @@ -0,0 +1,37 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindWrapPulseAudio +# --------- +# +# Try to locate the pulseaudio library. +# If found, this will define the following variables: +# +# ``WrapPulseAudio_FOUND`` +# True if the pulseaudio library is available +# +# If ``WrapPulseAduio_FOUND`` is TRUE, it will also define the following +# imported target: +# +# ``WrapPulseAudio::WrapPulseAudio`` +# The pulseaudio library to link to + +if(TARGET WrapPulseAudio::WrapPulseAudio) + set(WrapPulseAudio_FOUND ON) + return() +endif() +find_package(PulseAudio QUIET) +if(PulseAudio_FOUND) + set(WrapPulseAudio_FOUND 1) +endif() +if(WrapPulseAudio_FOUND AND NOT TARGET WrapPulseAudio::WrapPulseAudio) + add_library(WrapPulseAudio::WrapPulseAudio INTERFACE IMPORTED) + target_include_directories(WrapPulseAudio::WrapPulseAudio INTERFACE "${PULSEAUDIO_INCLUDE_DIR}") + target_link_libraries(WrapPulseAudio::WrapPulseAudio + INTERFACE "${PULSEAUDIO_LIBRARY}") +endif() +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(WrapPulseAudio REQUIRED_VARS + PULSEAUDIO_LIBRARY PULSEAUDIO_INCLUDE_DIR WrapPulseAudio_FOUND) + +mark_as_advanced(PULSEAUDIO_LIBRARY PULSEAUDIO_INCLUDE_DIR) diff --git a/cmake/REUSE.toml b/cmake/REUSE.toml new file mode 100644 index 0000000..6fcb066 --- /dev/null +++ b/cmake/REUSE.toml @@ -0,0 +1,7 @@ +version = 1 + +[[annotations]] +path = ["FindPipeWire.cmake"] +precedence = "aggregate" +comment = "build system. The copyright is provided in file." +SPDX-License-Identifier = "BSD-3-Clause" diff --git a/coin/axivion/ci_config_linux.json b/coin/axivion/ci_config_linux.json new file mode 100644 index 0000000..1741f34 --- /dev/null +++ b/coin/axivion/ci_config_linux.json @@ -0,0 +1,45 @@ +{ + "Project": { + "BuildSystemIntegration": { + "child_order": [ + "GCCSetup", + "CMake", + "LinkLibraries" + ] + }, + "CMake": { + "_active": true, + "_copy_from": "CMakeIntegration", + "build_environment": {}, + "build_options": "-j4", + "generate_options": "--fresh", + "generator": "Ninja" + }, + "GCCSetup": { + "_active": true, + "_copy_from": "Command", + "build_command": "gccsetup --cc gcc --cxx g++ --config ../../../axivion/" + }, + "LinkLibraries": { + "_active": true, + "_copy_from": "AxivionLinker", + "input_files": [ + "build/lib/lib*.so*.ir", + "build/qml/*/lib*.so*.ir", + "build/qml/*/*/lib*.so*.ir" + ], + "ir": "build/$(env:TESTED_MODULE_COIN).ir", + "plugin_files": [ + "build/plugins/*/lib*.so*.ir" + ] + } + }, + "_Format": "1.0", + "_Version": "7.6.2", + "_VersionNum": [ + 7, + 6, + 2, + 12725 + ] +} diff --git a/coin/instructions/configure_tests_environment_for_ffmpeg_backend.yaml b/coin/instructions/configure_tests_environment_for_ffmpeg_backend.yaml new file mode 100644 index 0000000..9fc6542 --- /dev/null +++ b/coin/instructions/configure_tests_environment_for_ffmpeg_backend.yaml @@ -0,0 +1,42 @@ +type: Group +instructions: + - type: Group + enable_if: + condition: runtime + env_var: NON_QTBASE_CMAKE_ARGS + contains_value: "-DFFMPEG_DIR=" + instructions: + - type: AppendToEnvironmentVariable + variableName: COMMON_TEST_CMAKE_ARGS + variableValue: " {{.Env.NON_QTBASE_CMAKE_ARGS}}" + disable_if: + condition: runtime + env_var: COMMON_TEST_CMAKE_ARGS + equals_value: null + - type: EnvironmentVariable + variableName: COMMON_TEST_CMAKE_ARGS + variableValue: "{{.Env.NON_QTBASE_CMAKE_ARGS}}" + enable_if: + condition: runtime + env_var: COMMON_TEST_CMAKE_ARGS + equals_value: null + - type: Group + enable_if: + condition: runtime + env_var: NON_QTBASE_TARGET_CMAKE_ARGS + contains_value: "-DFFMPEG_DIR=" + instructions: + - type: AppendToEnvironmentVariable + variableName: COMMON_TARGET_TEST_CMAKE_ARGS + variableValue: " {{.Env.NON_QTBASE_TARGET_CMAKE_ARGS}}" + disable_if: + condition: runtime + env_var: COMMON_TARGET_TEST_CMAKE_ARGS + equals_value: null + - type: EnvironmentVariable + variableName: COMMON_TARGET_TEST_CMAKE_ARGS + variableValue: "{{.Env.NON_QTBASE_TARGET_CMAKE_ARGS}}" + enable_if: + condition: runtime + env_var: COMMON_TARGET_TEST_CMAKE_ARGS + equals_value: null diff --git a/coin/instructions/run_darwin_backend_tests.yaml b/coin/instructions/run_darwin_backend_tests.yaml new file mode 100644 index 0000000..586ced2 --- /dev/null +++ b/coin/instructions/run_darwin_backend_tests.yaml @@ -0,0 +1,18 @@ +type: Group +enable_if: + condition: or + conditions: + - condition: runtime + env_var: TARGET_OSVERSION_COIN + contains_value: macos_26 + +instructions: + - type: EnvironmentVariable + variableName: QT_MEDIA_BACKEND + variableValue: darwin + + - type: AppendToEnvironmentVariable + variableName: CTEST_ARGS + variableValue: " -R tst_qmediaplayerbackend" + + - !include "{{qt/qtbase}}/coin_module_test_template_v3.yaml" diff --git a/coin/instructions/run_ffmpeg_backend_tests.yaml b/coin/instructions/run_ffmpeg_backend_tests.yaml new file mode 100644 index 0000000..ec09785 --- /dev/null +++ b/coin/instructions/run_ffmpeg_backend_tests.yaml @@ -0,0 +1,15 @@ +type: Group +disable_if: + condition: or + conditions: + - condition: runtime + env_var: TARGET_OS_COIN + equals_value: qnx + - condition: runtime + env_var: TARGET_OSVERSION_COIN + equals_value: vxworks +instructions: + - type: EnvironmentVariable + variableName: QT_MEDIA_BACKEND + variableValue: ffmpeg + - !include "{{qt/qtbase}}/coin_module_test_template_v3.yaml" diff --git a/coin/instructions/run_gstreamer_backend_tests.yaml b/coin/instructions/run_gstreamer_backend_tests.yaml new file mode 100644 index 0000000..62e9a74 --- /dev/null +++ b/coin/instructions/run_gstreamer_backend_tests.yaml @@ -0,0 +1,27 @@ +type: Group +enable_if: + condition: or + conditions: + - condition: runtime + env_var: TARGET_OSVERSION_COIN + # QTBUG-129469 as long as we have flaky tests, we need to disable all gstreamer tests on CI to avoid blocking + # dependency update rounds + contains_value: disabled_ubuntu + # Disabling on rhel/opensuse for now due to missing h264 codecs on CI + # - condition: runtime + # env_var: TARGET_OSVERSION_COIN + # contains_value: rhel + # - condition: runtime + # env_var: TARGET_OSVERSION_COIN + # contains_value: opensuse + +instructions: + - type: EnvironmentVariable + variableName: QT_MEDIA_BACKEND + variableValue: gstreamer + + # QTBUG-127927 + # - type: EnvironmentVariable + # variableName: G_DEBUG + # variableValue: fatal_criticals + - !include "{{qt/qtbase}}/coin_module_test_template_v3.yaml" diff --git a/coin/module_config.yaml b/coin/module_config.yaml new file mode 100644 index 0000000..6b62d8a --- /dev/null +++ b/coin/module_config.yaml @@ -0,0 +1,24 @@ +version: 2 +accept_configuration: + condition: property + property: features + not_contains_value: Disable + +instructions: + Build: + # In Qt Multimedia we want CI to always build manual tests to avoid bitrot. + - type: AppendToEnvironmentVariable + variableName: COMMON_TEST_CMAKE_ARGS + variableValue: " -DQT_BUILD_MANUAL_TESTS=ON" + + - !include "{{qt/qtmultimedia}}/configure_tests_environment_for_ffmpeg_backend.yaml" + - type: EnvironmentVariable + variableName: VERIFY_SOURCE_SBOM + variableValue: "ON" + - !include "{{qt/qtbase}}/coin_module_build_template_v2.yaml" + + Test: + - !include "{{qt/qtmultimedia}}/configure_tests_environment_for_ffmpeg_backend.yaml" + - !include "{{qt/qtmultimedia}}/run_ffmpeg_backend_tests.yaml" + - !include "{{qt/qtmultimedia}}/run_darwin_backend_tests.yaml" + - !include "{{qt/qtbase}}/coin_module_test_docs.yaml" diff --git a/config.tests/gpu_vivante/CMakeLists.txt b/config.tests/gpu_vivante/CMakeLists.txt new file mode 100644 index 0000000..84f5be9 --- /dev/null +++ b/config.tests/gpu_vivante/CMakeLists.txt @@ -0,0 +1,33 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# Generated from gpu_vivante.pro. + +cmake_minimum_required(VERSION 3.16) +project(config_test_gpu_vivante LANGUAGES C CXX) + +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH) + set(CMAKE_SYSTEM_PREFIX_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH}") +endif() +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH) + set(CMAKE_SYSTEM_FRAMEWORK_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH}") +endif() + +foreach(p ${QT_CONFIG_COMPILE_TEST_PACKAGES}) + find_package(${p}) +endforeach() + +if(QT_CONFIG_COMPILE_TEST_LIBRARIES) + link_libraries(${QT_CONFIG_COMPILE_TEST_LIBRARIES}) +endif() +if(QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS) + foreach(lib ${QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS}) + if(TARGET ${lib}) + link_libraries(${lib}) + endif() + endforeach() +endif() + +add_executable(${PROJECT_NAME} + main.cpp +) diff --git a/config.tests/gpu_vivante/main.cpp b/config.tests/gpu_vivante/main.cpp new file mode 100644 index 0000000..4786cf5 --- /dev/null +++ b/config.tests/gpu_vivante/main.cpp @@ -0,0 +1,12 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: BSD-3-Clause + +#include +#include + +const int format = GL_VIV_YV12; + +int main(int argc, char** argv) +{ + return 0; +} diff --git a/config.tests/linux_v4l/CMakeLists.txt b/config.tests/linux_v4l/CMakeLists.txt new file mode 100644 index 0000000..1ebaf3c --- /dev/null +++ b/config.tests/linux_v4l/CMakeLists.txt @@ -0,0 +1,33 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# Generated from linux_v4l.pro. + +cmake_minimum_required(VERSION 3.16) +project(config_test_linux_v4l LANGUAGES C CXX) + +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH) + set(CMAKE_SYSTEM_PREFIX_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH}") +endif() +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH) + set(CMAKE_SYSTEM_FRAMEWORK_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH}") +endif() + +foreach(p ${QT_CONFIG_COMPILE_TEST_PACKAGES}) + find_package(${p}) +endforeach() + +if(QT_CONFIG_COMPILE_TEST_LIBRARIES) + link_libraries(${QT_CONFIG_COMPILE_TEST_LIBRARIES}) +endif() +if(QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS) + foreach(lib ${QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS}) + if(TARGET ${lib}) + link_libraries(${lib}) + endif() + endforeach() +endif() + +add_executable(${PROJECT_NAME} + main.cpp +) diff --git a/config.tests/linux_v4l/main.cpp b/config.tests/linux_v4l/main.cpp new file mode 100644 index 0000000..0c468d5 --- /dev/null +++ b/config.tests/linux_v4l/main.cpp @@ -0,0 +1,9 @@ +// Copyright (C) 2016 The Qt Company Ltd and/or its subsidiary(-ies). +// SPDX-License-Identifier: BSD-3-Clause + +#include + +int main(int argc, char** argv) +{ + return 0; +} diff --git a/config_help.txt b/config_help.txt new file mode 100644 index 0000000..b2ac353 --- /dev/null +++ b/config_help.txt @@ -0,0 +1,8 @@ +Multimedia options: + + -pulseaudio .......... Enable PulseAudio support [auto] (Unix only) + -alsa ................ Enable ALSA support [auto] (Unix only) + -no-gstreamer ........ Disable support for GStreamer + -gstreamer............ Enable GStreamer support [auto] + -ffmpeg-dir .... Set FFmpeg library path + -ffmpeg-deploy ....... Enable deployment of FFmpeg libraries diff --git a/configure.cmake b/configure.cmake new file mode 100644 index 0000000..68f54ce --- /dev/null +++ b/configure.cmake @@ -0,0 +1,24 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + + + +#### Inputs + + + +#### Libraries + + + +#### Tests + + + +#### Features + + +qt_extra_definition("QT_VERSION_STR" "\"${PROJECT_VERSION}\"" PUBLIC) +qt_extra_definition("QT_VERSION_MAJOR" ${PROJECT_VERSION_MAJOR} PUBLIC) +qt_extra_definition("QT_VERSION_MINOR" ${PROJECT_VERSION_MINOR} PUBLIC) +qt_extra_definition("QT_VERSION_PATCH" ${PROJECT_VERSION_PATCH} PUBLIC) diff --git a/dependencies.yaml b/dependencies.yaml new file mode 100644 index 0000000..a2f68fa --- /dev/null +++ b/dependencies.yaml @@ -0,0 +1,13 @@ +dependencies: + ../qtbase: + ref: ef55f427f2c8b410d34f8a7681020a3000cf6866 + required: true + ../qtdeclarative: + ref: 4e3399c26ec57246c08de019cfcbda8d23604cfa + required: false + ../qtquick3d: + ref: aeab6c0ee47052a511869e82ef20da83073c3916 + required: false + ../qtshadertools: + ref: c70b59ea4a47ccbee7e0d0353b9e91d719120bfd + required: true diff --git a/dist/REUSE.toml b/dist/REUSE.toml new file mode 100644 index 0000000..6e06fc5 --- /dev/null +++ b/dist/REUSE.toml @@ -0,0 +1,8 @@ +version = 1 + +[[annotations]] +path = ["*"] +precedence = "override" +comment = "Licensed as documentation." +SPDX-FileCopyrightText = "Copyright (C) The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only" diff --git a/dist/changes-5.0.1 b/dist/changes-5.0.1 new file mode 100644 index 0000000..84935ad --- /dev/null +++ b/dist/changes-5.0.1 @@ -0,0 +1,76 @@ +Qt 5.0.1 is a bug-fix release. It maintains both forward and backward +source compatibility with Qt 5.0.0. + +However, to fix a bug we detected after the 5.0 release, this release +has a limited binary compatibility break. We therefore recommend all +users to recompile their applications that provided QtMultimedia +plugins or dealt with them directly. This is an exceptional case: +compatibility will be kept for further releases. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.0/ + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + +**************************************************************************** +* General * +**************************************************************************** + +General Improvements +-------------------- + + * Documentation: Various documentation fixes such as spelling and + snippet corrections. + + * Fixed an issue that could cause memory leak when certain objects + were destroyed. The fix for this issue required a binary + compatibility break in two classes: QAudioSystemFactoryInterface + and QMediaServiceProviderFactoryInterface. Those two classes are + used only in QtMultimedia plugins and code directly dealing with + them and recompilation is only strictly necessary for them. + +Third party components +---------------------- + +**************************************************************************** +* Library * +**************************************************************************** + + - WMF: added more metadata keys (on Windows 7 and later). + - Compile in 32-bit mode. + - remove leftover code from multimediawidgets carve-out + - WMF: release video controls before releasing the session + - WMF: Fixed uninitialized member variable. + - WMF: re-enabled video probes and made it more robust. + - [QTBUG-28376] Make QtMultimedia an identified module + - [QTBUG-28727] Doc: Moved the qdocinc and image to the sourcedirs + - Remove comma at the end of the enum + - fix include statements + - Use qrc to deploy qml files in declarative-camera examples + - [QTBUG-26621] WMF: Fixed incorrect QMediaPlayer volume reporting. + - Polish and fix qmlvideofx example + - Add qmake generated files to .gitignore. + - Example: Notify user of errors + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + +**************************************************************************** +* Compiler Specific Changes * +**************************************************************************** + + +**************************************************************************** +* Plugins * +**************************************************************************** diff --git a/dist/changes-5.0.2 b/dist/changes-5.0.2 new file mode 100644 index 0000000..53d93e6 --- /dev/null +++ b/dist/changes-5.0.2 @@ -0,0 +1,48 @@ +Qt 5.0.2 is a bug-fix release. It maintains both forward and backward +source compatibility with Qt 5.0.0 and 5.0.1. + +However, to fix a bug we detected after the 5.0 release, this release +has a limited binary compatibility break. We therefore recommend all +users to recompile their applications that provided QtMultimedia +plugins or dealt with them directly. This is an exceptional case: +compatibility will be kept for further releases. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.0/ + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + +**************************************************************************** +* General * +**************************************************************************** + +General Improvements +-------------------- + +**************************************************************************** +* Library * +**************************************************************************** + + - WMF: Enabled HW-accelerated video decoding for the QML video item. + - WMF: Fixed unresolved topologies when using the custom MediaSink. + - Disable FFT when building in static mode. + - [QTBUG-28741] Added seek() function to QML Video item. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Qt for BlackBerry +----------------- + + - Fixed playback of streamed audio. + diff --git a/dist/changes-5.1.0 b/dist/changes-5.1.0 new file mode 100644 index 0000000..937d6fa --- /dev/null +++ b/dist/changes-5.1.0 @@ -0,0 +1,38 @@ +Qt 5.1 introduces many new features and improvements as well as bugfixes +over the 5.0.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.1 + +The Qt version 5.1 series is binary compatible with the 5.0.x series. +Applications compiled for 5.0 will continue to run with 5.1. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* General * +**************************************************************************** + + - Fixed signal not being emitted in QDeclarativeCameraFocus. + - Decouple qmediametadata.h from qmultimedia.h + - Reset VideoSurface pointer when deleted + - Fix crash on idle status change with 64 bit architectures. + - Add support for m3u8 playlist formats + - Fix calculation bug in QWaveDecoder. + + - [QTBUG-28047] Make directshow-plugin available. + - [QTBUG-28589] Add error handling in image capturing in camera + - [QTBUG-30411] AVFoundation: Emit error when media fails to load + +Qt for Android +-------------- + + - Add libQt5MultimediaQuick_p to the list of dependencies. + - Fixed crash when resetting the video surface. + - Add MediaPlayer support for Android diff --git a/dist/changes-5.1.1 b/dist/changes-5.1.1 new file mode 100644 index 0000000..45fc4de --- /dev/null +++ b/dist/changes-5.1.1 @@ -0,0 +1,45 @@ +Qt 5.1.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.1.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.1/ + +The Qt version 5.1 series is binary compatible with the 5.0.x series. +Applications compiled for 5.0 will continue to run with 5.1. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Qt for Windows +-------------- + + - Use correct default audio output and input devices on Windows. + - [QTBUG-29206] DirectShow: avoid unnecessary RGB32 -> BGR32 conversion. + - [QTBUG-32282] DirectShow: Don't create the widget and renderer controls + until requested. + - [QTBUG-23822] Fix resource leak in directshow plugin. + - WMF: fixed MediaPlayer buffering logic. + +Qt for Android +-------------- + + - Fixed potential memory leak when destroying a media player. + - Fixed media player showing black frames on some hardware. + - [QTBUG-31422] Make it possible for the media player to play assets. + - Fixed Java exception being thrown at app startup when using multimedia. + +Qt for BlackBerry +----------------- + + - [QTBUG-31534] Fix frame size of video playback. diff --git a/dist/changes-5.10.0 b/dist/changes-5.10.0 new file mode 100644 index 0000000..cbdb75b --- /dev/null +++ b/dist/changes-5.10.0 @@ -0,0 +1,41 @@ +Qt 5.10 introduces many new features and improvements as well as bugfixes +over the 5.9.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.10 series is binary compatible with the 5.9.x series. +Applications compiled for 5.9 will continue to run with 5.10. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.10.0 Changes * +**************************************************************************** + + - [QTBUG-57045] Fixed crash when calling pause in the onPositionChanged + handler. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +QNX +--- + - Added support for setting audio roles. + +Linux +----- + - [QTBUG-62621] Unsupported audio formats in PulseAudio will now be rejected + instead of being played incorrectly. + - [QTBUG-63427] QSoundEffect with PulseAudio now supports 24 bit samples. + +Windows +------- + - Added support for QMediaMetaData::Orientation. diff --git a/dist/changes-5.10.1 b/dist/changes-5.10.1 new file mode 100644 index 0000000..e76dd20 --- /dev/null +++ b/dist/changes-5.10.1 @@ -0,0 +1,72 @@ +Qt 5.10.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.10.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.10 series is binary compatible with the 5.9.x series. +Applications compiled for 5.9 will continue to run with 5.10. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +This release contains all fixes included in the Qt 5.9.4 release. + +**************************************************************************** +* Qt 5.10.1 Changes * +**************************************************************************** + +QtMultimedia +------------ + +- [QTBUG-62155] Improved the quality when rendering YUVY and UYVY video frames. +- [QTBUG-43098] The alpha channel for ARGB32 video frames are now retained. +- [QTBUG-57197] Fixed media players state reporting when called in a slot. +- [QTBUG-53099] Fixed sizing issue when rendering to widgets backed by + a QOffscreenSurface. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +macOS +----- + +- [QTBUG-49558] Fixed duration updates for HTTP streams. + +PulseAudio +---------- + +- [QTBUG-65220] Fixed deadlock in QSoundEffect when using PulseAudio + +DirectShow +---------- + +- [QTBUG-59320] Made it possible to call DirectShow with only QCoreApplication. +- [QTBUG-51405] Fixed rendering of overlapping MDI subwindows. +- [QTBUG-64438] Fixed rendering of videos with pixel aspect ration other then 1:1. + +WinRT +----- + +- [QTBUG-60904] Enabled the AudioCapture backend on WinRT. + +GStreamer +--------- + +- [QTBUG-64080] Fixed camera selection logic to handle devices being + loaded and unloaded. +- [QTBUG-64155] Fixed error handling when no input device is provided. + +ALSA +---- + +- [QTBUG-63007] Improved the latency in QSoundEffect, by not querying the available + devices each time a new track got played. diff --git a/dist/changes-5.11.0 b/dist/changes-5.11.0 new file mode 100644 index 0000000..802eec7 --- /dev/null +++ b/dist/changes-5.11.0 @@ -0,0 +1,75 @@ +Qt 5.11 introduces many new features and improvements as well as bugfixes +over the 5.10.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.11 series is binary compatible with the 5.10.x series. +Applications compiled for 5.10 will continue to run with 5.11. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.11.0 Changes * +**************************************************************************** + +QtMultimedia +------------ + + - Added customAudioRole string property to enable use of audio roles + beyond those available via the audioRole enum property. + - [QTBUG-45336] Added supportedFocusModes and supportedFocusPointModes + to QML CameraFocus. + - [QTBUG-45336] Added property supportedExposureModes to CameraExposure. + - [QTBUG-47606] Added mirrored API to QVideoSurfaceFormat. + - [QTBUG-45336] Added missing capability properties to CameraImageProcessing. + - [QTBUG-65207] Fixed setting QAudioEncoderSettings::bitRate. + - [QTBUG-30728] Made it possible to receive mouse move events in QVideoWidget. + - [QTBUG-60579] Added support for changing the volume on 24-bit audio samples. + - [QTBUG-53594] Fixed target rectangle coordinates while painting image + with QPainter. + - [QTBUG-51825] Fixed error reporting when QCamera::start() fails. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +PulseAudio +---------- + + - [QTBUG-49569] Emitted QAudio::StoppedState on QAudio::OpenError. + +Gstreamer +--------- + + - Fixed udpsrc timeout setting. + - [QTBUG-23761] Fixed setting vaapi sink properties. + - [QTBUG-64142] Fixed leak in prepare-window-handle message. + +DirectShow +---------- + + - Added support for manual camera exposure control. + - Added support for setting the capture destination and format. + - Added support for video probes in the camera. + - Added camera zoom support. + - [QTBUG-55354] Setting an unsupported playback rate will now fallback to the previous set rate. + - [QTBUG-65780] Fixed blank QVideoWidget when it is paused. + - Improved matching, filter and connecting pins. + +QNX +--- + + - Added support for QNX 7.0.0 audio management. + - Implemented QCustomAudioRoleControl for QNX. + +AVFoundation +------------ + + - Added support for the buffer status. diff --git a/dist/changes-5.11.1 b/dist/changes-5.11.1 new file mode 100644 index 0000000..11421db --- /dev/null +++ b/dist/changes-5.11.1 @@ -0,0 +1,73 @@ +Qt 5.11.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.11.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.11 series is binary compatible with the 5.10.x series. +Applications compiled for 5.10 will continue to run with 5.11. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.11.1 Changes * +**************************************************************************** + +QtMultimedia +------------ + + - Made it possible for QSound to play source files using the qrc schema. + - [QTBUG-54680] Added a fix to show content + when the renderer beackend got recreated. + - [QTBUG-54262] QAudioOutput is now properly released when a new source is set. + - [QTBUG-66754] Fixed possible double release of QSoundEffect's network + access manager. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +WinRT +----- + + - [QTBUG-67614] Prevented deadlock when playing mp3 with QMediaPlayer. + - [QTBUG-67417] Fixed white screen for camera output. + - [QTBUG-63016] Avoided a crash when QImage is being destroyed within capturing. + - [QTBUG-63014] Fixed rotation of camera image. + - [QTBUG-68054] Fixed to keep camera as uninitialized when an error. + - [QTBUG-68054] Fixed a crash when using IMFMediaSink from IMFStreamSink. + +WasAPI +------ + + - [QTBUG-67353] The WasAPI backend will now always use the multithreaded + concurrency model. + +Gstreamer +--------- + + - [QTBUG-67920] Postponeed fetching supported viewfinder camerabin settings. + - [QTBUG-67706] Added better error and warning reporting in QGstreamerRecorderControl. + +WindowsAudio +------------ + + - [QTBUG-61920] Fixed adjusting volume for the default device. + +DirectShow +---------- + + - [QTBUG-64931] Fixed crackling sound when playing with a custom sample rate. + +QNX +--- + + - Switched WindowGrabber to a private parent window. diff --git a/dist/changes-5.11.2 b/dist/changes-5.11.2 new file mode 100644 index 0000000..a3bc3b2 --- /dev/null +++ b/dist/changes-5.11.2 @@ -0,0 +1,61 @@ +Qt 5.11.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.11.0 through 5.11.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.11 series is binary compatible with the 5.10.x series. +Applications compiled for 5.10 will continue to run with 5.11. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.11.2 Changes * +**************************************************************************** + + - [QTBUG-66910] Fixed warning on deleteLater on nullptr in QSampleCache. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-60884] Setting a custom video source through QT_GSTREAMER_CAMERABIN_VIDEOSRC + will now use gst_parse_launch(). + - [QTBUG-69468] gst_bus_remove_watch() will now be used if available. + - [QTBUG-69895] The video profile is now correctly set before CamerBin enters GST_STATE_READY. + - Fixed crash when resolution or frame rates are requested on an unloaded camera. + +Directshow +---------- + + - Removed reporting of failure for stream source with no video output. + - [QTBUG-69143] Postponed setting camera image processing param if not ready. + - [QTBUG-68035] Added a notification if camera has been unplugged. + +WinRT +----- + + - [QTBUG-67417] Obtained new camera sample format and size on camera change. + +AVFoundation +------------ + + - [QTBUG-65740] Fixed crash when no video capture device. + - [QTBUG-69076] Fixed linker error when building Qt without opengl support. + - Improved how context sharing is set-up in frame renderer. + +Android +------- + + - [QTBUG-68998] Fixed the player state when play() is called with no media. diff --git a/dist/changes-5.11.3 b/dist/changes-5.11.3 new file mode 100644 index 0000000..39f8d60 --- /dev/null +++ b/dist/changes-5.11.3 @@ -0,0 +1,58 @@ +Qt 5.11.3 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.11.0 through 5.11.2. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.11 series is binary compatible with the 5.10.x series. +Applications compiled for 5.10 will continue to run with 5.11. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.11.3 Changes * +**************************************************************************** + + - [QTBUG-51064] Added OpenGL core profile support to QtMultimediaQuickTools. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-50539] Fixed setting http/rtsp url on the media player. + - [QTBUG-70653] Fixed crash when play() is called prior to a state being set. + +DirectShow +---------- + + - [QTBUG-70932] Fixed crash when the camera got destroyed.. + - [QTBUG-70672] Fixed crash when no resources could be created. + +QNX +--- + + - Retrieved some information from the track metadata if available. + - Fixed video window parenting and positioning. + +PulseAudio +---------- + + - [QTBUG-69734] Fixed crash when stop() is called while reading buffers. + +Gstreamer +--------- + + - [QTBUG-63517] Fixed tst_QMediaPlayerBackend to make it pass. diff --git a/dist/changes-5.12.0 b/dist/changes-5.12.0 new file mode 100644 index 0000000..e775f19 --- /dev/null +++ b/dist/changes-5.12.0 @@ -0,0 +1,59 @@ +Qt 5.12 introduces many new features and improvements as well as bugfixes +over the 5.11.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.12.0 Changes * +**************************************************************************** + + - [QTBUG-52114] Interpreted ARGB32 as premultiplied for GraphicsVideoItem. + + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-39327] Added an ability to pass custom pipeline and video sink. + Also registered "qtvideosink" gstreamer element to be used in pipelines. + - [QTBUG-69402] Emitted stateChanged(StoppedState) when recording is finished. + +WindowsAudio +------------ + + - [QTBUG-63492] Fixed crackling at the end of playback. + - [QTBUG-45174] Introduced QT_WAVE_BUFFERS env var to define numbers of buffers. + +DirectShow +---------- + + - [QTBUG-32743] Implemented image capture settings. + - [QTBUG-53019] Added option to allow building without evr support. + The environment variable QT_DIRECTHSOW_NO_EVR can now be used to disable EVR at runtime. + +Android +------- + + - [QTBUG-61115] Implemented QMediaPlayer::setPlaybackRate(). + +IMX +--- + + - [QTBUG-50927] Copied data and uploaded back if mapping has not succeeded. diff --git a/dist/changes-5.12.1 b/dist/changes-5.12.1 new file mode 100644 index 0000000..6aa1c02 --- /dev/null +++ b/dist/changes-5.12.1 @@ -0,0 +1,68 @@ +Qt 5.12.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.12.1 Changes * +**************************************************************************** + + - [QTBUG-54901 Fixed QCamera to return ServiceMissingError + if no camera can be found by name. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-51769] Fixed camera example to apply video settings. + - [QTBUG-64178] Fixed compilation error + if GST_VIDEO_REGION_OF_INTEREST_META_INFO is not available. + - Added fix to avoid creating video profile if no codec provided. + - Added fix to build gstreamer on Windows and MSVC. + +CoreAudio +--------- + + - [QTBUG-63492] Added logic to decrease volume when playback is stopped + to avoid popping noise. + +DirectShow +---------- + + - [QTBUG-68768] The camera will now use the pixel format requested by + QCameraViewFinderSettings, if supported, instead of defaulting to RGB32. + - [QTBUG-71851] Added fix to display windows error string when camera fails. + - [QTBUG-42057] Added fix to restart an inactive surface when a new frame is received. + - [QTBUG-72012] Added fix to keep the last video buffer from sample grabber. + +Alsa +---- + + - Fixed QSoundEffect to prevent openning a device twice. + +Windows +------- + + - [QTBUG-71326] Added fix to repaint QVideoWidget when WM_PAINT or WM_ERASEBKGND received. + +WMF +--- + + - [QTBUG-72287] Mapped PKEY_Media_EncodingSettings to QMediaMetaData::Description. diff --git a/dist/changes-5.12.2 b/dist/changes-5.12.2 new file mode 100644 index 0000000..c67fb9c --- /dev/null +++ b/dist/changes-5.12.2 @@ -0,0 +1,45 @@ +Qt 5.12.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0 through 5.12.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.12.2 Changes * +**************************************************************************** + +- Fixed a crash in the media player when an application is exited while a media player is still playing. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-39327] Introduced possibility to set custom pipeline using gst-pipeline url scheme. + +Android +------- + + - [QTBUG-67280] Fixed memory leak of GL resources when DeferredDelete event is not delivered. + +DirectShow +---------- + + - [QTBUG-73461] Fixed a crash when camera is being destroyed. diff --git a/dist/changes-5.12.3 b/dist/changes-5.12.3 new file mode 100644 index 0000000..f306ef2 --- /dev/null +++ b/dist/changes-5.12.3 @@ -0,0 +1,40 @@ +Qt 5.12.3 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0 through 5.12.2. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.12.3 Changes * +**************************************************************************** + +- Fixed QCameraInfo to be invalid if camera failed to find device. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-73557] Fixed setting surface from current renderer after changing the pipeline. + + WinRT + ----- + + - [QTBUG-72874] Fixed camera preview/image capture to use highest supported resolution. diff --git a/dist/changes-5.12.4 b/dist/changes-5.12.4 new file mode 100644 index 0000000..e9e1a73 --- /dev/null +++ b/dist/changes-5.12.4 @@ -0,0 +1,57 @@ +Qt 5.12.4 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0 through 5.12.3. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.12.4 Changes * +**************************************************************************** + +- [QTBUG-57836] Fixed QGraphicsVideoItem to always use the generic painter + when no gl paint engine is available. +- [QTBUG-74277] Fixed usage of makeCurrent in QPainterVideoSurface. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- Android: + * [QTBUG-73582] Fixed QMediaRecorder's status changes after start/stop. + * [QTBUG-73582] The camera's stateChanged signal is now immediately sent + regardless of the current activity state. + * [QTBUG-73582] Fixed the camera to prevent it from opening the same device twice. + * [QTBUG-73237] Added support for starting the camera without an available viewfinder. + +- AVFoundation: + * [QTBUG-75285] Fixed the usage of $PRODUCT_NAME in the Info.plist to only be used + with the macx-xcode spec. + +- GStreamer: + * [QTBUG-75314] The pipeline will now be reset to GST_STATE_PAUSED instead of + GST_STATE_NULL after EndIfStream. + * [QTBUG-72468] Fixed deadlock when the state of the pipeline is requested in ASYNC mode. + * Added a possibility to use streams in the player's custom pipeline + if it contains an appsrc element. + * Added dumping of dot file of the player's pipeline if GST_DEBUG_DUMP_DOT_DIR is set. + +- DirectShow: + * [QTBUG-65574] Fixed the media player to prevent updating the status + when there are no finished tasks. + * [QTBUG-65574] Removed the start/end times in QVideoFrame. + * [QTBUG-65574] Fixed the player to return an error for invalid urls. diff --git a/dist/changes-5.12.5 b/dist/changes-5.12.5 new file mode 100644 index 0000000..34cf7ee --- /dev/null +++ b/dist/changes-5.12.5 @@ -0,0 +1,35 @@ +Qt 5.12.5 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0 through 5.12.4. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + - This release contains only minor code improvements. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- GStreamer: + * Added "audio/x-raw" codec to use "audio/x-wav" container in QAudioRecorder. + * Fixed bug where a player, without its own video surface, would end up using + another players video surface. + * [QTBUG-65399] Added fix to prevent seeking to the beginning when playback + is started. + +- AVFoundation: + * [QTBUG-77270] Added fix to avoid showing black frames when the current + OpenGL context changes. diff --git a/dist/changes-5.13.0 b/dist/changes-5.13.0 new file mode 100644 index 0000000..44a45a8 --- /dev/null +++ b/dist/changes-5.13.0 @@ -0,0 +1,64 @@ +Qt 5.13 introduces many new features and improvements as well as bugfixes +over the 5.12.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.13 series is binary compatible with the 5.12.x series. +Applications compiled for 5.12 will continue to run with 5.13. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.13.0 Changes * +**************************************************************************** + +- [QTBUG-63596] Added support for selecting the output device used by QSoundEffect. +- [QTBUG-28850] QMediaResource class is now deprecated. +- [QTBUG-37301] Added flushMode property to QML VideoOutput element to define + what should be shown when flush is requested. +- Fixed QCameraInfo::defaultCamera() to return first non-empty name. +- Introduced QVideoFrame::buffer() to get access to the video buffer. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + - Android: + * [QTBUG-73119] Implemented audio roles. + * [QTBUG-69968] Changed video frame format from BGR32 to ABGR32. + * [QTBUG-74073] Introduced HTTP headers to MediaPlayer. + * [QTBUG-73583] Fixed a crash when the audio output is unable to get the min buffer size. + + - Windows: + * [QTBUG-32783] Removed -mediaplayer-backend config param which allowed + to build wmf together with DirectShow. + * [QTBUG-71610] The surface is now stopped when EndOfStream is received. + * [QTBUG-66526] Moved parsing of metadata to worker thread. + * [QTBUG-56400] Added QT_MULTIMEDIA_PREFERRED_PLUGINS to + specify preferred plugins if multiple backends are available. + * DircetShow or WMF can now be disabled by -no-directshow or -no-wmf + within configuring. + * [QTBUG-71819] Fixed video and audio probes in media player. + * [QTBUG-74180] Fixed to avoid setting camera zoom to 1x on restart when it is not requested. + * [QTBUG-75024] Fixed to avoid setting volume to 100% on restart when it is not requested. + * [QTBUG-65574] Fixed bug in EVR to prevent repainting with black + when the surface is not active. + * Now position of QMediaPlayer should be reset on pause after EOS. + + - GStreamer: + * [QTBUG-65402] Added fix to avoid appending a second extension to the file name, + if it already contains one. + * [QTBUG-72125] Add support for ksvideosrc and avfvideosrc within camerabin. + * Enabled gstreamer support by default for Windows and macOS. + * Added support of video orientation metadata. + * Now GstBuffer could be retrieved from QGstVideoBuffer. + + - PulseAudio: + * [QTBUG-71710] Introduced QT_PA_CHANNEL_MAP for QAudioOutput. diff --git a/dist/changes-5.13.1 b/dist/changes-5.13.1 new file mode 100644 index 0000000..78a7243 --- /dev/null +++ b/dist/changes-5.13.1 @@ -0,0 +1,46 @@ +Qt 5.13.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.13.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.13 series is binary compatible with the 5.12.x series. +Applications compiled for 5.12 will continue to run with 5.13. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.13.1 Changes * +**************************************************************************** + +- [QTBUG-76090] Fixed crash when an app is destroyed before QSample::load finishes. +- [QTBUG-76205] Added fix to only update the VideoOutput's geometry when the surface is active. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + - DirectShow: + * [QTBUG-65574] Added error when attempting to play a video without a video output set. + * [QTBUG-65574] Added fix to prevent the same media content from being set twice. + * [QTBUG-65574] Returns QMediaPlayer::NoMedia if an empty url is provided. + * [QTBUG-75959] Mapped MEDIASUBTYPE_RGB24 to QVideoSurfaceFormat::Format_BGR24. + * [QTBUG-70655] Fixed build issues with newer MinGW versions. + * Fixed memory leak introduced by using GetFrameRateList. + + - AVFoundation: + * [QTBUG-75287] QMediaRecorder will now only send state changes when the state actually changes. + + - GStreamer: + * [QTBUG-76236] Now busy cameras are also returned in availableCameras. + * Fixed a crash when the bus helper is destroyed but is still receiving events. + * GstUDPSrc caps can now be passed via the url's query item. + * Added implementation for fetching audio/video codecs by container and vice versa. diff --git a/dist/changes-5.13.2 b/dist/changes-5.13.2 new file mode 100644 index 0000000..a132744 --- /dev/null +++ b/dist/changes-5.13.2 @@ -0,0 +1,68 @@ +Qt 5.13.2 is a bug-fix release. It maintains both forward and backward +source compatibility with Qt 5.13.0 through 5.13.1. +In Qt 5.13.0, binary compatibility was broken due to the usage of the enum +QVideoSurfaceFormat::PixelFormat, the break has been reverted, +thus introducing a binary compatibility break with earlier Qt 5.13.0 and 5.13.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.13 series is binary compatible with the 5.12.x series. +Applications compiled for 5.12 will continue to run with 5.13. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.13.2 Changes * +**************************************************************************** + + - In Qt 5.13.0 binary compatibility was broken + for usage of the enum QVideoSurfaceFormat::PixelFormat by introducing + QVideoSurfaceFormat::Format_ABGR32. + To minimize the impact of this, the break has been reverted, + thus introducing a binary compatibility break with earlier Qt 5.13.x + versions, but restoring compatibility with all earlier versions of Qt 5. + - Fixed crash when VideoOutput.sourceRect is requested but playback is stopped. + - [QTBUG-51588] Fixed leaking of QVideoFilterRunnable when window is closed. + - [QTBUG-45064] Introduced QGraphicsVideoItem::type(). + - Fixed camera.viewfinder to respect camera's media status + if the viewfinder is requested after the camera is loaded. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + - GStreamer: + * CameraBin plugin now fetches supported viewfinder settings at status + higher or equal to LoadedStatus if it has not been fetched. + * Fixed duplicated entries in supported Camera's resolution/framerate if the + underlying element uses caps' features. + * Introduced audio/x-raw codec in QAudioRecorder. + * [QTBUG-65399] Fixed media player to show pre-rolled frame on new media + (means to seek to the beginning) only when pause() is called. + * [QTBUG-76135] Show image processing warnings only when the camera is loaded. + * [QTBUG-78079] Fixed media player to recreate playbin features after custom pipeline. + * [QTBUG-73084] Fixed mapping of VPU texture using real physical address of data + which prevents leaks in the kernel for iMX boards. + + - AVFoundation: + * [QTBUG-77270] Fixed black frames being shown if current OpenGL context has been changed. + * [QTBUG-49806] Fixed media player to send StalledMedia status when no enough data to play + and resume playback afterwards. + + - DirectShow: + * [QTBUG-77829] Fixed crash when there is no surface on flush(). + * [QTBUG-77849] Introduced startTime and endTime to QVideoFrame. + * [QTBUG-77163] Introduced support to use QMediaPlayer in secondary thread. + * [QTBUG-46368] Implemented QMediaVideoProbeControl->flush(). + * [QTBUG-46368] Fixed media player to send media status before errors. + * [QTBUG-68778] Fixed media player to postpone seeking if the playback is stopped. + * Fixed crash when qrc media resource is set twice to media player. diff --git a/dist/changes-5.14.0 b/dist/changes-5.14.0 new file mode 100644 index 0000000..fb4f46b --- /dev/null +++ b/dist/changes-5.14.0 @@ -0,0 +1,54 @@ +Qt 5.14 introduces many new features and improvements as well as bugfixes +over the 5.13.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.14 series is binary compatible with the 5.13.x series. +Applications compiled for 5.13 will continue to run with 5.14. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.14.0 Changes * +**************************************************************************** + + - [QTBUG-73878] Removed the Mir client code as it is no longer used. + - Added QVideoSurfaceFormat::Format_YUV422P. + - Deprecated canonicalUrl and canonicalRequest in QMediaContent. + - [QTBUG-74422] Moved dtors of QCameraExposure, QCameraFocus, + QCameraImageProcessing from private to protected. + - [QTBUG-75781] QAudioDeviceInfo::realm() is moved from private to public. + - [QTBUG-77630] QMediaServicePrivate is now inherited from QObjectPrivate. + - [QTBUG-75943] Qt Audio Engine QML types are now deprecated. + QMediaServiceProviderPlugin, QMediaServiceProviderHint, QMediaServiceProvider, + QMediaServiceProviderPlugin, QMediaServiceSupportedFormatsInterface, + QMediaServiceSupportedDevicesInterface,QMediaServiceDefaultDeviceInterface, + QMediaServiceCameraInfoInterface, QMediaServiceFeaturesInterface, + QRadioTuner, QRadioData + classes are now deprecated. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + - GStreamer: + * [QTBUG-65398] Stopping a camera will now be postponed until the pipeline is ready. + * [QTBUG-66162] Introduced support of OpenGL plugin. + * The media player will no longer send an EOS signal for sequential devices when read() returns 0. + * [QTBUG-78855] Fixed wrong texture format being used on iMX. + * [QTBUG-72125] Added GStreamer support for Android. + + - AVFoundation: + * [QTBUG-67985] Fixed the front camera to use 270 instead of 90 orientation. + + - Android: + * [QTBUG-70368] Added SL_ANDROID_RECORDING_PRESET_VOICE_COMMUNICATION support. + * [QTBUG-69333] Fixed crash when fetching video frame data from the GUI thread. + * [QTBUG-79909] Fixed crash when audio recording permission is asked on active camera. diff --git a/dist/changes-5.14.1 b/dist/changes-5.14.1 new file mode 100644 index 0000000..877e778 --- /dev/null +++ b/dist/changes-5.14.1 @@ -0,0 +1,25 @@ +Qt 5.14.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.14.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.14 series is binary compatible with the 5.13.x series. +Applications compiled for 5.13 will continue to run with 5.14. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- WebGL: + * [QTBUG-79181] Fixed video rendering for WebGL on iMX platforms. diff --git a/dist/changes-5.14.2 b/dist/changes-5.14.2 new file mode 100644 index 0000000..ad36891 --- /dev/null +++ b/dist/changes-5.14.2 @@ -0,0 +1,45 @@ +Qt 5.14.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.14.0 through 5.14.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.14 series is binary compatible with the 5.13.x series. +Applications compiled for 5.13 will continue to run with 5.14. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- Android: + * [QTBUG-81006] Fixed issue when multimedia plugins were not loaded. + * [QTBUG-59517] Fixed to prevent multiple copies of one tmp file + when playing video from qrc. + +- GStreamer: + * [QTBUG-81075] Fixed creating incorrect encoding profile + to avoid errors when the media container is not supported + in the video recorder. + * Fixed to have separate resolution settings for capturing and + camera's viewfinder. + +- AVFoundation: + * [QTBUG-81048] Fixed applying viewfinder settings when starting the camera. + * [QTBUG-79935] Fixed applying viewfinder settings for iOS. + * [QTBUG-81804] Removed usage of deperecated AVPlayerItem::seekToTime::CMTime. + * [QTBUG-81912] Fixed to resume playback after a stalled buffer + only if it was already in playing state. + * [QTBUG-65536] Fixed to have proper size bounds when resizing the window + while playing video. + * [QTBUG-82542] Fixed content flickering on resize for video player. + * [QTBUG-82264] Fixed to use only video surface's supported pixel formats in Camera. diff --git a/dist/changes-5.15.0 b/dist/changes-5.15.0 new file mode 100644 index 0000000..d4a42d6 --- /dev/null +++ b/dist/changes-5.15.0 @@ -0,0 +1,57 @@ +Qt 5.15 introduces many new features and improvements as well as bugfixes +over the 5.14.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.15 series is binary compatible with the 5.14.x series. +Applications compiled for 5.14 will continue to run with 5.15. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Deprecation Notice * +**************************************************************************** + + - Functions taking or returning QNetworkConfiguration have been + deprecated. + - QCamera::error() (the signal) is deprecated; superseded by + errorOccurred() + - Camera::error() signal is deprecated in favor of errorOccurred(). + - [QTBUG-75943] QMediaService and QMediaControl classes are now + deprecated. + +**************************************************************************** +* Qt 5.15.0 Changes * +**************************************************************************** + + - Introduced QVideoFrame::image() to return an image based on the frame. + - [QTBUG-80431] Introduced videoSurface property to QVideoWidget, + QGraphicsVideoItem and QDeclarativeVideoOutput. + - [QTBUG-80431] Introduced QVideoWidget::videoSurface(), + QGraphicsVideoItem::videoSurface(), QDeclarativeVideoOutput::videoSurface(). + - [QTBUG-32939] Introduced rendering to multiple surfaces. + - [QTBUG-32939] Introduced MediaPlayer::videoOutput property. + - [QTBUG-81902] Removed usage of QGL* APIs. + - [QTBUG-82299] Added flushMode to Video QML element. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- GStreamer: + * Added watching for zoom and max-zoom property changes in CameraBin. + * Introduced reverse playback. + +- AVFoundation: + * Added watching for QAbstractVideoSurface::supportedFormatsChanged + in the media player to enable gl if the surface starts to support it. + * [QTBUG-69101] Introduced adoption of AVAssetResourceLoaderDelegate protocol. + * [QTBUG-68779] Added QVideoWindowControl implementation, now it is used + by default for QVideoWidget instead of QVideoWidgetControl. diff --git a/dist/changes-5.15.1 b/dist/changes-5.15.1 new file mode 100644 index 0000000..d7ec2c5 --- /dev/null +++ b/dist/changes-5.15.1 @@ -0,0 +1,45 @@ +Qt 5.15.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.15.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.15 series is binary compatible with the 5.14.x series. +Applications compiled for 5.14 will continue to run with 5.15. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.15.1 Changes * +**************************************************************************** + +- [QTBUG-85202] QMemoryVideoBuffer is not mapped when there is no data inside. +- [QTBUG-52455] QVideoSurfaceFormat::Format_Y8 is mapped to QImage::Format_Grayscale8. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- AVFoundation: + * Fixed playback of files with spaces in their names. + * [QTBUG-83776] If just list of devices are requested, + audio session categories are not applied. + +- GStreamer: + * [QTBUG-85545] Fixed to update a render rect only for glimagesink. + * [QTBUG-84556] Fixed regression where the playback did not start + after data is buffered. + * [QTBUG-83663] Removed a dependency to gstreamer_imxcommon. + * [QTBUG-76179] Introduced QT_GSTREAMER_PLAYBIN_CONVERT to inject + a converter in playbin. + * Fixed to keep only one frame in vivante video node for iMX devices. + This fixes jerky playback when frames are not coming at constant rate. + * [QTBUG-83945] Fixed reverse playback. diff --git a/dist/changes-5.15.2 b/dist/changes-5.15.2 new file mode 100644 index 0000000..2dfc02b --- /dev/null +++ b/dist/changes-5.15.2 @@ -0,0 +1,29 @@ +Qt 5.15.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.15.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + https://doc.qt.io/qt-5.15/index.html + +The Qt version 5.15 series is binary compatible with the 5.14.x series. +Applications compiled for 5.14 will continue to run with 5.15. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +AVFoundation: + - [QTBUG-85470] Fixed the capture signal emission. CaptureToBuffer, + and CaptureToFile will now emit imageAvailable, and imageSaved, respectively. + Additionally imageCaptured will now only be emitted if there is a video + frame available. + diff --git a/dist/changes-5.2.0 b/dist/changes-5.2.0 new file mode 100644 index 0000000..e485659 --- /dev/null +++ b/dist/changes-5.2.0 @@ -0,0 +1,86 @@ +Qt 5.2 introduces many new features and improvements as well as bugfixes +over the 5.1.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.2 + +The Qt version 5.2 series is binary compatible with the 5.1.x series. +Applications compiled for 5.1 will continue to run with 5.2. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* General * +**************************************************************************** + + - Improved ALSA implementation of the audio APIs. + - Improved WAV support in QSoundEffect. + - New resource policy plugin based on libresourceqt. + - Fix QVideoSurfaceArbFpPainter mistakenly failing to start in some cases. + - Improved QAudioRecorder implementation on Windows and Mac OS. + - Various documentation fixes. + - Improved audiorecorder example. + - [QTBUG-32487] Make PulseAudio implementation of QSoundEffect more robust. + - [QTBUG-32882] Enable QSoundEffect with loopCount of Infinite to play. + - [QTBUG-31731] WMF and GStreamer: fixed incorrect frame startTime and endTime. + - [QTBUG-30442] VideoOutput: take the video format's scanLineDirection into account. + - [QTBUG-34125] Correctly clear the current media in Audio and MediaPlayer qml elements. + +Qt for Android +-------------- + + - New OpenSL ES plugin for low-latency audio support on Android. + - New camera support on Android. + - Improved video renderering with Qt Quick. + - Camera and recording permissions are now automatically added when using QtMultimedia on Android. + - [QTBUG-32635] Fixed media player buffering logic. + - [QTBUG-34558] Fix two race conditions in the media player. + +Qt for iOS +---------- + + - New media player and basic camera support on iOS. + +Qt for BlackBerry +----------------- + + - Fix setting a URL containing reserved characters on a media player. + - Enable camera on the Playbook. + - New QAudioRecorder support. + - Fix video recording with BB 10.2. + - Improve camera focus handling. + - Fixed pixel aspect ratio for video windows. + - [QTBUG-33739] Fix camera viewfinder. + +Qt for Windows +-------------- + + - WMF: emit positionChanged() signal when reaching the end of a media. + - [QTBUG-30776] DirectShow: improve metadata support. + - [QTBUG-33631][QTBUG-33518] WMF: allow to load media whose content doesn't match its file extension. + - [QTBUG-33518] WMF: allow to load QRC files with QAudioDecoder. + - [QTBUG-30435] WMF: fixed the media player failing to play some media formats. + - [QTBUG-32360] WMF: fixed compilation with Visual Studio 2008. + - [QTBUG-34479] DirectShow: fixed compilation with Visual Studio 2008. + - [QTBUG-32864] WMF: fixed compilation on Windows Vista. + - [QTBUG-30825] WMF: fixed QMediaPlayer changing to EndOfMedia status too early. + - [QTBUG-33160] Fix QAudioOutput::setVolume() limited to 50% on 32-bit Windows. + +Qt for QNX +---------- + + - New camera and media player support when mmrenderer is available. + +**************************************************************************** +* Plugins * +**************************************************************************** + + - New QML import version QtMultimedia 5.2 adds a new autoOrientation + property to the VideoOutput type, which allows the video output to + always match the screen orientation. diff --git a/dist/changes-5.2.1 b/dist/changes-5.2.1 new file mode 100644 index 0000000..17a39e6 --- /dev/null +++ b/dist/changes-5.2.1 @@ -0,0 +1,35 @@ +Qt 5.2.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.2.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.2 + +The Qt version 5.2 series is binary compatible with the 5.1.x series. +Applications compiled for 5.1 will continue to run with 5.2. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Android: + * [QTBUG-31422] The mediaplayer can now read files from the Qt + Resource system. + * [QTBUG-35416] QVideoProbe is now functional when used with a camera + source + * [QTBUG-35086] Fixed VideoOutput not showing video frames in the + correct orientation when used with a Camera. + * [QTBUG-35868] Multiple MediaPlayer elements now show correct video + frames when playing simultaneously. diff --git a/dist/changes-5.3.1 b/dist/changes-5.3.1 new file mode 100644 index 0000000..e83a219 --- /dev/null +++ b/dist/changes-5.3.1 @@ -0,0 +1,61 @@ +Qt 5.3.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.3.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.3 + +The Qt version 5.3 series is binary compatible with the 5.2.x series. +Applications compiled for 5.2 will continue to run with 5.3. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Importing QtMultimedia in QML with the 5.3 version number is now + correctly recognized. + - [QTBUG-38218][QTBUG-30447] VideoOutput (QML): Fix garbled rendering of + video frames when the stride is not equal to the width. + - [QTBUG-38755] Fixed parsing PLS playlist files when the system's locale + is not English. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - A media player's volume is now preserved when loading a new media. + - QMediaPlayer can now play Qt resource files on Android 4.1 and lower. + - [QTBUG-39015] Fixed sound being in rare occasions garbled when playing + audio with QAudioOutput and QSoundEffect. + - [QTBUG-39346] QMediaPlayer and the corresponding QML types can now play + files located in the application private storage, such as temporary + files. + +Linux +----- + + - [QTBUG-39202] Fixed crash on application startup when using a static + version of Qt. + - [QTBUG-38465] Fixed media player dropping a lot of frames when playing a + live stream. + +Windows +------- + + - [QTBUG-39202] Fixed crash on application startup when using a static + version of Qt. diff --git a/dist/changes-5.3.2 b/dist/changes-5.3.2 new file mode 100644 index 0000000..b427bb8 --- /dev/null +++ b/dist/changes-5.3.2 @@ -0,0 +1,65 @@ +Qt 5.3.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.3.0 and 5.3.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.3 + +The Qt version 5.3 series is binary compatible with the 5.2.x series. +Applications compiled for 5.2 will continue to run with 5.3. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Fixed regression causing videos recorded with the camera not to be registered with the Android + media scanner, making them invisible to media browsing apps. + - Fixed crash when unloading a QCamera while a recording is active. + - [QTBUG-39307] Setting camera parameters on the QML Camera type (e.g. digitalZoom, flashMode) + now works correctly when set before the camera is loaded. + - [QTBUG-40208] QAudioOutput::setNotifyInterval() can now be used when the output is active. + - [QTBUG-40274] Fixed metadata not being loaded by the MediaPlayer when playing a remote media, + from a qrc file or from assets. + +iOS +--- + + - [QTBUG-39036] Audio played using SoundEffect or QAudioOutput is now correctly muted when the + device is set to silent mode or when the screen is locked. + - [QTBUG-39385] The last video frame displayed in a QML VideoOutput doesn't remain on screen + anymore after destroying the VideoOutput. + +Linux +----- + + - MediaPlayer's loops property now works correctly when playing a media from a qrc file. + - [QTBUG-29742] Fixed Qt apps hanging when audio APIs are used and PulseAudio is not running. + - [QTBUG-39949] Fixed QMediaRecorder::setOutputLocation() not working with QUrl::fromLocalFile(). + +OS X +---- + + - Application doesn't freeze anymore when changing the system audio output device while audio + is being played with QSoundEffect or QAudioOutput. + - [QTBUG-38666] Video frames are now correctly positioned on screen when playing a live stream + in a QVideoWidget. This also applies to iOS. + - [QTBUG-38668] Fixed crash when setting QMediaRecorder's output location to a URL containing + nonstandard characters. + +Windows +------- + + - The DirectShow camera backend has been almost entirely rewritten. It doesn't provide any new + feature but it now works as it should. diff --git a/dist/changes-5.4.0 b/dist/changes-5.4.0 new file mode 100644 index 0000000..543638e --- /dev/null +++ b/dist/changes-5.4.0 @@ -0,0 +1,111 @@ +Qt 5.4 introduces many new features and improvements as well as bugfixes +over the 5.3.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.4 + +The Qt version 5.4 series is binary compatible with the 5.3.x series. +Applications compiled for 5.3 will continue to run with 5.4. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Important Behavior Changes * +**************************************************************************** + + - Using QAudioOutput and QSoundEffect with the PulseAudio backend won't + cause the system volume to be automatically changed to the maximum value + anymore. Audio streams will now respect the system-wide volume unless + explicitly set with setVolume(). + - On Linux, both Alsa and PulseAudio backends are now present. PulseAudio + is used by default if available on the system and if the server is + running, otherwise Alsa is used instead. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Added new QAbstractPlanarVideoBuffer class. + + - Camera (QML): + * Added deviceId, displayName, position, orientation, metadata, + viewfinder.resolution, viewfinder.minimumFrameRate and + viewfinder.maximumFrameRate properties. + * Camera device can be selected by setting the deviceId or position + properties. + * + + - QtMultimedia global QML object: + * Added defaultCamera and availableCameras properties. + + - QAbstractVideoBuffer: + * Added mapPlanes() function. + + - QVideoFrame: + * Added support for planar video formats. New planeCount(), + bytesPerLine(int plane) and bits(int plane) functions. + + - [QTBUG-40515] Improved PLS parser. It is now more permissive, allowing + to load virtually any kind of PLS file. It also correctly resolve + relative paths. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Changing a media player's position after reaching the end of a media + now correctly works. + - [QTBUG-40314] Fixed playing a QMediaPlaylit with a QMediaPlayer. + +Linux +----- + + - Added support for QCameraInfo::position() and QCameraInfo::orientation(). + - Added support for QCameraFocus::customFocusPoint. + - QMediaRecorder::duration() now returns the correct value when recording + with a camera source. + - QMediaMetaData::ContributingArtist and QMediaMetaData::AlbumArtist + now map to the correct metadata. + - Fixed QMediaPlayer's metaDataAvailableChanged() signal, which was never + emitted. + +OS X +---- + + - OS X 10.6 not being supported anymore, the QuickTime backend has been + removed. + +QNX +--- + + - [QTBUG-40746] Fixed crash when detroying a QML VideoOutput or Video item. + +Windows +------- + + - [QTBUG-32481] Fixed various memory leaks when using a media player. + - [QTBUG-39980] Fixed crash occasionally happening when playing and + stopping repeatedly a media with QMediaPlayer. + - [QTBUG-40954] Buffers retrieved with QAudioProbe now have a correct + startTime(). + - [QTBUG-41158] Fixed crash occasionally happening when destroying a + QML MediaPlayer. + +WinRT +----- + + - Enabled media player support for WinRT. + - Enabled basic camera support for WinRT (viewfinder, still image capture + and camera device selection). diff --git a/dist/changes-5.4.1 b/dist/changes-5.4.1 new file mode 100644 index 0000000..7175885 --- /dev/null +++ b/dist/changes-5.4.1 @@ -0,0 +1,49 @@ +Qt 5.4.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.4.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.4 + +The Qt version 5.4 series is binary compatible with the 5.3.x series. +Applications compiled for 5.3 will continue to run with 5.4. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - VideoOutput's autoOrientation property now correctly works after + switching cameras. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-42159] QAudioInput::setVolume() is now functioning. + +Linux +----- + + - [QTBUG-43514] Fixed static linking. + + WinRT +----- + + - [QTBUG-41066] Fix VideoOutput autoOrientation when used with a Camera. + - [QTBUG-41065] Show Camera viewfinder frames in a resolution adapted to + the current capture mode. diff --git a/dist/changes-5.4.2 b/dist/changes-5.4.2 new file mode 100644 index 0000000..07e5530 --- /dev/null +++ b/dist/changes-5.4.2 @@ -0,0 +1,64 @@ +Qt 5.4.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.4.0 and 5.4.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.4 + +The Qt version 5.4 series is binary compatible with the 5.3.x series. +Applications compiled for 5.3 will continue to run with 5.4. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - QCameraInfo::availableCameras() and QtMultimedia.availableCameras (QML) + now return an up-to-date list when a camera is added or removed from the + system. + - Fixed memory leak in QMediaPlaylist::load(). + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-37525] Fixed VideoOutput not working on some devices when used + with a Camera. + - [QTBUG-44383] Fixed setting a URL with special characters on a + MediaPlayer. + +iOS +--- + + - [QTBUG-44790] Fixed crash when using QAudioOutput/QAudioInput on iOS 5. + - [QTBUG-45659] Using QCamera doesn't always prompt for microphone + permission anymore, it now only does so when using the CaptureVideo mode. + +Linux +----- + + - [QTBUG-42326] Fixed regression causing software devices to not be + included in QAudioDeviceInfo::availableDevices() when using the ALSA + backend. + +Windows +------- + + - [QTBUG-32746] QMediaPlayer doesn't resume playback anymore when seeking + an audio media while paused. + - [QTBUG-42648] Greatly improved QAudioDeviceInfo supported formats detection. + - [QTBUG-44305] QAudioDeviceInfo: Fixed memory leak in availableDevices(). diff --git a/dist/changes-5.5.0 b/dist/changes-5.5.0 new file mode 100644 index 0000000..14b9cc0 --- /dev/null +++ b/dist/changes-5.5.0 @@ -0,0 +1,118 @@ +Qt 5.5 introduces many new features and improvements as well as bugfixes +over the 5.4.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://doc.qt.io/qt-5.5 + +The Qt version 5.5 series is binary compatible with the 5.4.x series. +Applications compiled for 5.4 will continue to run with 5.5. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Added QAbstractVideoFilter that serves as a base class for QML + video filtering elements that integrate compute, vision, and image + processing frameworks with VideoOutput. + - Added new QCameraViewfinderSettings class. + - [QTBUG-40571] Fixed memory leak in QAudioDecoder. + + - Camera (QML): + * Added imageProcessing.colorFilter, viewfinder.minimumFrameRate and + viewfinder.maximumFrameRate properties. + * Added new supportedViewfinderResolutions() and + supportedViewfinderFrameRateRanges() methods. + * Exposure modes extended to support Action, Landscape, NightPortrait, + Theatre, Sunset, SteadyPhoto, Fireworks, Party, Candlelight, and + Barcode modes + + - QCamera: + * Added support for viewfinder settings. In addition to the getter and + setter, supportedViewfinderSettings(), + supportedViewfinderResolutions(), supportedViewfinderFrameRateRanges() + and supportedViewfinderPixelFormats() can be used to query for + supported values. + * Fixed searchAndLock() and supportedLocks() functions which could not + work at all on some platforms. + + - QCameraExposure: + * Exposure modes extended to support Action, Landscape, NightPortrait, + Theatre, Sunset, SteadyPhoto, Fireworks, Party, Candlelight, and + Barcode modes + + - QCameraImageProcessing: + * Added support for color filters. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Added support for additional camera exposure modes (see list in + QCameraExposure changes). + +iOS / OS X +---------- + + - Improved camera support: + * Image capture settings, focus, flash, exposure (iOS only) and + zoom (iOS only) APIs are now functional. + * QVideoProbe can now be used with a QCamera. + + - VideoOutput, when used with a MediaPlayer on iOS, can now be displayed + under other elements and supports shader effects and advanced + transformations. + - QMediaRecorder now uses the correct system default audio capture + device. + - [QTBUG-36175] QMediaPlayer and the QML Audio and Mediaplayer types can + now play media files stored in a Qt resource file. + - [QTBUG-37655] Fixed video capture on iOS. + - [QTBUG-39240] QMediaPlayer and the QML Audio and Mediaplayer types now + support volume and mute on iOS 7.0 and later. + - [QTBUG-42035] Fixed crash when capturing an image after changing the + active camera device. + +Linux +----- + + - Added support for GStreamer 1.0. The 0.10 series is still used by default + and Qt needs to be configured with '-gstreamer 1.0' to enable 1.0 + support. If only GStreamer 1.0 is available on the system, the configure + script will automatically configure Qt with GStreamer 1.0 support. + - QCamera now supports exposure and white balance locks. + - Added support for additional camera exposure modes (see list in + QCameraExposure changes). + - Fixed QCameraImageCapture::supportedResolutions(), + QMediaRecorder::supportedResolutions() and + QMediaRecorder::supportedFrameRates() that could return empty lists. + - [QTBUG-46169] QVideoWidget now works with any windowing system. It was + previously only working with X11. + +Windows +------- + + - [QTBUG-45571] QAudioBuffer::startTime() now returns the time in the + correct time scale. + +WinRT +----- + + - [QTBUG-42263] QMediaPlayer and the QML Audio and Mediaplayer types can + now play media files stored in a Qt resource file. + - [QTBUG-44838] Fixed camera preview on Lumia 630. + - [QTBUG-45920] Fixed camera preview on Lumia 530. + - [QTBUG-45667] Fixed crash that could occur when using the camera + preview. diff --git a/dist/changes-5.5.1 b/dist/changes-5.5.1 new file mode 100644 index 0000000..d81d815 --- /dev/null +++ b/dist/changes-5.5.1 @@ -0,0 +1,68 @@ +Qt 5.5.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.5.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://doc.qt.io/qt-5.5/ + +The Qt version 5.5 series is binary compatible with the 5.4.x series. +Applications compiled for 5.4 will continue to run with 5.5. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - The environment variable QT_QUICK_NO_TEXTURE_VIDEOFRAMES can now be used + to disable OpenGL texture based video frames when using the VideoOutput + QML type. This can be useful in applications that wish to filter and + process the video frames using QAbstractVideoFilter and are not GPU + based. + - QCamera's viewfinder capabilities functions now report correct values + when filtering by pixel aspect ratio. + - [QTBUG-46359] fixed crash after using moveToThread() on a QSoundEffect. + - [QTBUG-47205] fixed VideoOutput (QML) rendering frames from the wrong + source when having multiple VideoOutputs using different sources. + - [QTBUG-47630] fixed Camera.supportedViewfinderFrameRateRanges() (QML) + returning incorrect values when the argument is not of type 'size'. + - [QTBUG-47859] fixed crash when using Radio.radioData (QML) without + a radio backend available. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Fixed QVideoProbe stopping to work when using QMediaRecorder to record + the camera. + - Video frames passed to a QAbstractVideoFilter can now be mapped to + system memory. + +Linux +----- + + - QCameraImageProcessing::isWhiteBalanceModeSupported() now correctly + reports if a given white balance mode is supported. + - [QTBUG-45707] fixed QAudioRecorder::stop() sometimes failing to + actually stop the recording. + + WinRT +----- + + - [QTBUG-46456] QCameraImageCapture: getting the list of supported + image capture resolutions and setting the image capture resolution is + now supported. + - [QTBUG-47373] fixed crash occurring with some camera operations. diff --git a/dist/changes-5.6.0 b/dist/changes-5.6.0 new file mode 100644 index 0000000..5051431 --- /dev/null +++ b/dist/changes-5.6.0 @@ -0,0 +1,138 @@ +Qt 5.6 introduces many new features and improvements as well as bugfixes +over the 5.5.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://doc.qt.io/qt-5.6 + +The Qt version 5.6 series is binary compatible with the 5.5.x series. +Applications compiled for 5.5 will continue to run with 5.6. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Important Behavior Changes * +**************************************************************************** + + - QAudioOutput now transitions to IdleState instead of ActiveState when + calling resume() in push mode. This was already the documented behavior + but in practice, it was not respected on any platform. See QTBUG-50390. + + - DirectShow is now the default backend on all desktop versions of Windows, + regardless of the compiler used. The Windows Media Foundation backend + (WMF) can be re-enabled by configuring Qt with the -wmf-backend option. + See QTBUG-45597. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Added new Playlist QML type. + + - Audio Engine QML types + * All types can now be created dynamically and added to the engine + using new 'add' functions. + + - MediaPlayer, Audio and Video (QML): + * Added new audio role API. + * Added playlist support. + + - QMediaPlayer: + * Added new audio role API. + + - [QTBUG-49838] Fixed crash when playing very short WAV files with + QSoundEffect. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - QAudioOutput: improved detection of the default buffer size and sample + rate. + - [QTBUG-35416] Camera QVideoFrames can now me mapped when retrieved using + QAbstractVideoSurface or QVideoProbe. + - [QTBUG-37837] Fixed crash when recording the camera on specific devices. + - [QTBUG-46491] Fixed media player blocking the UI when loading a media. + - [QTBUG-49134] Fixed crash when starting the camera on specific devices. + - [QTBUG-50282] Fixed QAudioRecorder crashing when trying to start it + with invalid settings. + +iOS / OS X +---------- + + - Greatly improved performance of displaying camera frames using the QML + VideoOutput type on iOS. + - Camera capture previews from the imageCaptured() signal are now in higher + resolutions. + - QMediaPlayer::isSeekable() (and QML counterpart) now correctly reports + the seekable status. + - QAudioRecorder::setVolume() is now functional. + - [QTBUG-45570] Fixed media player playback rate not working when set + before calling play(). + - [QTBUG-48057] Media player now correctly seeks as soon as playback starts + when the position is changed before calling play(). + - [QTBUG-48154] Fixed media player volume not working when set before + loading a media. + - [QTBUG-49170] It is not necessary anymore to set a viewfinder on a + QCamera to be able to query the supported viewfinder settings. + - [QTBUG-49170] Fixed QCamera ignoring the resolution set in + QCameraViewfinderSettings. + +Linux +----- + + - QCameraImageProcessing is now functional. + - [QTBUG-49531] Fixed QMediaPlayer not being able to play the same resource + file more than once. + +QNX +--- + + - QAudioRecorder::setVolume() is now functional. + - [QTBUG-49668] Fixed 'loops' property not working for Audio, Video and + MediaPlayer QML types. + +Windows +------- + + - [QTBUG-45593] The DirectShow backend now supports HW-accelerated video + decoding. + - The QML MediaPlayer and Video types previously supported HW-accelerated + video decoding only when using the ANGLE OpenGL implementation. It now + works with desktop OpenGL as well. + - QAudioRecorder::setVolume() is now functional. + - QCameraImageProcessing is now functional. + - Fixed media player volume not working when set before a media is loaded. + - Fixed QVideoFrame::startTime() not returning any value. + - Fixed seek requests never being processed when QMediaPlayer::setPosition() + is called while the media is not playing. + +WinRT +----- + + - Improved camera support: focus, focus lock and video probe APIs are now + functional. + - [QTBUG-47465] Fixed camera viewfinder aspect ratio. + - [QTBUG-47809] Fixed camera frames being upside down after switching + between front and back cameras. + - [QTBUG-48331][QTBUG-49660] Fixed camera viewfinder frames not being + displayed on the Lumia 930 and 1520. + - [QTBUG-48534] Fixed QCamera::searchAndLock() blocking the UI. + - [QTBUG-48569] Fixed crash when resuming an application that uses the + camera. + - [QTBUG-48672] Fixed crash when mapping camera frames after the camera + has stopped. + - [QTBUG-49236] Fixed playback of local files. + - [QTBUG-49347] Fixed crash when the application is suspended while + a camera focus lock is in progress. diff --git a/dist/changes-5.6.1 b/dist/changes-5.6.1 new file mode 100644 index 0000000..df0e3c1 --- /dev/null +++ b/dist/changes-5.6.1 @@ -0,0 +1,64 @@ +Qt 5.6.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.6.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + https://doc.qt.io/qt-5.6 + +The Qt version 5.6 series is binary compatible with the 5.5.x series. +Applications compiled for 5.5 will continue to run with 5.6. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-51911] fixed camera frames appearing flipped for a brief moment + when starting or stopping a video recording. + +iOS / OS X +---------- + + - Fixed the camera resolution incorrectly being changed when switching + to image capture mode. + +Linux +----- + + - PulseAudio: fixed playback of short streams never starting with + QAudioOutput in pull mode. + - [QTBUG-40823][QTBUG-49461] changing the volume of a QAudioOutput or + QAudioInput doesn't affect the system volume anymore. + - [QTBUG-51607] fixed camera not working when QT_NO_GLIB is set. + +QNX +--- + + - Fixed video playback in VMWare. + +Windows +------- + + - The DirectShow backend is now available on Windows CE. + - [QTBUG-49281] fixed a memory leak when stopping the camera. + - [QTBUG-53114] QMediaPlayer can now load UNC paths. + +WinRT +----- + + - [QTBUG-38802] the manifest now automatically includes permissions for + microphone and camera when a project contains QT += multimedia. + - [QTBUG-47803] fixed camera image capture signals not being emitted when + the first capture is done. diff --git a/dist/changes-5.6.2 b/dist/changes-5.6.2 new file mode 100644 index 0000000..72a4af9 --- /dev/null +++ b/dist/changes-5.6.2 @@ -0,0 +1,90 @@ +Qt 5.6.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.6.0 and 5.6.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://doc.qt.io/qt-5/index.html + +The Qt version 5.6 series is binary compatible with the 5.5.x series. +Applications compiled for 5.5 will continue to run with 5.6. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Fixed QMediaPlayer never starting the playback of a playlist containing + an invalid media as first item. + - [QTBUG-54710] The header of WAV files recorded with QAudioRecorder now + have the correct size. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Fixed a memory leak when restarting a QAudioOutput in push mode. + - The camera viewfinder no longer stops after an image capture fails. + - [QTBUG-48975] Calling QCameraImageCapture::capture() several times in a + row in a short amount of time now correctly triggers the imageCaptured() + signal the same amount of times. + - [QTBUG-53536] fixed a crash when trying to load a Camera while it is + already being used by another application. + - [QTBUG-54340] fixed a memory leak when changing a media player's source + on Android 4.1 or higher. + - [QTBUG-54709] fixed a deadlock when capturing camera images on some + devices and on the emulator. + +iOS / OS X +---------- + + - Fixed the orientation of recorded videos. + - [QTBUG-40338] QMediaRecorder now supports video, audio and container + settings. + - [QTBUG-49578] Fixed QMediaPlayer never notifying the EndOfMedia status + when playing a QMediaPlaylist. + - [QTBUG-54890] fixed a possible crash when deleting a QCamera while a + video recording is ongoing. + +Linux +----- + + - Fixed QAudioDeviceInfo::availableDevices() not including PulseAudio + devices added or removed after the application has started. + - [QTBUG-48982] fixed QSoundEffect playing both old and new sources on + the first call to play() after having changed the source. + +QNX +--- + + - Fixed a bug that would cause QMediaPlayer to start at the wrong position + after loading a new media. + +Windows +------- + + - [QTBUG-41573] fixed a possible deadlock when capturing a camera image. + - [QTBUG-46899] fixed resource files not being played by QMediaPlayer + - [QTBUG-54504] fixed a possible deadlock when deleting a QMediaPlayer + right after playback starts. + +WinRT +----- + + - [QTBUG-49578] Fixed QMediaPlayer never notifying the EndOfMedia status + when playing a QMediaPlaylist. + - [QTBUG-53722] fixed a crash that could occur when switching cameras + on Windows 10 Mobile. diff --git a/dist/changes-5.6.3 b/dist/changes-5.6.3 new file mode 100644 index 0000000..32a581d --- /dev/null +++ b/dist/changes-5.6.3 @@ -0,0 +1,66 @@ +Qt 5.6.3 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.6.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://doc.qt.io/qt-5/index.html + +The Qt version 5.6 series is binary compatible with the 5.5.x series. +Applications compiled for 5.5 will continue to run with 5.6. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + +- [QTBUG-55007] Fixed Playlist's documentation to include signals that were + wrongly listed under the Audio element. + +- [QTBUG-54849] Optimized QMediaPlaylistPrivate::readItems() to pass items + to the backend in bulk instead of doing it one item at a time. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Windows +------- + +- Enabled DirectShow plugin on WinCE. + +- Made it possible to build the audio decode service from the WMF as a + standalone service, making it possible to use the audio decode service even + when DirectShow is used as the media player backend. + +- [QTBUG-43765] Fixed setting volume per stream when using multiple + QAudioOutputs. + +- [QTBUG-55359] Added support for MJPEG cameras in DirectShow. + +Android +------- + +- [QTBUG-49578] Fixed mediaStatus signal reporting to work as documented. + +Linux +----- + +- [QTBUG-49578] Fixed mediaStatus signal reporting to work as documented. + +- [QTBUG-50775] Improved handling of missing camerabin plugin. + +QNX +--- + + - [QTBUG-50775] Fixed static linking. diff --git a/dist/changes-5.7.0 b/dist/changes-5.7.0 new file mode 100644 index 0000000..dfa2785 --- /dev/null +++ b/dist/changes-5.7.0 @@ -0,0 +1,67 @@ +Qt 5.7 introduces many new features and improvements as well as bugfixes +over the 5.6.x series. Also, there is a change in the licensing terms. +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://doc.qt.io/qt-5/index.html + +The Qt version 5.7 series is binary compatible with the 5.6.x series. +Applications compiled for 5.6 will continue to run with 5.7. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Important License Changes * +**************************************************************************** + + This module is no longer available under LGPLv2.1. The libraries are + now available under the following licenses: + * Commercial License + * GNU General Public License v2.0 (LICENSE.GPL2) and later + * GNU Lesser General Public License v3.0 (LICENSE.LGPL3) + + The tools are now available under the following licenses: + * Commercial License + * GNU General Public License 3.0 (LICENSE.GPL3) with exceptions + described in The Qt Company GPL Exception 1.0 (LICENSE.GPL3-EXCEPT) + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Playlist (QML): + * Added new addItems(), insertItems(), moveItem() and removeItems() + methods. + + - CameraImageProcessing (QML): + * Added new brightness property. + + - QCameraImageProcessing: + * Added new brightness property. + + - QPlaylist: + * Added new moveMedia() function. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +tvOS +---- + + - Added support for media player and camera APIs. + +WinRT +----- + + - [QTBUG-42287] Added support for QAudioDeviceInfo, QAudioInput, + QAudioOutput, and QSoundEffect. diff --git a/dist/changes-5.7.1 b/dist/changes-5.7.1 new file mode 100644 index 0000000..d7cf470 --- /dev/null +++ b/dist/changes-5.7.1 @@ -0,0 +1,34 @@ +Qt 5.7.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.7.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.7 series is binary compatible with the 5.6.x series. +Applications compiled for 5.6 will continue to run with 5.7. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - QCamera::setViewfinderSettings() and all the related functions to query + the supported viewfinder settings are now functional. + +WinRT +----- + + - [QTBUG-55894] The QIODevice passed to a QAudioInput / QAudioOutput is + now written / read from the same thread it was created in. diff --git a/dist/changes-5.8.0 b/dist/changes-5.8.0 new file mode 100644 index 0000000..06b0ad1 --- /dev/null +++ b/dist/changes-5.8.0 @@ -0,0 +1,70 @@ +Qt 5.8 introduces many new features and improvements as well as bugfixes +over the 5.7.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://doc.qt.io/qt-5/index.html + +The Qt version 5.8 series is binary compatible with the 5.7.x series. +Applications compiled for 5.7 will continue to run with 5.8. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Added QAudio::convertVolume() function. + + - QtMultimedia global object (QML): + * Added convertVolume() function. + + - VideoOutput (QML): + * Can now render frames having the YUV 4:2:2 8-bit (UYVY/YUYV) pixel + format. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Audio volumes passed to a media player are now correctly interpreted + as a linear factor. + +Linux +----- + + - Metadata containing a date information is now correctly returned as a + QDate or QDateTime. + - Added support for QMediaMetaData::CoverArtImage metadata key. + - QVideoProbe is now supported when used with a QCamera. + +OS X +---- + + - Cameras can now support the YUV 4:2:2 8-bit (UYVY/YUYV) pixel format. + +Windows +------- + + - DirectShow: + * Audio volumes passed to a media player are now correctly interpreted + as a linear factor. + +WinRT +----- + + - Cameras can now support the YUV 4:2:2 8-bit (UYVY/YUYV) pixel format. + - [QTBUG-48539] Fixed Camera (QML) focus mode and focus point mode not + being synced with the actual value. + - [QTBUG-48541] Camera flash is now supported. diff --git a/dist/changes-5.9.0 b/dist/changes-5.9.0 new file mode 100644 index 0000000..d85a095 --- /dev/null +++ b/dist/changes-5.9.0 @@ -0,0 +1,74 @@ +Qt 5.9 introduces many new features and improvements as well as bugfixes +over the 5.8.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMutlimedia +------------ + + - [QTBUG-45323] Added new supportedModes property in the CameraFlash's QML API + + - [QTBUG-44961] Added new notifyInterval property in the MediaPlayer's QML API. + + - [QTBUG-45289] Added new supportedResolution property in the CameraCaptures's + QML API. + + - [QTBUG-57145] Fixed high dpi scaling with QVideoWidget. + + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-55992] Added run-time permission checks for the media-recorder, + camera, and audio input. + + - [QTBUG-60115] Fixed crash caused by stale video-frame objects. + + - [QTBUG-56536] Fixed Camera preview orientation on devices running on + Android devices with API level 24 or newer. + +DirectShow +---------- + + - [QTBUG-56415] Added support for audio and video probes in the + mediaplayer. + +GStreamer +--------- + + - Added QT_GSTREAMER_PLAYBIN_AUDIOSINK environment variable, for setting + a custom audio sink to be used together with the media player. + + - Improved the list of default recording formats. + + - [QTBUG-50460] Fixed potential crash when using multiple mediaplayers. + + - [QTBUG-50567] Improved codec support by dynamically compiling the list of + supported codecs through QGstCodecsInfo. + +WinRT +----- + + - [QTBUG-58152] Fixed video playback without autoplay enabled. + + - [QTBUG-57288] Removed support for WinRT 81 and Windows Phone 8.1. diff --git a/dist/changes-5.9.1 b/dist/changes-5.9.1 new file mode 100644 index 0000000..f01a33e --- /dev/null +++ b/dist/changes-5.9.1 @@ -0,0 +1,43 @@ +Qt 5.9.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + +- Fixed overflow in the QML MediaPlayer/Audio items loop counter. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + +- [QTBUG-61085] Fixed crash in OpenSL ES input device caused by over-committing + the device with data. + +macOS & iOS +----------- + +- [QTBUG-50588] Fixed the StoppedState signal in the media-recorder, so it's not + emitted before the file has been written. diff --git a/dist/changes-5.9.2 b/dist/changes-5.9.2 new file mode 100644 index 0000000..2601d0c --- /dev/null +++ b/dist/changes-5.9.2 @@ -0,0 +1,42 @@ +Qt 5.9.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.9.2 Changes * +**************************************************************************** + +Linux +----- + +- [QTBUG-62435] Fixed regression that caused the selected device in the + audio input to be tested against the available output devices. +- [QTBUG-61725] Fixed improper locking logic in QSoundEffect (PulseAudio) + that caused a crash if when context creation failed. + +Windows +------- + +- [QTBUG-61817] Fixed crash in the camera caused by stale frame data. + +macOS & iOS +----------- + +- [QTBUG-60329] Made AVFImageCaptureControl work without a preview. +- [QTBUG-61367] Fixed deadlock caused by stopping the camera session + before the image capture thread was done processing. diff --git a/dist/changes-5.9.3 b/dist/changes-5.9.3 new file mode 100644 index 0000000..5682242 --- /dev/null +++ b/dist/changes-5.9.3 @@ -0,0 +1,58 @@ +Qt 5.9.3 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.9.3 Changes * +**************************************************************************** + +QtMultimedia +------------ + +- [QTBUG-53268] Fixed regression that caused relevant properties of the surface + format to be discarded when the video node was created. +- [QTBUG-62255] Fixed loading of remote m3u files. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Linux +----- + +- [QTBUG-62789] Fixed memory leak in QGstreamerAudioDecoderSession. +- [QTBUG-62245] Fixed input query in V4L code to correctly detect all cameras. +- Fixed memory leak in CameraBinImageCapture. + +QNX +--- + +- Switched to mmr_event_t based metadata retrieval, as PPS based retrieval is no + longer supported by Multimedia for QNX 7.0.0. + + +Android +------- + +- [QTBUG-51213] The scan line for the video surface format is now correctly + set to bottom-up. + +WinRT +----- + +- [QTBUG-63308] Added permission check for the camera. diff --git a/dist/changes-5.9.4 b/dist/changes-5.9.4 new file mode 100644 index 0000000..7aaaedb --- /dev/null +++ b/dist/changes-5.9.4 @@ -0,0 +1,57 @@ +Qt 5.9.4 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.9.4 Changes * +**************************************************************************** + +QtMultimedia +------------ +- [QTBUG-64407] Fixed memory leak in QSoundEffect. The sample cache didn't + release all the resources that where allocated by its worker thread. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Windows +------- + +- [QTBUG-51405] Fixed bad rendering when a video widget got overlapped by + a MDI subwindow. +- [QTBUG-64044] Fixed calculation of pixel aspect ratio due to precision loss. +- [QTBUG-52713] Fixed memory leak in the DirectShow filter graph. +- [QTBUG-61407] Fixed video rendering in QML when using ANGLE. +- [QTBUG-54242] Fixed crash in QAudioDeviceInfo::availableDevices() that could + happen if one of the device returned an empty list for its supported formats. +- [QTBUG-35916] Removed unneeded delay in the audio output, which caused an + unnecessary long wait when stopping the QSoundEffect. +- [QTBUG-53534] Fixed potential deadlock in the media player when attempting + to load a new resource while the media player was in loading state. + +iOS +--- +- [QTBUG-37955] Fixed front facing camera's orientation. + +Android +------- +- [QTBUG-52366] Fixed a crash in the camera the could happen when an + application got suspended while it still was processing a captured image. +- [QTBUG-64764] Fixed regression that would cause the video output to be shown + upside down. diff --git a/dist/changes-5.9.5 b/dist/changes-5.9.5 new file mode 100644 index 0000000..0b8bc2e --- /dev/null +++ b/dist/changes-5.9.5 @@ -0,0 +1,45 @@ +Qt 5.9.5 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.9.5 Changes * +**************************************************************************** + +QtMultimedia +------------ + +- [QTBUG-62155] Improved rendering of YUVY and UYVY texture frames. + + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Linux +----- + +- [QTBUG-66196] Fixed regression in Camera that caused GST_STATE_PLAYER to + never be set. +- Fixed udpsrc timeout setting in gstreamer, as the unit changed from mirco- + to nanoseconds in gstreamer 1.0. + +macOS / iOS +----------- + +- [QTBUG-49558] Fixed duration reporting when playing HTTP content. diff --git a/dist/changes-5.9.6 b/dist/changes-5.9.6 new file mode 100644 index 0000000..1b86549 --- /dev/null +++ b/dist/changes-5.9.6 @@ -0,0 +1,34 @@ +Qt 5.9.6 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0 through 5.9.5. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + +https://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Qt 5.9.6 Changes * +**************************************************************************** + + - This release contains only minor code improvements. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +WinRT +----- + +- [QTBUG-63016] Avoided crash when QImage is being destroyed within capturing. +- [QTBUG-63014] Fixed rotation of camera image. diff --git a/examples/CMakeLists.txt b/examples/CMakeLists.txt new file mode 100644 index 0000000..76d0158 --- /dev/null +++ b/examples/CMakeLists.txt @@ -0,0 +1,11 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +qt_examples_build_begin(EXTERNAL_BUILD) + +add_subdirectory(multimedia) +if(QT_FEATURE_spatialaudio) + add_subdirectory(spatialaudio) +endif() + +qt_examples_build_end() diff --git a/examples/examples.pro b/examples/examples.pro new file mode 100644 index 0000000..3cda360 --- /dev/null +++ b/examples/examples.pro @@ -0,0 +1,3 @@ +TEMPLATE = subdirs + +SUBDIRS += multimedia spatialaudio diff --git a/examples/multimedia/CMakeLists.txt b/examples/multimedia/CMakeLists.txt new file mode 100644 index 0000000..dbe9b5f --- /dev/null +++ b/examples/multimedia/CMakeLists.txt @@ -0,0 +1,20 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +if(TARGET Qt::Widgets) + if(NOT ANDROID AND NOT IOS) + qt_internal_add_example(audiodevices) + endif() + qt_internal_add_example(audiooutput) + qt_internal_add_example(audiorecorder) + qt_internal_add_example(audiosource) + qt_internal_add_example(camera) + qt_internal_add_example(player) + qt_internal_add_example(videographicsitem) + qt_internal_add_example(videowidget) + qt_internal_add_example(screencapture) +endif() +if(TARGET Qt::Quick) + qt_internal_add_example(declarative-camera) + add_subdirectory(video) +endif() diff --git a/examples/multimedia/audiodevices/CMakeLists.txt b/examples/multimedia/audiodevices/CMakeLists.txt new file mode 100644 index 0000000..4a942d6 --- /dev/null +++ b/examples/multimedia/audiodevices/CMakeLists.txt @@ -0,0 +1,43 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiodevices LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) +set(CMAKE_AUTOUIC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/audiodevices") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Widgets) + +qt_add_executable(audiodevices + audiodevices.cpp audiodevices.h + audiodevicesbase.ui + main.cpp +) + +set_target_properties(audiodevices PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in +) + +target_link_libraries(audiodevices PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Widgets +) + +qt_add_ios_ffmpeg_libraries(audiodevices) + +install(TARGETS audiodevices + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/audiodevices/Info.plist.in b/examples/multimedia/audiodevices/Info.plist.in new file mode 100644 index 0000000..43b9665 --- /dev/null +++ b/examples/multimedia/audiodevices/Info.plist.in @@ -0,0 +1,44 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/audiodevices/Info.qmake.ios.plist b/examples/multimedia/audiodevices/Info.qmake.ios.plist new file mode 100644 index 0000000..b5252bb --- /dev/null +++ b/examples/multimedia/audiodevices/Info.qmake.ios.plist @@ -0,0 +1,41 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/audiodevices/Info.qmake.macos.plist b/examples/multimedia/audiodevices/Info.qmake.macos.plist new file mode 100644 index 0000000..252d4c6 --- /dev/null +++ b/examples/multimedia/audiodevices/Info.qmake.macos.plist @@ -0,0 +1,32 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + NSPrincipalClass + NSApplication + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/audiodevices/audiodevices.cpp b/examples/multimedia/audiodevices/audiodevices.cpp new file mode 100644 index 0000000..03a9db0 --- /dev/null +++ b/examples/multimedia/audiodevices/audiodevices.cpp @@ -0,0 +1,231 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiodevices.h" + +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +#include + +using namespace Qt::Literals; + +// Utility functions for converting QAudioFormat fields into text + +static QString toString(QAudioFormat::SampleFormat sampleFormat) +{ + switch (sampleFormat) { + case QAudioFormat::UInt8: + return u"Unsigned 8 bit"_s; + case QAudioFormat::Int16: + return u"Signed 16 bit"_s; + case QAudioFormat::Int32: + return u"Signed 32 bit"_s; + case QAudioFormat::Float: + return u"Float"_s; + default: + return u"Unknown"_s; + } +} + +static QString toString(QAudioFormat::ChannelConfig channelConfig) +{ + switch (channelConfig) { + case QAudioFormat::ChannelConfigMono: + return u"Mono"_s; + case QAudioFormat::ChannelConfigStereo: + return u"Stereo"_s; + case QAudioFormat::ChannelConfig2Dot1: + return u"2.1"_s; + case QAudioFormat::ChannelConfig3Dot0: + return u"3.0"_s; + case QAudioFormat::ChannelConfigSurround5Dot0: + return u"5.0 Surround"_s; + case QAudioFormat::ChannelConfigSurround5Dot1: + return u"5.1 Surround"_s; + case QAudioFormat::ChannelConfigSurround7Dot0: + return u"7.0 Surround"_s; + case QAudioFormat::ChannelConfigSurround7Dot1: + return u"7.1 Surround"_s; + default: + break; + } + + static auto channelLabels = std::array{ + u"UnknownPosition", + u"FrontLeft", + u"FrontRight", + u"FrontCenter", + u"LFE", + u"BackLeft", + u"BackRight", + u"FrontLeftOfCenter", + u"FrontRightOfCenter", + u"BackCenter", + u"SideLeft", + u"SideRight", + u"TopCenter", + u"TopFrontLeft", + u"TopFrontCenter", + u"TopFrontRight", + u"TopBackLeft", + u"TopBackCenter", + u"TopBackRight", + u"LFE2", + u"TopSideLeft", + u"TopSideRight", + u"BottomFrontCenter", + u"BottomFrontLeft", + u"BottomFrontRight", + }; + + QStringList labels; + std::bitset configBits(channelConfig); + for (size_t i = 0; i < configBits.size(); ++i) { + if (configBits.test(i)) + labels.emplace_back(channelLabels[i]); + } + return labels.join(", "); +} + +AudioDevicesBase::AudioDevicesBase(QWidget *parent) : QMainWindow(parent) +{ + setupUi(this); +} + +AudioDevicesBase::~AudioDevicesBase() = default; + +AudioDevices::AudioDevices(QWidget *parent) + : AudioDevicesBase(parent), m_devices(new QMediaDevices(this)) +{ + init(); +} + +void AudioDevices::updateDevicePropertes() +{ + QStringList sampleFormats; + for (auto format : m_deviceInfo.supportedSampleFormats()) + sampleFormats << toString(format); + sampleFormatField->setText(sampleFormats.join(", ")); + + if (m_deviceInfo.minimumChannelCount() != m_deviceInfo.maximumChannelCount()) { + QString channelRange = u"%1 - %2"_s.arg(m_deviceInfo.minimumChannelCount()) + .arg(m_deviceInfo.maximumChannelCount()); + channelNumberField->setText(channelRange); + } else { + channelNumberField->setText(QString::number(m_deviceInfo.minimumChannelCount())); + } + + QString sampleRateRange = u"%1 - %2 Hz"_s.arg(m_deviceInfo.minimumSampleRate()) + .arg(m_deviceInfo.maximumSampleRate()); + samplingRatesField->setText(sampleRateRange); + + QString channelConfig = toString(m_deviceInfo.channelConfiguration()); + channelLayoutField->setText(channelConfig); + + QString preferredFormat = u"%1, %2 Hz, %3 channels (%4)"_s.arg( + toString(m_deviceInfo.preferredFormat().sampleFormat()), + QString::number(m_deviceInfo.preferredFormat().sampleRate()), + QString::number(m_deviceInfo.preferredFormat().channelCount()), + toString(m_deviceInfo.preferredFormat().channelConfig())); + preferredFormatField->setText(preferredFormat); + + for (QLineEdit *field : { samplingRatesField, channelNumberField, sampleFormatField, + channelLayoutField, preferredFormatField }) + field->setCursorPosition(0); +} + +void AudioDevices::init() +{ +#if QT_CONFIG(permissions) + // microphone + QMicrophonePermission microphonePermission; + switch (qApp->checkPermission(microphonePermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(microphonePermission, this, &AudioDevices::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Microphone permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } +#endif + connect(modeBox, QOverload::of(&QComboBox::activated), this, &AudioDevices::modeChanged); + connect(deviceBox, QOverload::of(&QComboBox::activated), this, + &AudioDevices::deviceChanged); + connect(m_devices, &QMediaDevices::audioInputsChanged, this, &AudioDevices::updateAudioDevices); + connect(m_devices, &QMediaDevices::audioOutputsChanged, this, + &AudioDevices::updateAudioDevices); + + modeBox->setCurrentIndex(1); + updateAudioDevices(); + updateDevicePropertes(); +} + +void AudioDevices::updateAudioDevices() +{ + QSignalBlocker blockUpdates(deviceBox); + const auto devices = + m_mode == QAudioDevice::Input ? m_devices->audioInputs() : m_devices->audioOutputs(); + { + deviceBox->clear(); + for (auto &deviceInfo : devices) { + QString description = deviceInfo.description(); + description.replace(u"\n"_s, u" - "_s); + if (deviceInfo.isDefault()) + description += " (default)"; + + deviceBox->addItem(description, QVariant::fromValue(deviceInfo)); + } + } + + // select previously selected + for (int index = 0; index != devices.size(); ++index) { + if (devices[index].id() == m_deviceInfo.id()) { + deviceBox->setCurrentIndex(index); + deviceChanged(index); + return; + } + } + + // select default + for (int index = 0; index != devices.size(); ++index) { + if (devices[index].isDefault()) { + deviceBox->setCurrentIndex(index); + deviceChanged(index); + m_deviceInfo = devices[index]; + return; + } + } +} + +void AudioDevices::modeChanged(int idx) +{ + m_mode = idx == 0 ? QAudioDevice::Input : QAudioDevice::Output; + updateAudioDevices(); + deviceBox->setCurrentIndex(0); + deviceChanged(0); +} + +void AudioDevices::deviceChanged(int idx) +{ + if (deviceBox->count() == 0) { + channelNumberField->clear(); + sampleFormatField->clear(); + samplingRatesField->clear(); + channelLayoutField->clear(); + return; + } + + // device has changed + m_deviceInfo = deviceBox->itemData(idx).value(); + + updateDevicePropertes(); +} + +#include "moc_audiodevices.cpp" diff --git a/examples/multimedia/audiodevices/audiodevices.h b/examples/multimedia/audiodevices/audiodevices.h new file mode 100644 index 0000000..8844e61 --- /dev/null +++ b/examples/multimedia/audiodevices/audiodevices.h @@ -0,0 +1,42 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIODEVICES_H +#define AUDIODEVICES_H + +#include "ui_audiodevicesbase.h" + +#include +#include +#include +#include + +class AudioDevicesBase : public QMainWindow, public Ui::AudioDevicesBase +{ +public: + AudioDevicesBase(QWidget *parent = nullptr); + virtual ~AudioDevicesBase(); +}; + +class AudioDevices : public AudioDevicesBase +{ + Q_OBJECT + +public: + explicit AudioDevices(QWidget *parent = nullptr); + +private: + QAudioDevice m_deviceInfo; + QAudioDevice::Mode m_mode = QAudioDevice::Output; + QMediaDevices *m_devices = nullptr; + + void updateDevicePropertes(); + +private slots: + void init(); + void updateAudioDevices(); + void modeChanged(int idx); + void deviceChanged(int idx); +}; + +#endif diff --git a/examples/multimedia/audiodevices/audiodevices.pro b/examples/multimedia/audiodevices/audiodevices.pro new file mode 100644 index 0000000..f3f4abb --- /dev/null +++ b/examples/multimedia/audiodevices/audiodevices.pro @@ -0,0 +1,20 @@ +TEMPLATE = app +TARGET = audiodevices + +QT += multimedia +CONFIG += add_ios_ffmpeg_libraries + +HEADERS = audiodevices.h + +SOURCES = audiodevices.cpp \ + main.cpp + +FORMS += audiodevicesbase.ui + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/audiodevices +INSTALLS += target + +QT+=widgets + +macos: QMAKE_INFO_PLIST = Info.qmake.macos.plist +ios: QMAKE_INFO_PLIST = Info.qmake.ios.plist diff --git a/examples/multimedia/audiodevices/audiodevicesbase.ui b/examples/multimedia/audiodevices/audiodevicesbase.ui new file mode 100644 index 0000000..328d3d9 --- /dev/null +++ b/examples/multimedia/audiodevices/audiodevicesbase.ui @@ -0,0 +1,198 @@ + + + AudioDevicesBase + + + + 0 + 0 + 785 + 373 + + + + Audio Devices + + + + + + + + 0 + 0 + + + + true + + + + + 0 + 0 + 765 + 331 + + + + + + + + + + 0 + 0 + + + + + + + + Mode + + + + + + + Device + + + + + + + + Input + + + + + Output + + + + + + + + 0 + + + + Properties + + + + + + + + Channel Layout + + + + + + + Sampling Rates: + + + + + + + true + + + + + + + Number of Channels + + + + + + + true + + + + + + + Sample Formats: + + + + + + + true + + + + + + + true + + + + + + + true + + + Preferred Format + + + + + + + true + + + true + + + + + + + + + Qt::Orientation::Vertical + + + + 20 + 40 + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/audiodevices/doc/images/audiodevices.png b/examples/multimedia/audiodevices/doc/images/audiodevices.png new file mode 100644 index 0000000000000000000000000000000000000000..a349a53097f20592063963a79f60d9d0eb42194a GIT binary patch literal 14883 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/audiodevices/doc/src/audiodevices.qdoc b/examples/multimedia/audiodevices/doc/src/audiodevices.qdoc new file mode 100644 index 0000000..870d506 --- /dev/null +++ b/examples/multimedia/audiodevices/doc/src/audiodevices.qdoc @@ -0,0 +1,21 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example audiodevices + \title Audio Devices Example + \ingroup multimedia_examples + \ingroup audio_examples + \examplecategory {Multimedia} + \brief List available audio devices and their configuration. + \meta {tag} {widgets} + + \e{Audio Devices} demonstrates how to create a simple application to list + the configuration for the various audio devices available on the + target device or desktop PC. + + \image audiodevices.png + {UI consisting of audio configuration drop-downs and controls} + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/audiodevices/main.cpp b/examples/multimedia/audiodevices/main.cpp new file mode 100644 index 0000000..10ab8d4 --- /dev/null +++ b/examples/multimedia/audiodevices/main.cpp @@ -0,0 +1,17 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiodevices.h" + +#include + +int main(int argv, char **args) +{ + QApplication app(argv, args); + app.setApplicationName("Audio Device Test"); + + AudioDevices audio; + audio.show(); + + return app.exec(); +} diff --git a/examples/multimedia/audiooutput/CMakeLists.txt b/examples/multimedia/audiooutput/CMakeLists.txt new file mode 100644 index 0000000..9c279cb --- /dev/null +++ b/examples/multimedia/audiooutput/CMakeLists.txt @@ -0,0 +1,40 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiooutput LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/audiooutput") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Widgets) + +qt_add_executable(audiooutput + audiooutput.cpp audiooutput.h + main.cpp +) + +qt_add_ios_ffmpeg_libraries(audiooutput) + +set_target_properties(audiooutput PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +target_link_libraries(audiooutput PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Widgets +) + +install(TARGETS audiooutput + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/audiooutput/audiooutput.cpp b/examples/multimedia/audiooutput/audiooutput.cpp new file mode 100644 index 0000000..3a8d731 --- /dev/null +++ b/examples/multimedia/audiooutput/audiooutput.cpp @@ -0,0 +1,550 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiooutput.h" + +#include + +namespace { + +// IIR filter with poles on the unit circle to generate a sine wave +// https://ccrma.stanford.edu/~jos/pasp/Digital_Sinusoid_Generators.html +struct SineOscillator +{ + SineOscillator(float frequency, float sampleRate) + { + float omega = 2.0 * M_PI * frequency / sampleRate; + b1 = 2.0f * qCos(omega); + float initialPhase = 0.0f; + y1 = qSin(initialPhase - omega); + y2 = qSin(initialPhase - 2.0f * omega); + } + + float nextSample() + { + double y0 = b1 * y1 - y2; + y2 = y1; + y1 = y0; + return float(std::clamp(y0, -1.0, 1.0)); + } + +private: + double b1{}; + double y1{}; + double y2{}; +}; + +uint8_t asUint8(float normalizedFloat) +{ + return quint8((1.0 + normalizedFloat) / 2 * 255); +} + +uint16_t asInt16(float normalizedFloat) +{ + return qint16(normalizedFloat * 32767); +} + +uint32_t asInt32(float normalizedFloat) +{ + return qint32(normalizedFloat * double(std::numeric_limits::max())); +} + +QSpan writeFromSampleValue(QSpan buffer, float value, QAudioFormat::SampleFormat format) +{ + switch (format) { + case QAudioFormat::UInt8: { + *reinterpret_cast(buffer.data()) = asUint8(value); + return buffer.subspan(sizeof(quint8)); + } + case QAudioFormat::Int16: { + *reinterpret_cast(buffer.data()) = asInt16(value); + return buffer.subspan(sizeof(qint16)); + } + case QAudioFormat::Int32: { + *reinterpret_cast(buffer.data()) = asInt32(value); + return buffer.subspan(sizeof(qint32)); + } + case QAudioFormat::Float: { + *reinterpret_cast(buffer.data()) = value; + return buffer.subspan(sizeof(float)); + } + default: + Q_UNREACHABLE_RETURN(buffer); + } +} + +} // namespace + +Generator::Generator(const QAudioFormat &format, qint64 durationUs, int frequency) +{ + if (format.isValid()) + generateData(format, durationUs, frequency); +} + +void Generator::start() +{ + open(QIODevice::ReadOnly); +} + +void Generator::stop() +{ + m_pos = 0; + close(); +} + +void Generator::generateData(const QAudioFormat &format, qint64 durationUs, int frequency) +{ + qint64 bytes = format.bytesForDuration(durationUs); + m_buffer.resize(bytes); + QSpan buffer(m_buffer.data(), m_buffer.size()); + auto osc = SineOscillator(frequency, format.sampleRate()); + + while (!buffer.empty()) { + const float sampleValue = osc.nextSample(); // Produces value (-1..1) + for (int i = 0; i < format.channelCount(); ++i) + buffer = writeFromSampleValue(buffer, sampleValue, format.sampleFormat()); + } +} + +qint64 Generator::readData(char *data, qint64 len) +{ + qint64 total = 0; + if (!m_buffer.isEmpty()) { + while (len - total > 0) { + const qint64 chunk = qMin((m_buffer.size() - m_pos), len - total); + memcpy(data + total, m_buffer.constData() + m_pos, chunk); + m_pos = (m_pos + chunk) % m_buffer.size(); + total += chunk; + } + } + return total; +} + +qint64 Generator::writeData([[maybe_unused]] const char *data, [[maybe_unused]] qint64 len) +{ + return 0; +} + +qint64 Generator::bytesAvailable() const +{ + return m_buffer.size() + QIODevice::bytesAvailable(); +} + +using namespace Qt::Literals::StringLiterals; +static QString sampleFormatToString(QAudioFormat::SampleFormat f) +{ + switch (f) { + case QAudioFormat::UInt8: return u"UInt8"_s; + case QAudioFormat::Int16: return u"Int16"_s; + case QAudioFormat::Int32: return u"Int32"_s; + case QAudioFormat::Float: return u"Float"_s; + default: return u"Unknown"_s; + } +} + +static constexpr std::array allSupportedSampleRates{ + 8'000, 11'025, 12'000, 16'000, 22'050, 24'000, 32'000, 44'100, + 48'000, 64'000, 88'200, 96'000, 128'000, 176'400, 192'000, +}; + +template +static void setCurrentValue(QComboBox *box, const T &value) +{ + int idx = box->findData(QVariant::fromValue(value)); + if (idx >= 0) + box->setCurrentIndex(idx); +} + +static void syncFormatGui(QComboBox *m_formatBox, QComboBox *m_channelsBox, QComboBox *m_rateBox, + const QAudioFormat &format) +{ + setCurrentValue(m_formatBox, format.sampleFormat()); + setCurrentValue(m_rateBox, format.sampleRate()); + setCurrentValue(m_channelsBox, format.channelCount()); +} + +AudioTest::AudioTest() : m_devices(new QMediaDevices(this)), m_pushTimer(new QTimer(this)) +{ + initializeWindow(); + + // deviceChanged will kickstart the QAudioSink + deviceChanged(m_deviceBox->currentIndex()); +} + +AudioTest::~AudioTest() +{ + m_pushTimer->stop(); + cleanupAudioSink(); +} + +void AudioTest::initializeWindow() +{ + QWidget *window = new QWidget; + QVBoxLayout *layout = new QVBoxLayout; + + m_deviceBox = new QComboBox(this); + QAudioDevice defaultDevice = QMediaDevices::defaultAudioOutput(); + for (auto &deviceInfo : QMediaDevices::audioOutputs()) + m_deviceBox->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); + auto defaultDeviceIndex = m_deviceBox->findData(QVariant::fromValue(defaultDevice)); + m_deviceBox->setCurrentIndex(defaultDeviceIndex); + + connect(m_deviceBox, &QComboBox::currentIndexChanged, this, &AudioTest::deviceChanged); + connect(m_devices, &QMediaDevices::audioOutputsChanged, this, &AudioTest::updateAudioDevices); + layout->addWidget(m_deviceBox); + + m_modeBox = new QComboBox(this); + m_modeBox->addItem(tr("Pull Mode")); + m_modeBox->addItem(tr("Push Mode")); + m_modeBox->addItem(tr("Callback Mode")); + connect(m_modeBox, &QComboBox::currentIndexChanged, this, [this](int index) { + m_mode = AudioTestMode{ index }; + restartAudioStream(); + }); + layout->addWidget(m_modeBox); + m_modeBox->setCurrentIndex(qToUnderlying(m_mode)); + + m_suspendResumeButton = new QPushButton(this); + connect(m_suspendResumeButton, &QPushButton::clicked, this, &AudioTest::toggleSuspendResume); + layout->addWidget(m_suspendResumeButton); + + QHBoxLayout *volumeBox = new QHBoxLayout; + m_volumeLabel = new QLabel; + m_volumeLabel->setText(tr("Volume:")); + m_volumeSlider = new QSlider(Qt::Horizontal); + m_volumeSlider->setMinimum(0); + m_volumeSlider->setMaximum(100); + m_volumeSlider->setSingleStep(10); + connect(m_volumeSlider, &QSlider::valueChanged, this, &AudioTest::volumeChanged); + volumeBox->addWidget(m_volumeLabel); + volumeBox->addWidget(m_volumeSlider); + layout->addLayout(volumeBox); + + // Sample Format selector + QHBoxLayout *formatBox = new QHBoxLayout; + QLabel *formatLabel = new QLabel; + formatLabel->setText(tr("Sample Format:")); + m_formatBox = new QComboBox(this); + + //Sample rate button + QLabel *rateLabel = new QLabel; + rateLabel->setText(tr("Sample Rate:")); + m_rateBox = new QComboBox(this); + + // setting channel count + QLabel *chLabel = new QLabel; + chLabel->setText(tr("Channels:")); + m_channelsBox = new QComboBox(this); + + for (auto *box : { m_channelsBox, m_rateBox, m_formatBox }) { + connect(box, &QComboBox::activated, this, [this, box]() { + formatChanged(box); + }); + } + + // add all to the same row + formatBox->addWidget(formatLabel); + formatBox->addWidget(m_formatBox); + formatBox->addSpacing(12); + formatBox->addWidget(rateLabel); + formatBox->addWidget(m_rateBox); + formatBox->addSpacing(12); + formatBox->addWidget(chLabel); + formatBox->addWidget(m_channelsBox); + + layout->addLayout(formatBox); + + window->setLayout(layout); + + setCentralWidget(window); + window->show(); +} + +void AudioTest::startAudioSink(const QAudioDevice &device, const QAudioFormat &format) +{ + if (m_audioSink) + cleanupAudioSink(); + + m_audioSink = std::make_unique(device, format); + m_audioSink->setVolume(0.25f); // roughly -12dB + + m_currentDevice = device; + + syncFormatGui(m_formatBox, m_channelsBox, m_rateBox, m_audioSink->format()); + + // handle startup/runtime errors and success negotiation + connect(m_audioSink.get(), &QAudioSink::stateChanged, this, [this, device](QAudio::State s) { + switch (s) { + case QAudio::ActiveState: + m_suspendResumeButton->setText(tr("Suspend playback")); + return; + + case QAudio::SuspendedState: + m_suspendResumeButton->setText(tr("Resume playback")); + return; + + default: + break; + } + + const auto err = m_audioSink->error(); + + // startup failure (format rejected or device unavailable) + if (err == QAudio::OpenError && s == QAudio::StoppedState) { + QMessageBox::warning(this, tr("Audio start failed"), + tr("Device rejected the format or is unavailable.")); + return; + } + + // runtime I/O or fatal device error (disconnects, etc.) + if (err == QAudio::IOError || err == QAudio::FatalError) { + if (m_currentDevice == device) { + m_currentDevice = {}; + m_deviceBox->setCurrentIndex(-1); + } + QMessageBox::warning(this, tr("Audio error"), tr("Audio device error.")); + return; + } + }); + + // set initial volume and kick the stream + qreal initialVolume = QAudio::convertVolume(m_audioSink->volume(), + QAudio::LinearVolumeScale, + QAudio::LogarithmicVolumeScale); + m_volumeSlider->setValue(qRound(initialVolume * 100)); + + restartAudioStream(); +} + +void AudioTest::deviceChanged(int index) +{ + QAudioDevice dev = m_deviceBox->itemData(index).value(); + + // formats + m_formatBox->clear(); + m_channelsBox->clear(); + m_rateBox->clear(); + + if (!dev.isNull()) { + const auto formats = dev.supportedSampleFormats(); + for (const QAudioFormat::SampleFormat sf : formats) + m_formatBox->addItem(sampleFormatToString(sf), QVariant::fromValue(sf)); + + // channels + for (int ch = dev.minimumChannelCount(); ch <= dev.maximumChannelCount(); ++ch) + m_channelsBox->addItem(QString::number(ch), ch); + + // populate from the hardcoded list in this cpp file + for (int rate : allSupportedSampleRates) { + if (rate < dev.minimumSampleRate() || rate > dev.maximumSampleRate()) + continue; + m_rateBox->addItem(QString::number(rate), rate); + } + } + + if (dev != m_currentDevice) { + cleanupAudioSink(); + if (!dev.isNull()) { + QAudioFormat format = dev.preferredFormat(); + startAudioSink(dev, format); + } + } +} + +void AudioTest::volumeChanged(int value) +{ + qreal linearVolume = QAudio::convertVolume(value / qreal(100), + QAudio::LogarithmicVolumeScale, + QAudio::LinearVolumeScale); + + m_audioSink->setVolume(linearVolume); +} + +void AudioTest::formatChanged(QComboBox *box) +{ + QAudioDevice device = m_deviceBox->currentData().value(); + QAudioFormat newFormat = m_audioSink->format(); + + if (box == m_formatBox) { + newFormat.setSampleFormat( + static_cast(box->currentData().toInt())); + } else if (box == m_rateBox) { + newFormat.setSampleRate(box->currentData().toInt()); + } else if (box == m_channelsBox) { + newFormat.setChannelCount(box->currentData().toInt()); + } + + startAudioSink(device, newFormat); +} + +void AudioTest::updateAudioDevices() +{ + QSignalBlocker blockUpdates(m_deviceBox); + + m_deviceBox->clear(); + + const QList devices = QMediaDevices::audioOutputs(); + for (const QAudioDevice &deviceInfo : devices) + m_deviceBox->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); + const int currentDeviceIndex = m_deviceBox->findData(QVariant::fromValue(m_currentDevice)); + if (currentDeviceIndex != -1) { + // select previous device + m_deviceBox->setCurrentIndex(currentDeviceIndex); + } else { + blockUpdates.unblock(); + // select default device + QAudioDevice defaultDevice = QMediaDevices::defaultAudioOutput(); + const int defaultDeviceIndex = m_deviceBox->findData(QVariant::fromValue(defaultDevice)); + const int currentIndex = m_deviceBox->currentIndex(); + m_deviceBox->setCurrentIndex(defaultDeviceIndex); + if (defaultDeviceIndex == currentIndex) { + // device changed, reinitialize audio + deviceChanged(defaultDeviceIndex); + } + } +} + + + +void AudioTest::restartAudioStream() +{ + m_pushTimer->stop(); + // Reset audiosink + m_audioSink->reset(); + m_generator.reset(); + + qreal initialVolume = QAudio::convertVolume(m_audioSink->volume(), QAudio::LinearVolumeScale, + QAudio::LogarithmicVolumeScale); + m_volumeSlider->setValue(qRound(initialVolume * 100)); + + switch (m_mode) { + case AudioTestMode::Pull: + case AudioTestMode::Push: { + // rebuild generator and sink with the requested format + const int durationSeconds = 1; + const int toneFrequencyInHz = 600; + m_generator = std::make_unique(m_audioSink->format(), durationSeconds * 1000000, + toneFrequencyInHz); + m_generator->start(); + break; + } + case AudioTestMode::Callback: { + // we don't use the QIODevice based generator in callback mode, but capture the oscillator + break; + } + } + + switch (m_mode) { + case AudioTestMode::Pull: { + m_audioSink->start(m_generator.get()); + break; + } + case AudioTestMode::Push: { + // push mode: periodically push to QAudioSink using a timer + auto *io = m_audioSink->start(); + m_pushTimer->disconnect(); + + connect(m_pushTimer, &QTimer::timeout, this, [this, io]() { + if (m_audioSink->state() == QAudio::StoppedState) + return; + + int len = m_audioSink->bytesFree(); + QByteArray buffer(len, 0); + len = m_generator->read(buffer.data(), len); + if (len) + io->write(buffer.data(), len); + }); + + m_pushTimer->start(10); + break; + } + case AudioTestMode::Callback: { + auto generator = SineOscillator(600.0f, float(m_audioSink->format().sampleRate())); + int numberOfChannels = m_audioSink->format().channelCount(); + switch (m_audioSink->format().sampleFormat()) { + case QAudioFormat::UInt8: { + m_audioSink->start( + [generator, numberOfChannels](QSpan buffer) mutable -> void { + while (!buffer.isEmpty()) { + float sampleValue = generator.nextSample(); + QSpan currentFrame = buffer.first(numberOfChannels); + Q_ASSERT(currentFrame.size() == numberOfChannels); + std::fill(currentFrame.begin(), currentFrame.end(), asUint8(sampleValue)); + buffer = buffer.subspan(numberOfChannels); + } + }); + break; + } + case QAudioFormat::Int16: { + m_audioSink->start([generator, numberOfChannels](QSpan buffer) mutable -> void { + while (!buffer.isEmpty()) { + float sampleValue = generator.nextSample(); + QSpan currentFrame = buffer.first(numberOfChannels); + Q_ASSERT(currentFrame.size() == numberOfChannels); + std::fill(currentFrame.begin(), currentFrame.end(), asInt16(sampleValue)); + buffer = buffer.subspan(numberOfChannels); + } + }); + break; + } + case QAudioFormat::Int32: { + m_audioSink->start([generator, numberOfChannels](QSpan buffer) mutable -> void { + while (!buffer.isEmpty()) { + float sampleValue = generator.nextSample(); + QSpan currentFrame = buffer.first(numberOfChannels); + Q_ASSERT(currentFrame.size() == numberOfChannels); + std::fill(currentFrame.begin(), currentFrame.end(), asInt32(sampleValue)); + buffer = buffer.subspan(numberOfChannels); + } + }); + break; + } + case QAudioFormat::Float: { + m_audioSink->start([generator, numberOfChannels](QSpan buffer) mutable -> void { + while (!buffer.isEmpty()) { + float sampleValue = generator.nextSample(); + QSpan currentFrame = buffer.first(numberOfChannels); + Q_ASSERT(currentFrame.size() == numberOfChannels); + std::fill(currentFrame.begin(), currentFrame.end(), sampleValue); + buffer = buffer.subspan(numberOfChannels); + } + }); + break; + } + default: + Q_UNREACHABLE(); + } + break; + } + default: + Q_UNREACHABLE(); + } +} + +void AudioTest::toggleSuspendResume() +{ + switch (m_audioSink->state()) { + case QAudio::SuspendedState: + m_audioSink->resume(); + return; + case QAudio::ActiveState: + m_audioSink->suspend(); + return; + + default: + return; + } +} + +void AudioTest::cleanupAudioSink() +{ + if (m_audioSink) { + m_audioSink->stop(); + m_audioSink->disconnect(this); + } + m_audioSink.reset(); + m_generator.reset(); + m_currentDevice = {}; +} + +#include "moc_audiooutput.cpp" diff --git a/examples/multimedia/audiooutput/audiooutput.h b/examples/multimedia/audiooutput/audiooutput.h new file mode 100644 index 0000000..e407943 --- /dev/null +++ b/examples/multimedia/audiooutput/audiooutput.h @@ -0,0 +1,91 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIOOUTPUT_H +#define AUDIOOUTPUT_H + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +class Generator : public QIODevice +{ + Q_OBJECT + +public: + Generator(const QAudioFormat &format, qint64 durationUs, int frequency); + + void start(); + void stop(); + + qint64 readData(char *data, qint64 maxlen) override; + qint64 writeData(const char *data, qint64 len) override; + qint64 bytesAvailable() const override; + qint64 size() const override { return m_buffer.size(); } + +private: + void generateData(const QAudioFormat &format, qint64 durationUs, int frequency); + +private: + qint64 m_pos = 0; + QByteArray m_buffer; +}; + +enum class AudioTestMode { + Pull, + Push, + Callback, +}; + +class AudioTest : public QMainWindow +{ + Q_OBJECT + +public: + AudioTest(); + ~AudioTest(); + +private: + void initializeWindow(); + void startAudioSink(const QAudioDevice &, const QAudioFormat &); + void cleanupAudioSink(); + +private: + QMediaDevices *m_devices = nullptr; + QTimer *m_pushTimer = nullptr; + + // Owned by layout + QComboBox *m_channelsBox = nullptr; + QComboBox *m_rateBox = nullptr; + QComboBox *m_formatBox = nullptr; + QComboBox *m_modeBox = nullptr; + QPushButton *m_suspendResumeButton = nullptr; + QComboBox *m_deviceBox = nullptr; + QLabel *m_volumeLabel = nullptr; + QSlider *m_volumeSlider = nullptr; + + std::unique_ptr m_generator; + std::unique_ptr m_audioSink; + + AudioTestMode m_mode = AudioTestMode::Pull; + QAudioDevice m_currentDevice; + void restartAudioStream(); + +private slots: + void formatChanged(QComboBox *box); + void toggleSuspendResume(); + void deviceChanged(int index); + void volumeChanged(int); + void updateAudioDevices(); +}; + +#endif // AUDIOOUTPUT_H diff --git a/examples/multimedia/audiooutput/audiooutput.pro b/examples/multimedia/audiooutput/audiooutput.pro new file mode 100644 index 0000000..ecd7273 --- /dev/null +++ b/examples/multimedia/audiooutput/audiooutput.pro @@ -0,0 +1,13 @@ +TEMPLATE = app +TARGET = audiooutput + +QT += multimedia widgets +CONFIG += add_ios_ffmpeg_libraries + +HEADERS = audiooutput.h + +SOURCES = audiooutput.cpp \ + main.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/audiooutput +INSTALLS += target diff --git a/examples/multimedia/audiooutput/doc/images/audiooutput-example.png b/examples/multimedia/audiooutput/doc/images/audiooutput-example.png new file mode 100644 index 0000000000000000000000000000000000000000..163105b85c65e6806db42a5a9fcf83d28c103a07 GIT binary patch literal 8172 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/audiooutput/doc/src/audiooutput.qdoc b/examples/multimedia/audiooutput/doc/src/audiooutput.qdoc new file mode 100644 index 0000000..4486508 --- /dev/null +++ b/examples/multimedia/audiooutput/doc/src/audiooutput.qdoc @@ -0,0 +1,24 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example audiooutput + \title Audio Output Example + \ingroup multimedia_examples + \ingroup audio_examples + \examplecategory {Multimedia} + \brief Enabling audio playback using the QAudioSink class. + \meta {tag} {widgets} + + \e{Audio Output} demonstrates the basic use cases of QAudioSink. + + \image audiooutput-example.png + {UI with playback controls and audio output mode selection} + + This example provides a tone generator to supply continuous audio playback. + The UI allows the user to select the audio output device, pause and resume playback, + switch between different modes of operation, adjust the volume and + change the audio format parameters. + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/audiooutput/main.cpp b/examples/multimedia/audiooutput/main.cpp new file mode 100644 index 0000000..8c652f0 --- /dev/null +++ b/examples/multimedia/audiooutput/main.cpp @@ -0,0 +1,17 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiooutput.h" + +#include + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + app.setApplicationName("Audio Output Test"); + + AudioTest audio; + audio.show(); + + return app.exec(); +} diff --git a/examples/multimedia/audiorecorder/CMakeLists.txt b/examples/multimedia/audiorecorder/CMakeLists.txt new file mode 100644 index 0000000..61faf5d --- /dev/null +++ b/examples/multimedia/audiorecorder/CMakeLists.txt @@ -0,0 +1,42 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiorecorder LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) +set(CMAKE_AUTOUIC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/audiorecorder") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Widgets) + +qt_add_executable(audiorecorder + audiorecorder.cpp audiorecorder.h audiorecorder.ui + main.cpp +) + +qt_add_ios_ffmpeg_libraries(audiorecorder) + +set_target_properties(audiorecorder PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in +) + +target_link_libraries(audiorecorder PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Widgets +) + +install(TARGETS audiorecorder + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/audiorecorder/Info.plist.in b/examples/multimedia/audiorecorder/Info.plist.in new file mode 100644 index 0000000..43b9665 --- /dev/null +++ b/examples/multimedia/audiorecorder/Info.plist.in @@ -0,0 +1,44 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/audiorecorder/Info.qmake.ios.plist b/examples/multimedia/audiorecorder/Info.qmake.ios.plist new file mode 100644 index 0000000..b5252bb --- /dev/null +++ b/examples/multimedia/audiorecorder/Info.qmake.ios.plist @@ -0,0 +1,41 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/audiorecorder/Info.qmake.macos.plist b/examples/multimedia/audiorecorder/Info.qmake.macos.plist new file mode 100644 index 0000000..252d4c6 --- /dev/null +++ b/examples/multimedia/audiorecorder/Info.qmake.macos.plist @@ -0,0 +1,32 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + NSPrincipalClass + NSApplication + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/audiorecorder/audiorecorder.cpp b/examples/multimedia/audiorecorder/audiorecorder.cpp new file mode 100644 index 0000000..028b5dd --- /dev/null +++ b/examples/multimedia/audiorecorder/audiorecorder.cpp @@ -0,0 +1,308 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiorecorder.h" +#include "ui_audiorecorder.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +AudioRecorder::AudioRecorder() : ui(new Ui::AudioRecorder) +{ + ui->setupUi(this); + + // channels + ui->channelsBox->addItem(tr("Default"), QVariant(-1)); + ui->channelsBox->addItem(QStringLiteral("1"), QVariant(1)); + ui->channelsBox->addItem(QStringLiteral("2"), QVariant(2)); + ui->channelsBox->addItem(QStringLiteral("4"), QVariant(4)); + + // quality + ui->qualitySlider->setRange(0, int(QImageCapture::VeryHighQuality)); + ui->qualitySlider->setValue(int(QImageCapture::NormalQuality)); + + // bit rates: + ui->bitrateBox->addItem(tr("Default"), QVariant(0)); + ui->bitrateBox->addItem(QStringLiteral("32000"), QVariant(32000)); + ui->bitrateBox->addItem(QStringLiteral("64000"), QVariant(64000)); + ui->bitrateBox->addItem(QStringLiteral("96000"), QVariant(96000)); + ui->bitrateBox->addItem(QStringLiteral("128000"), QVariant(128000)); + + // audio input initialization + init(); +} + +void AudioRecorder::init() +{ +#if QT_CONFIG(permissions) + QMicrophonePermission microphonePermission; + switch (qApp->checkPermission(microphonePermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(microphonePermission, this, &AudioRecorder::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Microphone permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } +#endif + + m_audioRecorder = new QMediaRecorder(this); + m_captureSession.setRecorder(m_audioRecorder); + m_captureSession.setAudioInput(new QAudioInput(this)); + + // audio devices + m_mediaDevices = new QMediaDevices(this); + connect(m_mediaDevices, &QMediaDevices::audioInputsChanged, this, + &AudioRecorder::updateDevices); + updateDevices(); + + // audio codecs and container formats + updateFormats(); + connect(ui->audioCodecBox, &QComboBox::currentIndexChanged, this, + &AudioRecorder::updateFormats); + connect(ui->containerBox, &QComboBox::currentIndexChanged, this, &AudioRecorder::updateFormats); + + // sample rate + constexpr auto allSamplingRates = std::array{ + 8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, + 48000, 64000, 88200, 96000, 128000, 176400, 192000, + }; + + QAudioDevice device = m_captureSession.audioInput()->device(); + int minSamplingRate = device.minimumSampleRate(); + int maxSamplingRate = device.maximumSampleRate(); + + for (int rate : allSamplingRates) { + if (rate < minSamplingRate || rate > maxSamplingRate) + continue; + ui->sampleRateBox->addItem(QString::number(rate), rate); + } + int preferredRate = device.preferredFormat().sampleRate(); + if (preferredRate > 0) { + int index = ui->sampleRateBox->findData(device.preferredFormat().sampleRate()); + ui->sampleRateBox->setCurrentIndex(index); + } + + connect(m_audioRecorder, &QMediaRecorder::durationChanged, this, + &AudioRecorder::updateProgress); + connect(m_audioRecorder, &QMediaRecorder::recorderStateChanged, this, + &AudioRecorder::onStateChanged); + connect(m_audioRecorder, &QMediaRecorder::errorChanged, this, + &AudioRecorder::displayErrorMessage); + connect(m_audioRecorder, &QMediaRecorder::mediaFormatChanged, this, + &AudioRecorder::onMediaFormatChanged); +} + +void AudioRecorder::updateProgress(qint64 duration) +{ + if (m_audioRecorder->error() != QMediaRecorder::NoError || duration < 2000) + return; + + ui->statusbar->showMessage(tr("Recorded %1 sec").arg(duration / 1000)); +} + +void AudioRecorder::onStateChanged(QMediaRecorder::RecorderState state) +{ + QString statusMessage; + + switch (state) { + case QMediaRecorder::RecordingState: + statusMessage = tr("Recording to %1").arg(m_audioRecorder->actualLocation().toString()); + ui->recordButton->setText(tr("Stop")); + ui->pauseButton->setText(tr("Pause")); + break; + case QMediaRecorder::PausedState: + statusMessage = tr("Paused"); + ui->recordButton->setText(tr("Stop")); + ui->pauseButton->setText(tr("Resume")); + break; + case QMediaRecorder::StoppedState: + statusMessage = tr("Stopped"); + ui->recordButton->setText(tr("Record")); + ui->pauseButton->setText(tr("Pause")); + break; + } + + ui->pauseButton->setEnabled(m_audioRecorder->recorderState() != QMediaRecorder::StoppedState); + if (m_audioRecorder->error() == QMediaRecorder::NoError) + ui->statusbar->showMessage(statusMessage); +} + +static QVariant boxValue(const QComboBox *box) +{ + int idx = box->currentIndex(); + if (idx == -1) + return QVariant(); + + return box->itemData(idx); +} + +void AudioRecorder::toggleRecord() +{ + if (!m_audioRecorder) { + ui->statusbar->showMessage(QStringLiteral("AudioRecorder not set. " + "Microphone permission was not granted!")); + return; + } + + if (m_audioRecorder->recorderState() == QMediaRecorder::StoppedState) { + m_captureSession.audioInput()->setDevice( + boxValue(ui->audioDeviceBox).value()); + + m_audioRecorder->setMediaFormat(selectedMediaFormat()); + m_audioRecorder->setAudioSampleRate(boxValue(ui->sampleRateBox).toInt()); + m_audioRecorder->setAudioBitRate(boxValue(ui->bitrateBox).toInt()); + m_audioRecorder->setAudioChannelCount(boxValue(ui->channelsBox).toInt()); + m_audioRecorder->setQuality(QMediaRecorder::Quality(ui->qualitySlider->value())); + m_audioRecorder->setEncodingMode(ui->constantQualityRadioButton->isChecked() + ? QMediaRecorder::ConstantQualityEncoding + : QMediaRecorder::ConstantBitRateEncoding); + + m_audioRecorder->record(); + } else { + m_audioRecorder->stop(); + } +} + +void AudioRecorder::togglePause() +{ + if (m_audioRecorder->recorderState() != QMediaRecorder::PausedState) + m_audioRecorder->pause(); + else + m_audioRecorder->record(); +} + +void AudioRecorder::setOutputLocation() +{ + if (!m_audioRecorder) { + ui->statusbar->showMessage(QStringLiteral("AudioRecorder not set. " + "Microphone permission was not granted!")); + return; + } + +#ifdef Q_OS_ANDROID + QMediaFormat format = selectedMediaFormat(); + if (format.fileFormat() == QMediaFormat::UnspecifiedFormat) + format.resolveForEncoding(QMediaFormat::NoFlags); + + QString fileName = QFileDialog::getSaveFileName( + this, tr("Save Recording"), + "output." + format.mimeType().preferredSuffix()); +#else + QString fileName = QFileDialog::getSaveFileName(); +#endif + m_audioRecorder->setOutputLocation(QUrl::fromLocalFile(fileName)); + m_outputLocationSet = true; +} + +void AudioRecorder::displayErrorMessage() +{ + ui->statusbar->showMessage(m_audioRecorder->errorString()); +} + +void AudioRecorder::onMediaFormatChanged() +{ + QMediaFormat format = m_audioRecorder->mediaFormat(); + + int formatIndex = ui->containerBox->findData(format.fileFormat()); + if (formatIndex != -1) + ui->containerBox->setCurrentIndex(formatIndex); + + int codecIndex = ui->audioCodecBox->findData(QVariant::fromValue(format.audioCodec())); + if (codecIndex != -1) + ui->audioCodecBox->setCurrentIndex(codecIndex); +} + +void AudioRecorder::updateDevices() +{ + const auto currentDevice = boxValue(ui->audioDeviceBox).value(); + int currentDeviceIndex = 0; + + ui->audioDeviceBox->clear(); + + ui->audioDeviceBox->addItem(tr("Default"), {}); + + const QList audioInputs = m_mediaDevices->audioInputs(); + for (const auto &device : audioInputs) { + const auto name = device.description(); + ui->audioDeviceBox->addItem(name, QVariant::fromValue(device)); + + if (device.id() == currentDevice.id()) + currentDeviceIndex = ui->audioDeviceBox->count() - 1; + } + + ui->audioDeviceBox->setCurrentIndex(currentDeviceIndex); +} + +void AudioRecorder::updateFormats() +{ + if (m_updatingFormats) + return; + m_updatingFormats = true; + + QMediaFormat format; + if (ui->containerBox->count()) + format.setFileFormat(boxValue(ui->containerBox).value()); + + // Add all supported formats, remembering the previous choice + int currentIndex = 0; + ui->containerBox->clear(); + ui->containerBox->addItem(tr("Default file format"), + QVariant::fromValue(QMediaFormat::UnspecifiedFormat)); + + const QList supportedFormats = format.supportedFileFormats(QMediaFormat::Encode); + for (auto container : supportedFormats) { + if (container < QMediaFormat::Mpeg4Audio) // Skip video formats + continue; + if (container == format.fileFormat()) + currentIndex = ui->containerBox->count(); + ui->containerBox->addItem(QMediaFormat::fileFormatDescription(container), + QVariant::fromValue(container)); + } + ui->containerBox->setCurrentIndex(currentIndex); + + // Re-populate codecs, adding only those that the chosen file format supports. + // Remember current codec if it is supported by the file format. + QMediaFormat::AudioCodec currentCodec = QMediaFormat::AudioCodec::Unspecified; + if (ui->audioCodecBox->count()) + currentCodec = boxValue(ui->audioCodecBox).value(); + + currentIndex = 0; + ui->audioCodecBox->clear(); + ui->audioCodecBox->addItem(tr("Default audio codec"), + QVariant::fromValue(QMediaFormat::AudioCodec::Unspecified)); + + const QList supportedCodecs = format.supportedAudioCodecs(QMediaFormat::Encode); + for (auto codec : supportedCodecs) { + if (codec == currentCodec) + currentIndex = ui->audioCodecBox->count(); + ui->audioCodecBox->addItem(QMediaFormat::audioCodecDescription(codec), + QVariant::fromValue(codec)); + } + ui->audioCodecBox->setCurrentIndex(currentIndex); + + m_updatingFormats = false; +} + +QMediaFormat AudioRecorder::selectedMediaFormat() const +{ + QMediaFormat format; + format.setFileFormat(boxValue(ui->containerBox).value()); + format.setAudioCodec(boxValue(ui->audioCodecBox).value()); + return format; +} diff --git a/examples/multimedia/audiorecorder/audiorecorder.h b/examples/multimedia/audiorecorder/audiorecorder.h new file mode 100644 index 0000000..059e448 --- /dev/null +++ b/examples/multimedia/audiorecorder/audiorecorder.h @@ -0,0 +1,54 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIORECORDER_H +#define AUDIORECORDER_H + +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE +namespace Ui { +class AudioRecorder; +} +class QAudioBuffer; +class QMediaDevices; +QT_END_NAMESPACE + +class AudioRecorder : public QMainWindow +{ + Q_OBJECT + +public: + AudioRecorder(); + +private slots: + void init(); + void setOutputLocation(); + void togglePause(); + void toggleRecord(); + + void onStateChanged(QMediaRecorder::RecorderState); + void updateProgress(qint64 pos); + void displayErrorMessage(); + void onMediaFormatChanged(); + + void updateDevices(); + void updateFormats(); + +private: + QMediaFormat selectedMediaFormat() const; + + Ui::AudioRecorder *ui = nullptr; + + QMediaCaptureSession m_captureSession; + QMediaRecorder *m_audioRecorder = nullptr; + QMediaDevices *m_mediaDevices = nullptr; + + bool m_outputLocationSet = false; + bool m_updatingFormats = false; +}; + +#endif // AUDIORECORDER_H diff --git a/examples/multimedia/audiorecorder/audiorecorder.pro b/examples/multimedia/audiorecorder/audiorecorder.pro new file mode 100644 index 0000000..c92854b --- /dev/null +++ b/examples/multimedia/audiorecorder/audiorecorder.pro @@ -0,0 +1,23 @@ +TEMPLATE = app +TARGET = audiorecorder + +QT += multimedia +CONFIG += add_ios_ffmpeg_libraries + +win32:INCLUDEPATH += $$PWD + +HEADERS = \ + audiorecorder.h +SOURCES = \ + main.cpp \ + audiorecorder.cpp +FORMS += audiorecorder.ui + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/audiorecorder +INSTALLS += target + +QT+=widgets + +macos: QMAKE_INFO_PLIST = Info.qmake.macos.plist +ios: QMAKE_INFO_PLIST = Info.qmake.ios.plist + diff --git a/examples/multimedia/audiorecorder/audiorecorder.ui b/examples/multimedia/audiorecorder/audiorecorder.ui new file mode 100644 index 0000000..213561d --- /dev/null +++ b/examples/multimedia/audiorecorder/audiorecorder.ui @@ -0,0 +1,260 @@ + + + AudioRecorder + + + + 0 + 0 + 297 + 476 + + + + Qt Multimedia Audio Recorder + + + + + + + Output... + + + + + + + false + + + Pause + + + + + + + Encoding Mode: + + + + + + Constant Quality: + + + true + + + + + + + Qt::Orientation::Horizontal + + + QSizePolicy::Policy::Fixed + + + + 40 + 20 + + + + + + + + Qt::Orientation::Horizontal + + + + + + + Constant Bitrate: + + + + + + + Qt::Orientation::Horizontal + + + QSizePolicy::Policy::Fixed + + + + 40 + 20 + + + + + + + + false + + + + + + + + + + + + Sample rate: + + + + + + + + + + Audio Codec: + + + + + + + Input Device: + + + + + + + File Container: + + + + + + + + + + + + + Channels: + + + + + + + + + + + + + + + Record + + + + + + + + + + + constantQualityRadioButton + toggled(bool) + qualitySlider + setEnabled(bool) + + + 113 + 197 + + + 115 + 223 + + + + + constantBitrateRadioButton + toggled(bool) + bitrateBox + setEnabled(bool) + + + 173 + 259 + + + 190 + 291 + + + + + outputButton + clicked() + AudioRecorder + setOutputLocation() + + + 46 + 340 + + + 6 + 302 + + + + + recordButton + clicked() + AudioRecorder + toggleRecord() + + + 191 + 340 + + + 113 + 317 + + + + + pauseButton + clicked() + AudioRecorder + togglePause() + + + 252 + 334 + + + 258 + 346 + + + + + + setOutputLocation() + toggleRecord() + togglePause() + + diff --git a/examples/multimedia/audiorecorder/doc/images/audiorecorder.png b/examples/multimedia/audiorecorder/doc/images/audiorecorder.png new file mode 100644 index 0000000000000000000000000000000000000000..6643bf32057eb9b69a7d28403aaf612cb612368b GIT binary patch literal 28212 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.toString()); + audioRecorder->setMediaFormat(format); + audioRecorder->setSampleRate(boxValue(ui->sampleRateBox).toInt()); + audioRecorder->setBitRate(boxValue(ui->bitrateBox).toInt()); + audioRecorder->setQuality(QMediaRecorder::EncodingQuality(ui->qualitySlider->value())); + audioRecorder->setEncodingMode(ui->constantQualityRadioButton->isChecked() ? + QMediaRecorder::ConstantQualityEncoding : + QMediaRecorder::ConstantBitRateEncoding); + + QString container = boxValue(ui->containerBox).toString(); + + audioRecorder->record(); + \endcode + + While recording, the status bar of the application is updated with duration information + from the \l{QMediaRecorder::durationChanged()}{durationChanged} signal from the + \c audioRecorder object. + + \code + ui->statusbar->showMessage(tr("Recorded %1 sec").arg(duration / 1000)); + \endcode +*/ diff --git a/examples/multimedia/audiorecorder/main.cpp b/examples/multimedia/audiorecorder/main.cpp new file mode 100644 index 0000000..4077296 --- /dev/null +++ b/examples/multimedia/audiorecorder/main.cpp @@ -0,0 +1,16 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiorecorder.h" + +#include + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + + AudioRecorder recorder; + recorder.show(); + + return app.exec(); +} diff --git a/examples/multimedia/audiosource/CMakeLists.txt b/examples/multimedia/audiosource/CMakeLists.txt new file mode 100644 index 0000000..756205b --- /dev/null +++ b/examples/multimedia/audiosource/CMakeLists.txt @@ -0,0 +1,41 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiosource LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/audiosource") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Widgets) + +qt_add_executable(audiosource + audiosource.cpp audiosource.h + main.cpp +) + +qt_add_ios_ffmpeg_libraries(audiosource) + +set_target_properties(audiosource PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in +) + +target_link_libraries(audiosource PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Widgets +) + +install(TARGETS audiosource + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/audiosource/Info.plist.in b/examples/multimedia/audiosource/Info.plist.in new file mode 100644 index 0000000..43b9665 --- /dev/null +++ b/examples/multimedia/audiosource/Info.plist.in @@ -0,0 +1,44 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/audiosource/Info.qmake.ios.plist b/examples/multimedia/audiosource/Info.qmake.ios.plist new file mode 100644 index 0000000..b5252bb --- /dev/null +++ b/examples/multimedia/audiosource/Info.qmake.ios.plist @@ -0,0 +1,41 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/audiosource/Info.qmake.macos.plist b/examples/multimedia/audiosource/Info.qmake.macos.plist new file mode 100644 index 0000000..252d4c6 --- /dev/null +++ b/examples/multimedia/audiosource/Info.qmake.macos.plist @@ -0,0 +1,32 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + NSPrincipalClass + NSApplication + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/audiosource/audiosource.cpp b/examples/multimedia/audiosource/audiosource.cpp new file mode 100644 index 0000000..bf36f3c --- /dev/null +++ b/examples/multimedia/audiosource/audiosource.cpp @@ -0,0 +1,516 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiosource.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#if QT_CONFIG(permissions) +# include +# include +#endif + +namespace { + +using namespace std::chrono_literals; +constexpr auto visualizerUpdateInterval = 16ms; +constexpr int volumeSliderMaximum = 100; + +float calculateLevel(const char *data, qint64 len, const QAudioFormat &format) +{ + const int channelBytes = format.bytesPerSample(); + const int sampleBytes = format.bytesPerFrame(); + Q_ASSERT(format.bytesPerFrame() != 0); // divide by 0 + const quint64 numSamples = len / sampleBytes; + + float maxValue = 0; + const auto *ptr = reinterpret_cast(data); + + for (int i = 0; i < int(numSamples); ++i) { + for (int j = 0; j < format.channelCount(); ++j) { + float value = format.normalizedSampleValue(ptr); + + maxValue = qMax(value, maxValue); + ptr += channelBytes; + } + } + return maxValue; +} + +using namespace Qt::Literals::StringLiterals; +QString sampleFormatToString(QAudioFormat::SampleFormat f) +{ + switch (f) { + case QAudioFormat::UInt8: return u"UInt8"_s; + case QAudioFormat::Int16: return u"Int16"_s; + case QAudioFormat::Int32: return u"Int32"_s; + case QAudioFormat::Float: return u"Float"_s; + default: return u"Unknown"_s; + } +} + +constexpr std::array allSupportedSampleRates{ + 8'000, 11'025, 12'000, 16'000, 22'050, 24'000, 32'000, 44'100, + 48'000, 64'000, 88'200, 96'000, 128'000, 176'400, 192'000, +}; + +template +void setCurrentValue(QComboBox *box, const T &value) +{ + int idx = box->findData(QVariant::fromValue(value)); + if (idx >= 0) + box->setCurrentIndex(idx); +} + +void syncFormatGui(QComboBox *m_formatBox, QComboBox *m_channelsBox, QComboBox *m_rateBox, + const QAudioFormat &format) +{ + setCurrentValue(m_formatBox, format.sampleFormat()); + setCurrentValue(m_rateBox, format.sampleRate()); + setCurrentValue(m_channelsBox, format.channelCount()); +} + +} // namespace + +AudioInfo::AudioInfo(const QAudioFormat &format) : m_format(format) { } + +void AudioInfo::start() +{ + open(QIODevice::WriteOnly); +} + +void AudioInfo::stop() +{ + close(); +} + +qint64 AudioInfo::readData(char * /* data */, qint64 /* maxlen */) +{ + return 0; +} + +qint64 AudioInfo::writeData(const char *data, qint64 len) +{ + m_level = calculateLevel(data, len, m_format); + + emit levelChanged(m_level); + + return len; +} + +RenderArea::RenderArea(QWidget *parent) : QWidget(parent) +{ + setBackgroundRole(QPalette::Base); + setAutoFillBackground(true); + + setMinimumHeight(30); + setMinimumWidth(200); +} + +void RenderArea::paintEvent(QPaintEvent * /* event */) +{ + QPainter painter(this); + + painter.setPen(Qt::black); + + const QRect frame = painter.viewport() - QMargins(10, 10, 10, 10); + painter.drawRect(frame); + if (m_level == 0.0) + return; + + float remappedLevel = QtAudio::convertVolume(m_level, QtAudio::LinearVolumeScale, + QtAudio::LogarithmicVolumeScale); + + const int pos = qRound(qreal(frame.width() - 1) * remappedLevel); + painter.fillRect(frame.left() + 1, frame.top() + 1, pos, frame.height() - 1, Qt::red); +} + +void RenderArea::setLevel(float value) +{ + m_level = value; + update(); +} + +InputTest::InputTest() : m_devices(new QMediaDevices(this)) +{ + init(); +} + +InputTest::~InputTest() +{ + cleanupAudioSource(); +} + +void InputTest::initializeWindow() +{ + auto *layout = new QVBoxLayout(this); + + m_canvas = new RenderArea(this); + layout->addWidget(m_canvas); + + m_deviceBox = new QComboBox(this); + QAudioDevice defaultDevice = QMediaDevices::defaultAudioInput(); + for (auto &deviceInfo : QMediaDevices::audioInputs()) + m_deviceBox->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); + auto defaultDeviceIndex = m_deviceBox->findData(QVariant::fromValue(defaultDevice)); + m_deviceBox->setCurrentIndex(defaultDeviceIndex); + + connect(m_deviceBox, &QComboBox::activated, this, &InputTest::deviceChanged); + connect(m_devices, &QMediaDevices::audioInputsChanged, this, &InputTest::updateAudioDevices); + layout->addWidget(m_deviceBox); + + m_modeBox = new QComboBox(this); + m_modeBox->addItem(tr("Pull Mode")); + m_modeBox->addItem(tr("Push Mode")); + m_modeBox->addItem(tr("Callback Mode")); + m_modeBox->setCurrentIndex(qToUnderlying(m_mode)); + connect(m_modeBox, &QComboBox::currentIndexChanged, this, [this](int index) { + m_mode = AudioTestMode(index); + restartAudioStream(); + }); + layout->addWidget(m_modeBox); + + m_suspendResumeButton = new QPushButton(this); + connect(m_suspendResumeButton, &QPushButton::clicked, this, &InputTest::toggleSuspend); + layout->addWidget(m_suspendResumeButton); + + m_volumeSlider = new QSlider(Qt::Horizontal, this); + m_volumeSlider->setRange(0, volumeSliderMaximum); + m_volumeSlider->setValue(volumeSliderMaximum); + connect(m_volumeSlider, &QSlider::valueChanged, this, &InputTest::sliderChanged); + layout->addWidget(m_volumeSlider); + + auto *formatBox = new QHBoxLayout; + + // Sample format selector + auto *formatLabel = new QLabel(tr("Sample Format:")); + m_formatBox = new QComboBox(this); + + // Sample rate selector + auto *rateLabel = new QLabel(tr("Sample Rate:")); + m_rateBox = new QComboBox(this); + + // Channel count selector + auto *chLabel = new QLabel(tr("Channels:")); + m_channelsBox = new QComboBox(this); + + for (auto *box : { m_channelsBox, m_rateBox, m_formatBox }) + connect(box, &QComboBox::activated, this, [this, box]() { formatChanged(box); }); + + // add all to the same row + const int horizontalSpacing = 12; + formatBox->addWidget(formatLabel); + formatBox->addWidget(m_formatBox); + formatBox->addSpacing(horizontalSpacing); + formatBox->addWidget(rateLabel); + formatBox->addWidget(m_rateBox); + formatBox->addSpacing(horizontalSpacing); + formatBox->addWidget(chLabel); + formatBox->addWidget(m_channelsBox); + + layout->addLayout(formatBox); +} + +void InputTest::startAudioSource(const QAudioDevice &device, const QAudioFormat &format) +{ + if (m_audioSource) + cleanupAudioSource(); + + m_audioSource = std::make_unique(device, format); + + m_currentDevice = device; + + syncFormatGui(m_formatBox, m_channelsBox, m_rateBox, m_audioSource->format()); + + connect(m_audioSource.get(), &QAudioSource::stateChanged, this, + [this, device](QAudio::State state) { + switch (state) { + case QAudio::ActiveState: + m_suspendResumeButton->setText(tr("Suspend capture")); + return; + case QAudio::SuspendedState: + m_suspendResumeButton->setText(tr("Resume capture")); + return; + default: + break; + } + + const auto err = m_audioSource->error(); + + // startup failure (format rejected or device unavailable) + if (err == QAudio::OpenError && state == QAudio::StoppedState) { + QMessageBox::warning(this, tr("Audio start failed"), + tr("Device rejected the format or is unavailable.")); + return; + } + + // runtime I/O or fatal device error (disconnects, etc.) + if (err == QAudio::IOError || err == QAudio::FatalError) { + if (m_currentDevice == device) { + m_currentDevice = {}; + m_deviceBox->setCurrentIndex(-1); + } + QMessageBox::warning(this, tr("Audio error"), tr("Audio device error.")); + return; + } + }); + + m_audioInfo = std::make_unique(format); + connect(m_audioInfo.get(), &AudioInfo::levelChanged, m_canvas, &RenderArea::setLevel); + + float initialVolume = + QAudio::convertVolume(float(m_audioSource->volume()), QAudio::LinearVolumeScale, + QAudio::LogarithmicVolumeScale); + m_volumeSlider->setValue(qRound(initialVolume * volumeSliderMaximum)); + + m_audioInfo->start(); + restartAudioStream(); +} + +void InputTest::cleanupAudioSource() +{ + if (m_audioInfo) + m_audioInfo->stop(); + + if (m_audioSource) { + m_audioSource->stop(); + m_audioSource->disconnect(this); + } + + m_audioSource.reset(); + m_currentDevice = {}; +} + +void InputTest::initializeErrorWindow() +{ + auto *layout = new QVBoxLayout(this); + auto *errorLabel = new QLabel(tr("Microphone permission is not granted!")); + errorLabel->setWordWrap(true); + errorLabel->setAlignment(Qt::AlignCenter); + layout->addWidget(errorLabel); +} + +void InputTest::restartAudioStream() +{ + m_audioSource->stop(); + + if (m_callbackVisualizerTimer.isActive()) + m_callbackVisualizerTimer.stop(); + + switch (m_mode) { + case AudioTestMode::Pull: { + // pull mode: QAudioSource provides a QIODevice to pull from + auto *io = m_audioSource->start(); + if (!io) + return; + + connect(io, &QIODevice::readyRead, this, [this, io]() { + static const qint64 BufferSize = 4096; + const qint64 len = qMin(m_audioSource->bytesAvailable(), BufferSize); + + QByteArray buffer(len, 0); + qint64 bytesRead = io->read(buffer.data(), len); + if (bytesRead > 0) { + const float level = + calculateLevel(buffer.constData(), bytesRead, m_audioSource->format()); + m_canvas->setLevel(level); + } + }); + break; + } + case AudioTestMode::Push: { + // push mode: QIODevice pushes data into QIODevice + m_audioSource->start(m_audioInfo.get()); + break; + } + case AudioTestMode::Callback: { + // callback mode: QAudioSource calls a callback function on audio thread with a buffer to read from + QAudioFormat format = m_audioSource->format(); + switch (format.sampleFormat()) { + case QAudioFormat::UInt8: + m_audioSource->start([this, format](QSpan buffer) { + processCallback(buffer, format); + }); + break; + case QAudioFormat::Int16: + m_audioSource->start([this, format](QSpan buffer) { + processCallback(buffer, format); + }); + break; + case QAudioFormat::Int32: + m_audioSource->start([this, format](QSpan buffer) { + processCallback(buffer, format); + }); + break; + case QAudioFormat::Float: + m_audioSource->start([this, format](QSpan buffer) { + processCallback(buffer, format); + }); + break; + default: + Q_UNREACHABLE(); + }; + + m_callbackVisualizerTimer.start(visualizerUpdateInterval, Qt::PreciseTimer, this); + break; + } + default: + Q_UNREACHABLE(); + } + + if (m_audioSource->error() != QAudio::NoError) { + QMessageBox::warning(this, tr("Audio start failed"), + tr("Device rejected the format or is unavailable.")); + } +} + +void InputTest::timerEvent(QTimerEvent *event) +{ + if (event->timerId() == m_callbackVisualizerTimer.timerId()) + m_canvas->setLevel(m_level.exchange(0.f)); +} + +template +void InputTest::processCallback(QSpan buffer, const QAudioFormat &format) +{ + float level = calculateLevel(reinterpret_cast(buffer.data()), buffer.size_bytes(), + format); + float lastLevel = m_level.load(std::memory_order_relaxed); + while (!m_level.compare_exchange_weak(lastLevel, std::max(level, lastLevel))) + ; +} + +void InputTest::init() +{ +#if QT_CONFIG(permissions) + QMicrophonePermission microphonePermission; + switch (qApp->checkPermission(microphonePermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(microphonePermission, this, &InputTest::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Microphone permission is not granted!"); + initializeErrorWindow(); + return; + case Qt::PermissionStatus::Granted: + break; + } +#endif + initializeWindow(); + deviceChanged(m_deviceBox->currentIndex()); +} + +void InputTest::toggleSuspend() +{ + // toggle suspend/resume + switch (m_audioSource->state()) { + case QAudio::SuspendedState: + m_audioSource->resume(); + break; + case QAudio::ActiveState: + m_audioSource->suspend(); + break; + default: + // no-op + break; + } +} + +void InputTest::deviceChanged(int index) +{ + auto device = m_deviceBox->itemData(index).value(); + + // clear format selectors + m_formatBox->clear(); + m_channelsBox->clear(); + m_rateBox->clear(); + + // Populate format selectors + if (!device.isNull()) { + // sample formats + const auto formats = device.supportedSampleFormats(); + for (const QAudioFormat::SampleFormat sf : formats) + m_formatBox->addItem(sampleFormatToString(sf), QVariant::fromValue(sf)); + + // channels + for (int ch = device.minimumChannelCount(); ch <= device.maximumChannelCount(); ++ch) + m_channelsBox->addItem(QString::number(ch), ch); + + // populate from the hardcoded list + for (int rate : allSupportedSampleRates) { + if (rate < device.minimumSampleRate() || rate > device.maximumSampleRate()) + continue; + m_rateBox->addItem(QString::number(rate), rate); + } + } + + if (device != m_currentDevice) { + cleanupAudioSource(); + if (!device.isNull()) { + startAudioSource(m_deviceBox->itemData(index).value(), + device.preferredFormat()); + } + } +} + +void InputTest::sliderChanged(int value) +{ + float linearVolume = + QAudio::convertVolume(float(value) / float(volumeSliderMaximum), + QAudio::LogarithmicVolumeScale, QAudio::LinearVolumeScale); + + m_audioSource->setVolume(linearVolume); +} + +void InputTest::updateAudioDevices() +{ + QSignalBlocker blockUpdates(m_deviceBox); + + m_deviceBox->clear(); + + const QList devices = QMediaDevices::audioInputs(); + for (const QAudioDevice &deviceInfo : devices) + m_deviceBox->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); + const int currentDeviceIndex = m_deviceBox->findData(QVariant::fromValue(m_currentDevice)); + if (currentDeviceIndex != -1) { + // select previous device + m_deviceBox->setCurrentIndex(currentDeviceIndex); + } else { + blockUpdates.unblock(); + // select default device + QAudioDevice defaultDevice = QMediaDevices::defaultAudioInput(); + const int defaultDeviceIndex = m_deviceBox->findData(QVariant::fromValue(defaultDevice)); + const int currentIndex = m_deviceBox->currentIndex(); + m_deviceBox->setCurrentIndex(defaultDeviceIndex); + if (defaultDeviceIndex == currentIndex) { + // device changed, reinitialize audio + deviceChanged(defaultDeviceIndex); + } + } +} + +void InputTest::formatChanged(QComboBox *box) +{ + auto device = m_deviceBox->currentData().value(); + QAudioFormat newFormat = m_audioSource->format(); + + if (box == m_formatBox) { + newFormat.setSampleFormat(QAudioFormat::SampleFormat(box->currentData().toInt())); + } else if (box == m_rateBox) { + newFormat.setSampleRate(box->currentData().toInt()); + } else if (box == m_channelsBox) { + newFormat.setChannelCount(box->currentData().toInt()); + } + + startAudioSource(device, newFormat); +} + +#include "moc_audiosource.cpp" diff --git a/examples/multimedia/audiosource/audiosource.h b/examples/multimedia/audiosource/audiosource.h new file mode 100644 index 0000000..ed0cd9e --- /dev/null +++ b/examples/multimedia/audiosource/audiosource.h @@ -0,0 +1,116 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIOINPUT_H +#define AUDIOINPUT_H + +#include +#include + +#include + +#include +#include +#include +#include + +#include +#include + +#include +#include + +class AudioInfo : public QIODevice +{ + Q_OBJECT + +public: + AudioInfo(const QAudioFormat &format); + + void start(); + void stop(); + + [[nodiscard]] float level() const { return m_level; } + + qint64 readData(char *data, qint64 maxlen) override; + qint64 writeData(const char *data, qint64 len) override; + +signals: + void levelChanged(float level); + +private: + const QAudioFormat m_format; + float m_level = 0.f; // 0.0 <= m_level <= 1.0 +}; + +enum class AudioTestMode : uint8_t { + Pull, + Push, + Callback, +}; + +class RenderArea : public QWidget +{ + Q_OBJECT + +public: + explicit RenderArea(QWidget *parent = nullptr); + + void setLevel(float value); + +protected: + void paintEvent(QPaintEvent *event) override; + +private: + float m_level = 0.f; +}; + +class InputTest final : public QWidget +{ + Q_OBJECT + +public: + InputTest(); + ~InputTest() override; + +private: + void initializeWindow(); + void startAudioSource(const QAudioDevice &, const QAudioFormat &); + void cleanupAudioSource(); + void initializeErrorWindow(); + void restartAudioStream(); + void timerEvent(QTimerEvent *) override; + + template + void processCallback(QSpan buffer, const QAudioFormat &format); + +private slots: + void init(); + void toggleSuspend(); + void deviceChanged(int index); + void sliderChanged(int value); + void updateAudioDevices(); + void formatChanged(QComboBox *box); + +private: + // Owned by layout + RenderArea *m_canvas = nullptr; + QComboBox *m_modeBox = nullptr; + QPushButton *m_suspendResumeButton = nullptr; + QComboBox *m_deviceBox = nullptr; + QSlider *m_volumeSlider = nullptr; + QComboBox *m_formatBox = nullptr; + QComboBox *m_rateBox = nullptr; + QComboBox *m_channelsBox = nullptr; + + QMediaDevices *m_devices = nullptr; + QAudioDevice m_currentDevice; + std::unique_ptr m_audioInfo; + std::unique_ptr m_audioSource; + AudioTestMode m_mode = AudioTestMode::Pull; + + QBasicTimer m_callbackVisualizerTimer; + std::atomic m_level = 0.f; +}; + +#endif // AUDIOINPUT_H diff --git a/examples/multimedia/audiosource/audiosource.pro b/examples/multimedia/audiosource/audiosource.pro new file mode 100644 index 0000000..6687c20 --- /dev/null +++ b/examples/multimedia/audiosource/audiosource.pro @@ -0,0 +1,16 @@ +TEMPLATE = app +TARGET = audiosource + +QT += multimedia widgets +CONFIG += add_ios_ffmpeg_libraries + +HEADERS = audiosource.h + +SOURCES = audiosource.cpp \ + main.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/audiosource +INSTALLS += target + +macos: QMAKE_INFO_PLIST = Info.qmake.macos.plist +ios: QMAKE_INFO_PLIST = Info.qmake.ios.plist diff --git a/examples/multimedia/audiosource/doc/images/audiosource-example.png b/examples/multimedia/audiosource/doc/images/audiosource-example.png new file mode 100644 index 0000000000000000000000000000000000000000..9ee5c9673ba01b232107af5cf21f46ed7061192d GIT binary patch literal 8180 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ğM6;&#nFewXujOhVwYlTzea?F8g7E(s4bs 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/audiosource/doc/src/audiosource.qdoc b/examples/multimedia/audiosource/doc/src/audiosource.qdoc new file mode 100644 index 0000000..dac55ab --- /dev/null +++ b/examples/multimedia/audiosource/doc/src/audiosource.qdoc @@ -0,0 +1,28 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example audiosource + \title Audio Source Example + \ingroup multimedia_examples + \ingroup audio_examples + \examplecategory {Multimedia} + \brief Recording audio using the QAudioSource class. + \meta {tag} {widgets} + + \e{Audio Source} demonstrates the basic use cases of QAudioSource. + + \image audiosource-example.png + {UI showing real-time audio waveform and control buttons} + + Qt provides the QAudioSource class to enable audio functionality within + a standard application user interface. + + This example calculates the maximum linear value of the input audio from the + microphone and displays the output. The UI allows the user to select the + audio input device, pause and resume the audio stream, switch between + different modes of operation, adjust the volume and change the audio format + parameters. + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/audiosource/main.cpp b/examples/multimedia/audiosource/main.cpp new file mode 100644 index 0000000..49156d8 --- /dev/null +++ b/examples/multimedia/audiosource/main.cpp @@ -0,0 +1,17 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiosource.h" + +#include + +int main(int argv, char **args) +{ + QApplication app(argv, args); + QCoreApplication::setApplicationName("Audio Source Test"); + + InputTest input; + input.show(); + + return QCoreApplication::exec(); +} diff --git a/examples/multimedia/camera/CMakeLists.txt b/examples/multimedia/camera/CMakeLists.txt new file mode 100644 index 0000000..45ee646 --- /dev/null +++ b/examples/multimedia/camera/CMakeLists.txt @@ -0,0 +1,83 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(camera LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) +set(CMAKE_AUTOUIC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/camera") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia MultimediaWidgets Widgets) + +set(camera_form "") +set(videosettings_form "") +if(ANDROID OR IOS) + set(camera_form camera_mobile.ui) + set(videosettings_form videosettings_mobile.ui) +else() + set(camera_form camera.ui) + set(videosettings_form videosettings.ui) +endif() + +qt_add_executable(camera + MANUAL_FINALIZATION + camera.cpp camera.h ${camera_form} + imagesettings.cpp imagesettings.h imagesettings.ui + main.cpp + videosettings.cpp videosettings.h ${videosettings_form} + metadatadialog.cpp metadatadialog.h +) + +set_target_properties(camera PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +if(APPLE AND NOT IOS) + set_target_properties(camera PROPERTIES + MACOSX_BUNDLE_INFO_PLIST "${CMAKE_CURRENT_SOURCE_DIR}/macos/Info.plist.in" + ) +elseif(IOS) + set_target_properties(camera PROPERTIES + MACOSX_BUNDLE_INFO_PLIST "${CMAKE_CURRENT_SOURCE_DIR}/ios/Info.plist.in" + ) +endif() + +set_property(TARGET camera APPEND PROPERTY QT_ANDROID_PACKAGE_SOURCE_DIR + ${CMAKE_CURRENT_SOURCE_DIR}/android) + +qt_add_ios_ffmpeg_libraries(camera) + +target_link_libraries(camera PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::MultimediaWidgets + Qt::Widgets +) + +# Resources: +set(camera_resource_files + "images/shutter.svg" +) + +qt_add_resources(camera "camera" + PREFIX + "/" + FILES + ${camera_resource_files} +) + +qt_finalize_executable(camera) + +install(TARGETS camera + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/camera/Info.qmake.ios.plist b/examples/multimedia/camera/Info.qmake.ios.plist new file mode 100644 index 0000000..b5252bb --- /dev/null +++ b/examples/multimedia/camera/Info.qmake.ios.plist @@ -0,0 +1,41 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/camera/Info.qmake.macos.plist b/examples/multimedia/camera/Info.qmake.macos.plist new file mode 100644 index 0000000..252d4c6 --- /dev/null +++ b/examples/multimedia/camera/Info.qmake.macos.plist @@ -0,0 +1,32 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + NSPrincipalClass + NSApplication + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/camera/android/AndroidManifest.xml b/examples/multimedia/camera/android/AndroidManifest.xml new file mode 100644 index 0000000..adfad16 --- /dev/null +++ b/examples/multimedia/camera/android/AndroidManifest.xml @@ -0,0 +1,38 @@ + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/camera/camera.cpp b/examples/multimedia/camera/camera.cpp new file mode 100644 index 0000000..2f48e0a --- /dev/null +++ b/examples/multimedia/camera/camera.cpp @@ -0,0 +1,416 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "camera.h" +#if defined(Q_OS_ANDROID) || defined(Q_OS_IOS) +# include "ui_camera_mobile.h" +#else +# include "ui_camera.h" +#endif + +#include "imagesettings.h" +#include "metadatadialog.h" +#include "videosettings.h" + +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include + +#include +#include +#include +#include +#include + +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +Camera::Camera() : ui(new Ui::Camera) +{ + ui->setupUi(this); + // disable all buttons by default + updateCameraActive(false); + readyForCapture(false); + ui->recordButton->setEnabled(false); + ui->pauseButton->setEnabled(false); + ui->stopButton->setEnabled(false); + ui->metaDataButton->setEnabled(false); + + // try to actually initialize camera & mic + init(); +} + +Camera::~Camera() = default; + +void Camera::init() +{ +#if QT_CONFIG(permissions) + // camera + QCameraPermission cameraPermission; + switch (qApp->checkPermission(cameraPermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(cameraPermission, this, &Camera::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Camera permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } + // microphone + QMicrophonePermission microphonePermission; + switch (qApp->checkPermission(microphonePermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(microphonePermission, this, &Camera::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Microphone permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } +#endif + + m_audioInput.reset(new QAudioInput); + m_captureSession.setAudioInput(m_audioInput.get()); + + // Camera devices: + + videoDevicesGroup = new QActionGroup(this); + videoDevicesGroup->setExclusive(true); + updateCameras(); + connect(&m_devices, &QMediaDevices::videoInputsChanged, this, &Camera::updateCameras); + + connect(videoDevicesGroup, &QActionGroup::triggered, this, &Camera::updateCameraDevice); + connect(ui->captureWidget, &QTabWidget::currentChanged, this, &Camera::updateCaptureMode); + + connect(ui->metaDataButton, &QPushButton::clicked, this, &Camera::showMetaDataDialog); + + setCamera(QMediaDevices::defaultVideoInput()); +} + +void Camera::setCamera(const QCameraDevice &cameraDevice) +{ + m_camera.reset(new QCamera(cameraDevice)); + m_captureSession.setCamera(m_camera.get()); + + connect(m_camera.get(), &QCamera::activeChanged, this, &Camera::updateCameraActive); + connect(m_camera.get(), &QCamera::errorOccurred, this, &Camera::displayCameraError); + + if (!m_mediaRecorder) { + m_mediaRecorder.reset(new QMediaRecorder); + m_captureSession.setRecorder(m_mediaRecorder.get()); + connect(m_mediaRecorder.get(), &QMediaRecorder::recorderStateChanged, this, + &Camera::updateRecorderState); + connect(m_mediaRecorder.get(), &QMediaRecorder::durationChanged, this, + &Camera::updateRecordTime); + connect(m_mediaRecorder.get(), &QMediaRecorder::errorChanged, this, + &Camera::displayRecorderError); + } + + if (!m_imageCapture) { + m_imageCapture.reset(new QImageCapture); + m_captureSession.setImageCapture(m_imageCapture.get()); + connect(m_imageCapture.get(), &QImageCapture::readyForCaptureChanged, this, + &Camera::readyForCapture); + connect(m_imageCapture.get(), &QImageCapture::imageCaptured, this, + &Camera::processCapturedImage); + connect(m_imageCapture.get(), &QImageCapture::imageSaved, this, &Camera::imageSaved); + connect(m_imageCapture.get(), &QImageCapture::errorOccurred, this, + &Camera::displayCaptureError); + } + + m_captureSession.setVideoOutput(ui->viewfinder); + + updateCameraActive(m_camera->isActive()); + updateRecorderState(m_mediaRecorder->recorderState()); + readyForCapture(m_imageCapture->isReadyForCapture()); + + updateCaptureMode(); + + m_camera->start(); +} + +void Camera::keyPressEvent(QKeyEvent *event) +{ + if (event->isAutoRepeat()) + return; + + switch (event->key()) { + case Qt::Key_CameraFocus: + displayViewfinder(); + event->accept(); + break; + case Qt::Key_Camera: + if (m_doImageCapture) { + takeImage(); + } else { + if (m_mediaRecorder->recorderState() == QMediaRecorder::RecordingState) + stop(); + else + record(); + } + event->accept(); + break; + default: + QMainWindow::keyPressEvent(event); + } +} + +void Camera::updateRecordTime() +{ + QString str = tr("Recorded %1 sec").arg(m_mediaRecorder->duration() / 1000); + ui->statusbar->showMessage(str); +} + +void Camera::processCapturedImage(int requestId, const QImage &img) +{ + Q_UNUSED(requestId); + QImage scaledImage = + img.scaled(ui->viewfinder->size(), Qt::KeepAspectRatio, Qt::SmoothTransformation); + + ui->lastImagePreviewLabel->setPixmap(QPixmap::fromImage(scaledImage)); + + // Display captured image for 4 seconds. + displayCapturedImage(); + QTimer::singleShot(4000, this, &Camera::displayViewfinder); +} + +void Camera::configureCaptureSettings() +{ + if (m_doImageCapture) + configureImageSettings(); + else + configureVideoSettings(); +} + +void Camera::configureVideoSettings() +{ + VideoSettings settingsDialog(m_mediaRecorder.get()); + + if (settingsDialog.exec()) + settingsDialog.applySettings(); +} + +void Camera::configureImageSettings() +{ + ImageSettings settingsDialog(m_imageCapture.get()); + + if (settingsDialog.exec() == QDialog::Accepted) + settingsDialog.applyImageSettings(); +} + +void Camera::record() +{ + m_mediaRecorder->record(); + updateRecordTime(); +} + +void Camera::pause() +{ + m_mediaRecorder->pause(); +} + +void Camera::stop() +{ + m_mediaRecorder->stop(); +} + +void Camera::setMuted(bool muted) +{ + m_captureSession.audioInput()->setMuted(muted); +} + +void Camera::takeImage() +{ + m_isCapturingImage = true; + m_imageCapture->captureToFile(); +} + +void Camera::displayCaptureError(int id, const QImageCapture::Error error, + const QString &errorString) +{ + Q_UNUSED(id); + Q_UNUSED(error); + QMessageBox::warning(this, tr("Image Capture Error"), errorString); + m_isCapturingImage = false; +} + +void Camera::startCamera() +{ + m_camera->start(); +} + +void Camera::stopCamera() +{ + m_camera->stop(); +} + +void Camera::updateCaptureMode() +{ + int tabIndex = ui->captureWidget->currentIndex(); + m_doImageCapture = (tabIndex == 0); +} + +void Camera::updateCameraActive(bool active) +{ + if (active) { + ui->actionStartCamera->setEnabled(false); + ui->actionStopCamera->setEnabled(true); + ui->captureWidget->setEnabled(true); + ui->actionSettings->setEnabled(true); + } else { + ui->actionStartCamera->setEnabled(true); + ui->actionStopCamera->setEnabled(false); + ui->captureWidget->setEnabled(false); + ui->actionSettings->setEnabled(false); + } +} + +void Camera::updateRecorderState(QMediaRecorder::RecorderState state) +{ + switch (state) { + case QMediaRecorder::StoppedState: + ui->recordButton->setEnabled(true); + ui->pauseButton->setEnabled(true); + ui->stopButton->setEnabled(false); + ui->metaDataButton->setEnabled(true); + break; + case QMediaRecorder::PausedState: + ui->recordButton->setEnabled(true); + ui->pauseButton->setEnabled(false); + ui->stopButton->setEnabled(true); + ui->metaDataButton->setEnabled(false); + break; + case QMediaRecorder::RecordingState: + ui->recordButton->setEnabled(false); + ui->pauseButton->setEnabled(true); + ui->stopButton->setEnabled(true); + ui->metaDataButton->setEnabled(false); + break; + } +} + +void Camera::displayRecorderError() +{ + if (m_mediaRecorder->error() != QMediaRecorder::NoError) + QMessageBox::warning(this, tr("Capture Error"), m_mediaRecorder->errorString()); +} + +void Camera::displayCameraError() +{ + if (m_camera->error() != QCamera::NoError) + QMessageBox::warning(this, tr("Camera Error"), m_camera->errorString()); +} + +void Camera::updateCameraDevice(QAction *action) +{ + setCamera(qvariant_cast(action->data())); +} + +void Camera::displayViewfinder() +{ + ui->stackedWidget->setCurrentIndex(0); +} + +void Camera::displayCapturedImage() +{ + ui->stackedWidget->setCurrentIndex(1); +} + +void Camera::readyForCapture(bool ready) +{ + ui->takeImageButton->setEnabled(ready); +} + +void Camera::imageSaved(int id, const QString &fileName) +{ + Q_UNUSED(id); + ui->statusbar->showMessage(tr("Captured \"%1\"").arg(QDir::toNativeSeparators(fileName))); + + m_isCapturingImage = false; + if (m_applicationExiting) + close(); +} + +void Camera::closeEvent(QCloseEvent *event) +{ + if (m_isCapturingImage) { + setEnabled(false); + m_applicationExiting = true; + event->ignore(); + } else { + event->accept(); + } +} + +void Camera::updateCameras() +{ + ui->menuDevices->clear(); + const QList availableCameras = QMediaDevices::videoInputs(); + for (const QCameraDevice &cameraDevice : availableCameras) { + QAction *videoDeviceAction = new QAction(cameraDevice.description(), videoDevicesGroup); + videoDeviceAction->setCheckable(true); + videoDeviceAction->setData(QVariant::fromValue(cameraDevice)); + if (cameraDevice == QMediaDevices::defaultVideoInput()) + videoDeviceAction->setChecked(true); + + ui->menuDevices->addAction(videoDeviceAction); + } +} + +void Camera::showMetaDataDialog() +{ + if (!m_metaDataDialog) + m_metaDataDialog = new MetaDataDialog(this); + m_metaDataDialog->setAttribute(Qt::WA_DeleteOnClose, false); + if (m_metaDataDialog->exec() == QDialog::Accepted) + saveMetaData(); +} + +void Camera::saveMetaData() +{ + QMediaMetaData data; + for (int i = 0; i < QMediaMetaData::NumMetaData; i++) { + QString val = m_metaDataDialog->m_metaDataFields[i]->text(); + if (!val.isEmpty()) { + const auto key = static_cast(i); + switch (key) { + case QMediaMetaData::CoverArtImage: { + QImage coverArt(val); + data.insert(key, coverArt); + break; + } + case QMediaMetaData::ThumbnailImage: { + QImage thumbnail(val); + data.insert(key, thumbnail); + break; + } + case QMediaMetaData::Date: { + QDateTime date = QDateTime::fromString(val); + data.insert(key, date); + break; + } + case QMediaMetaData::HasHdrContent: + break; + default: + data.insert(key, val); + } + } + } + m_mediaRecorder->setMetaData(data); +} + +#include "moc_camera.cpp" diff --git a/examples/multimedia/camera/camera.h b/examples/multimedia/camera/camera.h new file mode 100644 index 0000000..eaa9143 --- /dev/null +++ b/examples/multimedia/camera/camera.h @@ -0,0 +1,104 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef CAMERA_H +#define CAMERA_H + +#include +#include +#include +#include +#include +#include +#include +#include + +#include + +QT_BEGIN_NAMESPACE +namespace Ui { +class Camera; +} +class QActionGroup; +QT_END_NAMESPACE + +class MetaDataDialog; + +class Camera : public QMainWindow +{ + Q_OBJECT + +public: + Camera(); + ~Camera(); + +public slots: + void saveMetaData(); + +private slots: + void init(); + + void setCamera(const QCameraDevice &cameraDevice); + + void startCamera(); + void stopCamera(); + + void record(); + void pause(); + void stop(); + void setMuted(bool); + + void takeImage(); + void displayCaptureError(int, QImageCapture::Error, const QString &errorString); + + void configureCaptureSettings(); + void configureVideoSettings(); + void configureImageSettings(); + + void displayRecorderError(); + void displayCameraError(); + + void updateCameraDevice(QAction *action); + + void updateCameraActive(bool active); + void updateCaptureMode(); + void updateRecorderState(QMediaRecorder::RecorderState state); + + void updateRecordTime(); + + void processCapturedImage(int requestId, const QImage &img); + + void displayViewfinder(); + void displayCapturedImage(); + + void readyForCapture(bool ready); + void imageSaved(int id, const QString &fileName); + + void updateCameras(); + + void showMetaDataDialog(); + +protected: + void keyPressEvent(QKeyEvent *event) override; + void closeEvent(QCloseEvent *event) override; + +private: + std::unique_ptr ui; + + QActionGroup *videoDevicesGroup = nullptr; + + QMediaDevices m_devices; + std::unique_ptr m_imageCapture; + QMediaCaptureSession m_captureSession; + std::unique_ptr m_camera; + std::unique_ptr m_audioInput; + std::unique_ptr m_mediaRecorder; + + bool m_isCapturingImage = false; + bool m_applicationExiting = false; + bool m_doImageCapture = true; + + MetaDataDialog *m_metaDataDialog = nullptr; +}; + +#endif diff --git a/examples/multimedia/camera/camera.pro b/examples/multimedia/camera/camera.pro new file mode 100644 index 0000000..5382833 --- /dev/null +++ b/examples/multimedia/camera/camera.pro @@ -0,0 +1,43 @@ +TEMPLATE = app +TARGET = camera + +QT += multimedia multimediawidgets +CONFIG += add_ios_ffmpeg_libraries + +HEADERS = \ + camera.h \ + imagesettings.h \ + videosettings.h \ + metadatadialog.h + +SOURCES = \ + main.cpp \ + camera.cpp \ + imagesettings.cpp \ + videosettings.cpp \ + metadatadialog.cpp + +FORMS += \ + imagesettings.ui + +android|ios { + FORMS += \ + camera_mobile.ui \ + videosettings_mobile.ui +} else { + FORMS += \ + camera.ui \ + videosettings.ui +} +RESOURCES += camera.qrc + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/camera +INSTALLS += target + +QT += widgets + +macos: QMAKE_INFO_PLIST = Info.qmake.macos.plist +ios: QMAKE_INFO_PLIST = Info.qmake.ios.plist + +ANDROID_PACKAGE_SOURCE_DIR = $$PWD/android +OTHER_FILES += android/AndroidManifest.xml diff --git a/examples/multimedia/camera/camera.qrc b/examples/multimedia/camera/camera.qrc new file mode 100644 index 0000000..a915eb5 --- /dev/null +++ b/examples/multimedia/camera/camera.qrc @@ -0,0 +1,5 @@ + + + images/shutter.svg + + diff --git a/examples/multimedia/camera/camera.ui b/examples/multimedia/camera/camera.ui new file mode 100644 index 0000000..f6b9af9 --- /dev/null +++ b/examples/multimedia/camera/camera.ui @@ -0,0 +1,446 @@ + + + Camera + + + + 0 + 0 + 668 + 429 + + + + Camera + + + + + + + 0 + + + + Image + + + + + + Qt::Orientation::Vertical + + + + 20 + 161 + + + + + + + + false + + + Capture Photo + + + + :/images/shutter.svg:/images/shutter.svg + + + + + + + + Video + + + + + + Record + + + + + + + Pause + + + + + + + Stop + + + + + + + Qt::Orientation::Vertical + + + + 20 + 76 + + + + + + + + Mute + + + true + + + + + + + Set metadata + + + true + + + + + + + + + + + + 1 + 0 + + + + + + + + + 255 + 255 + 255 + + + + + + + 145 + 145 + 145 + + + + + + + + + 255 + 255 + 255 + + + + + + + 145 + 145 + 145 + + + + + + + + + 145 + 145 + 145 + + + + + + + 145 + 145 + 145 + + + + + + + + 0 + + + + + + + + + + + + + + + 0 + 0 + + + + QFrame::Shape::Box + + + + + + + + + + + + + + + + 0 + 0 + 668 + 26 + + + + + File + + + + + + + + + + + Devices + + + + + + + + + Close + + + + + Start Camera + + + + + Stop Camera + + + + + Change Settings + + + + + + QVideoWidget + QWidget +
qvideowidget.h
+ 1 + + + + + + + + recordButton + clicked() + Camera + record() + + + 647 + 149 + + + 61 + 238 + + + + + stopButton + clicked() + Camera + stop() + + + 647 + 225 + + + 140 + 236 + + + + + pauseButton + clicked() + Camera + pause() + + + 647 + 187 + + + 234 + 237 + + + + + actionExit + triggered() + Camera + close() + + + -1 + -1 + + + 154 + 130 + + + + + takeImageButton + clicked() + Camera + takeImage() + + + 625 + 132 + + + 603 + 169 + + + + + muteButton + toggled(bool) + Camera + setMuted(bool) + + + 647 + 377 + + + 5 + 280 + + + + + actionSettings + triggered() + Camera + configureCaptureSettings() + + + -1 + -1 + + + 333 + 210 + + + + + actionStartCamera + triggered() + Camera + startCamera() + + + -1 + -1 + + + 333 + 210 + + + + + actionStopCamera + triggered() + Camera + stopCamera() + + + -1 + -1 + + + 333 + 210 + + + + + + record() + pause() + stop() + enablePreview(bool) + configureCaptureSettings() + takeImage() + startCamera() + toggleLock() + setMuted(bool) + stopCamera() + setExposureCompensation(int) + + diff --git a/examples/multimedia/camera/camera_mobile.ui b/examples/multimedia/camera/camera_mobile.ui new file mode 100644 index 0000000..f36722f --- /dev/null +++ b/examples/multimedia/camera/camera_mobile.ui @@ -0,0 +1,504 @@ + + + Camera + + + + 0 + 0 + 668 + 429 + + + + Camera + + + + + + + + 0 + 0 + + + + 0 + + + + Image + + + + + + -4 + + + 4 + + + 2 + + + Qt::Orientation::Horizontal + + + QSlider::TickPosition::TicksAbove + + + + + + + + 0 + 0 + + + + Exposure Compensation: + + + + + + + false + + + Capture Photo + + + + :/images/shutter.svg:/images/shutter.svg + + + + + + + + Video + + + + + + + + + + Record + + + + + + + Pause + + + + + + + Stop + + + + + + + + + + + Qt::Orientation::Vertical + + + + 20 + 10 + + + + + + + + Mute + + + true + + + + + + + Set metadata + + + true + + + + + + + + + + + + + + + + 1 + 0 + + + + + + + + + 255 + 255 + 255 + + + + + + + 145 + 145 + 145 + + + + + + + + + 255 + 255 + 255 + + + + + + + 145 + 145 + 145 + + + + + + + + + 145 + 145 + 145 + + + + + + + 145 + 145 + 145 + + + + + + + + 0 + + + + + + + + 0 + 0 + + + + + + + + + + + + + 0 + 0 + + + + QFrame::Shape::Box + + + + + + + + + + + + + + + + 0 + 0 + 668 + 26 + + + + + File + + + + + + + + + + + Devices + + + + + + + + + Close + + + + + Start Camera + + + + + Stop Camera + + + + + Change Settings + + + + + + QVideoWidget + QWidget +
qvideowidget.h
+ 1 + + + + + + recordButton + clicked() + Camera + record() + + + 647 + 149 + + + 61 + 238 + + + + + stopButton + clicked() + Camera + stop() + + + 647 + 225 + + + 140 + 236 + + + + + pauseButton + clicked() + Camera + pause() + + + 647 + 187 + + + 234 + 237 + + + + + actionExit + triggered() + Camera + close() + + + -1 + -1 + + + 154 + 130 + + + + + takeImageButton + clicked() + Camera + takeImage() + + + 625 + 132 + + + 603 + 169 + + + + + muteButton + toggled(bool) + Camera + setMuted(bool) + + + 647 + 377 + + + 5 + 280 + + + + + exposureCompensation + valueChanged(int) + Camera + setExposureCompensation(int) + + + 559 + 367 + + + 665 + 365 + + + + + actionSettings + triggered() + Camera + configureCaptureSettings() + + + -1 + -1 + + + 333 + 210 + + + + + actionStartCamera + triggered() + Camera + startCamera() + + + -1 + -1 + + + 333 + 210 + + + + + actionStopCamera + triggered() + Camera + stopCamera() + + + -1 + -1 + + + 333 + 210 + + + + + + record() + pause() + stop() + enablePreview(bool) + configureCaptureSettings() + takeImage() + startCamera() + toggleLock() + setMuted(bool) + stopCamera() + setExposureCompensation(int) + + diff --git a/examples/multimedia/camera/doc/images/camera-example.png b/examples/multimedia/camera/doc/images/camera-example.png new file mode 100644 index 0000000000000000000000000000000000000000..f7d7e4f67d4d755246181be656eab3dc840e41a8 GIT binary patch literal 151290 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 z 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%0D^OihNVJ2$j#D7R)Z^C|I#pktc4mj4 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 + +It seeks permissions for input device access: + +\skipto #if QT_CONFIG(permissions) +\printuntil #endif + +Inputs are assigned: +\printuntil updateCameras() + + UI signals are connected to slots that react to the triggering event: +\printuntil setCamera(QMediaDevices::defaultVideoInput()); + +However, most of the work is done when the \e{setCamera()} function is called, +passing in a \l QCameraDevice. + +\section1 setCamera() + +\c{setCamera()} sets up various connections between the user interface and the +functionality of the Camera class using signals and slots. It also instantiates +and initializes the \l {QCamera}, \l {QImageCapture}, and \l {QMediaRecorder} +objects. + +\skipto void Camera::setCamera(const QCameraDevice &cameraDevice) +\printto m_captureSession.setVideoOutput(ui->viewfinder); + +The still and video recording visual tabs are enabled: + +\printuntil updateCaptureMode(); + +Finally the \l {QCamera::start}{start()} function of the \l{QCamera} +object is called. + +\printuntil m_camera->start(); + +\section1 Triggering capturing + +Now that the camera is ready for user commands it waits for a suitable event. +Such an event can be a key press of either the \l {Qt::Key_CameraFocus} or +\l {Qt::Key_Camera} buttons on the application window. + +Key_CameraFocus will simply display the preview and lock the camera settings. +\printto case Qt::Key_Camera: + +\c Key_Camera will either call \e{takeImage()} if doing an image capture, or call +\c record() or \c stop() (if already recording) on the QMediaRecorder instance +when recording video. + +\printuntil break; + +*/ diff --git a/examples/multimedia/camera/images/shutter.svg b/examples/multimedia/camera/images/shutter.svg new file mode 100644 index 0000000..1849336 --- /dev/null +++ b/examples/multimedia/camera/images/shutter.svg @@ -0,0 +1,21 @@ + + + + + + + + + + + + diff --git a/examples/multimedia/camera/imagesettings.cpp b/examples/multimedia/camera/imagesettings.cpp new file mode 100644 index 0000000..c2b022a --- /dev/null +++ b/examples/multimedia/camera/imagesettings.cpp @@ -0,0 +1,84 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "imagesettings.h" +#include "ui_imagesettings.h" + +#include +#include +#include + +#include + +#include + +using namespace Qt::StringLiterals; + +ImageSettings::ImageSettings(QImageCapture *imageCapture, QWidget *parent) + : QDialog(parent), ui(new Ui::ImageSettingsUi), imagecapture(imageCapture) +{ + ui->setupUi(this); + + // image codecs + ui->imageCodecBox->addItem(tr("Default image format"), QVariant(QString())); + const auto supportedImageFormats = QImageCapture::supportedFormats(); + for (const auto &f : supportedImageFormats) { + QString description = QImageCapture::fileFormatDescription(f); + ui->imageCodecBox->addItem(QImageCapture::fileFormatName(f) + ": " + description, + QVariant::fromValue(f)); + } + + ui->imageQualitySlider->setRange(0, int(QImageCapture::VeryHighQuality)); + + ui->imageResolutionBox->addItem(tr("Default Resolution")); + const QList supportedResolutions = + imagecapture->captureSession()->camera()->cameraDevice().photoResolutions(); + for (const QSize &resolution : supportedResolutions) { + ui->imageResolutionBox->addItem( + u"%1x%2"_s.arg(resolution.width()).arg(resolution.height()), + QVariant(resolution)); + } + + selectComboBoxItem(ui->imageCodecBox, QVariant::fromValue(imagecapture->fileFormat())); + selectComboBoxItem(ui->imageResolutionBox, QVariant(imagecapture->resolution())); + ui->imageQualitySlider->setValue(imagecapture->quality()); +} + +ImageSettings::~ImageSettings() +{ + delete ui; +} + +void ImageSettings::changeEvent(QEvent *e) +{ + QDialog::changeEvent(e); + switch (e->type()) { + case QEvent::LanguageChange: + ui->retranslateUi(this); + break; + default: + break; + } +} + +void ImageSettings::applyImageSettings() const +{ + imagecapture->setFileFormat(boxValue(ui->imageCodecBox).value()); + imagecapture->setQuality(QImageCapture::Quality(ui->imageQualitySlider->value())); + imagecapture->setResolution(boxValue(ui->imageResolutionBox).toSize()); +} + +QVariant ImageSettings::boxValue(const QComboBox *box) const +{ + const int idx = box->currentIndex(); + return idx != -1 ? box->itemData(idx) : QVariant{}; +} + +void ImageSettings::selectComboBoxItem(QComboBox *box, const QVariant &value) +{ + const int idx = box->findData(value); + if (idx != -1) + box->setCurrentIndex(idx); +} + +#include "moc_imagesettings.cpp" diff --git a/examples/multimedia/camera/imagesettings.h b/examples/multimedia/camera/imagesettings.h new file mode 100644 index 0000000..0e2ef8e --- /dev/null +++ b/examples/multimedia/camera/imagesettings.h @@ -0,0 +1,41 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef IMAGESETTINGS_H +#define IMAGESETTINGS_H + +#include + +QT_BEGIN_NAMESPACE +class QComboBox; +class QImageCapture; +namespace Ui { +class ImageSettingsUi; +} +QT_END_NAMESPACE + +class ImageSettings : public QDialog +{ + Q_OBJECT + +public: + explicit ImageSettings(QImageCapture *imageCapture, QWidget *parent = nullptr); + ~ImageSettings(); + + void applyImageSettings() const; + + QString format() const; + void setFormat(const QString &format); + +protected: + void changeEvent(QEvent *e) override; + +private: + QVariant boxValue(const QComboBox *box) const; + void selectComboBoxItem(QComboBox *box, const QVariant &value); + + Ui::ImageSettingsUi *ui; + QImageCapture *imagecapture; +}; + +#endif // IMAGESETTINGS_H diff --git a/examples/multimedia/camera/imagesettings.ui b/examples/multimedia/camera/imagesettings.ui new file mode 100644 index 0000000..6eb37ad --- /dev/null +++ b/examples/multimedia/camera/imagesettings.ui @@ -0,0 +1,123 @@ + + + ImageSettingsUi + + + + 0 + 0 + 332 + 270 + + + + Image Settings + + + + + + Image + + + + + + Resolution: + + + + + + + + + + Image Format: + + + + + + + + + + Quality: + + + + + + + 4 + + + Qt::Orientation::Horizontal + + + + + + + + + + Qt::Orientation::Vertical + + + + 20 + 14 + + + + + + + + Qt::Orientation::Horizontal + + + QDialogButtonBox::StandardButton::Cancel|QDialogButtonBox::StandardButton::Ok + + + + + + + + + buttonBox + accepted() + ImageSettingsUi + accept() + + + 322 + 272 + + + 44 + 230 + + + + + buttonBox + rejected() + ImageSettingsUi + reject() + + + 405 + 262 + + + 364 + 227 + + + + + diff --git a/examples/multimedia/camera/ios/Info.plist.in b/examples/multimedia/camera/ios/Info.plist.in new file mode 100644 index 0000000..6a6b8db --- /dev/null +++ b/examples/multimedia/camera/ios/Info.plist.in @@ -0,0 +1,50 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + LSRequiresIPhoneOS + + + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + + diff --git a/examples/multimedia/camera/macos/Info.plist.in b/examples/multimedia/camera/macos/Info.plist.in new file mode 100644 index 0000000..ae2d945 --- /dev/null +++ b/examples/multimedia/camera/macos/Info.plist.in @@ -0,0 +1,49 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSPrincipalClass + NSApplication + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/camera/main.cpp b/examples/multimedia/camera/main.cpp new file mode 100644 index 0000000..afe84a4 --- /dev/null +++ b/examples/multimedia/camera/main.cpp @@ -0,0 +1,20 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "camera.h" + +#include + +int main(int argc, char *argv[]) +{ +#ifdef Q_OS_ANDROID + // To be removed after QTBUG-132816 + QCoreApplication::setAttribute(Qt::AA_DontUseNativeMenuBar); +#endif + QApplication app(argc, argv); + + Camera camera; + camera.show(); + + return app.exec(); +}; diff --git a/examples/multimedia/camera/metadatadialog.cpp b/examples/multimedia/camera/metadatadialog.cpp new file mode 100644 index 0000000..8213baa --- /dev/null +++ b/examples/multimedia/camera/metadatadialog.cpp @@ -0,0 +1,107 @@ +// Copyright (C) 2020 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "metadatadialog.h" + +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include + +static QString defaultValue(QMediaMetaData::Key key) +{ + switch (key) { + case QMediaMetaData::Title: + return MetaDataDialog::tr("Qt Camera Example"); + case QMediaMetaData::Author: + return MetaDataDialog::tr("The Qt Company"); + case QMediaMetaData::Date: + return QDateTime::currentDateTime().toString(); + default: + break; + } + return {}; +} + +MetaDataDialog::MetaDataDialog(QWidget *parent) : QDialog(parent) +{ + auto *viewport = new QWidget; + auto *metaDataLayout = new QFormLayout(viewport); + + for (int i = 0; i < QMediaMetaData::NumMetaData; ++i) { + const auto key = static_cast(i); + QString label = QMediaMetaData::metaDataKeyToString(key); + auto *lineEdit = new QLineEdit(defaultValue(key)); + lineEdit->setClearButtonEnabled(true); + m_metaDataFields[key] = lineEdit; + + switch (key) { + case QMediaMetaData::ThumbnailImage: { + QPushButton *openThumbnail = new QPushButton(tr("Open")); + connect(openThumbnail, &QPushButton::clicked, this, + &MetaDataDialog::openThumbnailImage); + QHBoxLayout *layout = new QHBoxLayout; + layout->addWidget(lineEdit); + layout->addWidget(openThumbnail); + metaDataLayout->addRow(label, layout); + } + break; + case QMediaMetaData::CoverArtImage: { + QPushButton *openCoverArt = new QPushButton(tr("Open")); + connect(openCoverArt, &QPushButton::clicked, this, &MetaDataDialog::openCoverArtImage); + QHBoxLayout *layout = new QHBoxLayout; + layout->addWidget(lineEdit); + layout->addWidget(openCoverArt); + metaDataLayout->addRow(label, layout); + } + break; + case QMediaMetaData::HasHdrContent: + break; // Read-only + default: + metaDataLayout->addRow(label, lineEdit); + break; + } + } + + QScrollArea *scrollArea = new QScrollArea; + scrollArea->setWidget(viewport); + auto *dialogLayout = new QVBoxLayout(this); + dialogLayout->addWidget(scrollArea); + + auto buttonBox = new QDialogButtonBox(QDialogButtonBox::Ok | QDialogButtonBox::Cancel); + dialogLayout->addWidget(buttonBox); + + setWindowTitle(tr("Set Metadata")); + resize(400, 300); + + connect(buttonBox, &QDialogButtonBox::accepted, this, &MetaDataDialog::accept); + connect(buttonBox, &QDialogButtonBox::rejected, this, &MetaDataDialog::reject); +} + +void MetaDataDialog::openThumbnailImage() +{ + QString fileName = QFileDialog::getOpenFileName(this, tr("Open Image"), QDir::currentPath(), + tr("Image Files (*.png *.jpg *.bmp)")); + if (!fileName.isEmpty()) + m_metaDataFields[QMediaMetaData::ThumbnailImage]->setText(fileName); +} + +void MetaDataDialog::openCoverArtImage() +{ + QString fileName = QFileDialog::getOpenFileName(this, tr("Open Image"), QDir::currentPath(), + tr("Image Files (*.png *.jpg *.bmp)")); + if (!fileName.isEmpty()) + m_metaDataFields[QMediaMetaData::CoverArtImage]->setText(fileName); +} + +#include "moc_metadatadialog.cpp" diff --git a/examples/multimedia/camera/metadatadialog.h b/examples/multimedia/camera/metadatadialog.h new file mode 100644 index 0000000..5bb5a4b --- /dev/null +++ b/examples/multimedia/camera/metadatadialog.h @@ -0,0 +1,31 @@ +// Copyright (C) 2020 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef DIALOG_H +#define DIALOG_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QLabel; +class QLineEdit; +QT_END_NAMESPACE + +//! [0] +class MetaDataDialog : public QDialog +{ + Q_OBJECT + +public: + explicit MetaDataDialog(QWidget *parent = nullptr); + + QLineEdit *m_metaDataFields[QMediaMetaData::NumMetaData] = {}; + +private slots: + void openThumbnailImage(); + void openCoverArtImage(); +}; +//! [0] + +#endif diff --git a/examples/multimedia/camera/videosettings.cpp b/examples/multimedia/camera/videosettings.cpp new file mode 100644 index 0000000..5ff93e1 --- /dev/null +++ b/examples/multimedia/camera/videosettings.cpp @@ -0,0 +1,202 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videosettings.h" +#if defined(Q_OS_ANDROID) || defined(Q_OS_IOS) +# include "ui_videosettings_mobile.h" +#else +# include "ui_videosettings.h" +#endif + +#include +#include +#include +#include +#include +#include +#include + +#include +#include + +#include +#include + +static QString toFormattedString(const QCameraFormat &cameraFormat) +{ + QString string; + QTextStream str(&string); + str << QVideoFrameFormat::pixelFormatToString(cameraFormat.pixelFormat()) + << ' ' << cameraFormat.resolution().width() + << 'x' << cameraFormat.resolution().height() + << ' ' << cameraFormat.minFrameRate() + << '-' << cameraFormat.maxFrameRate() << "FPS"; + return string; +} + +VideoSettings::VideoSettings(QMediaRecorder *mediaRecorder, QWidget *parent) + : QDialog(parent), ui(new Ui::VideoSettingsUi), mediaRecorder(mediaRecorder) +{ + ui->setupUi(this); + + // sample rate: + auto audioDevice = mediaRecorder->captureSession()->audioInput()->device(); + ui->audioSampleRateBox->setRange(audioDevice.minimumSampleRate(), + audioDevice.maximumSampleRate()); + + // camera format + ui->videoFormatBox->addItem(tr("Default camera format")); + + auto *camera = mediaRecorder->captureSession()->camera(); + const QList videoFormats = camera->cameraDevice().videoFormats(); + + for (const QCameraFormat &format : videoFormats) + ui->videoFormatBox->addItem(toFormattedString(format), QVariant::fromValue(format)); + + connect(ui->videoFormatBox, &QComboBox::currentIndexChanged, this, [this](int /*index*/) { + this->setFpsRange(boxValue(ui->videoFormatBox).value()); + }); + + setFpsRange(camera->cameraFormat()); + + connect(ui->fpsSlider, &QSlider::valueChanged, ui->fpsSpinBox, &QSpinBox::setValue); + connect(ui->fpsSpinBox, &QSpinBox::valueChanged, ui->fpsSlider, &QSlider::setValue); + + updateFormatsAndCodecs(); + connect(ui->audioCodecBox, &QComboBox::currentIndexChanged, this, + &VideoSettings::updateFormatsAndCodecs); + connect(ui->videoCodecBox, &QComboBox::currentIndexChanged, this, + &VideoSettings::updateFormatsAndCodecs); + connect(ui->containerFormatBox, &QComboBox::currentIndexChanged, this, + &VideoSettings::updateFormatsAndCodecs); + + ui->qualitySlider->setRange(0, int(QMediaRecorder::VeryHighQuality)); + + QMediaFormat format = mediaRecorder->mediaFormat(); + selectComboBoxItem(ui->containerFormatBox, QVariant::fromValue(format.fileFormat())); + selectComboBoxItem(ui->audioCodecBox, QVariant::fromValue(format.audioCodec())); + selectComboBoxItem(ui->videoCodecBox, QVariant::fromValue(format.videoCodec())); + + ui->qualitySlider->setValue(mediaRecorder->quality()); + ui->audioSampleRateBox->setValue(mediaRecorder->audioSampleRate()); + selectComboBoxItem(ui->videoFormatBox, + QVariant::fromValue(camera->cameraFormat())); + + ui->fpsSlider->setValue(mediaRecorder->videoFrameRate()); + ui->fpsSpinBox->setValue(mediaRecorder->videoFrameRate()); +} + +VideoSettings::~VideoSettings() +{ + delete ui; +} + +void VideoSettings::changeEvent(QEvent *e) +{ + QDialog::changeEvent(e); + switch (e->type()) { + case QEvent::LanguageChange: + ui->retranslateUi(this); + break; + default: + break; + } +} + +void VideoSettings::setFpsRange(const QCameraFormat &format) +{ + ui->fpsSlider->setRange(format.minFrameRate(), format.maxFrameRate()); + ui->fpsSpinBox->setRange(format.minFrameRate(), format.maxFrameRate()); +} + +void VideoSettings::applySettings() +{ + QMediaFormat format; + format.setFileFormat(boxValue(ui->containerFormatBox).value()); + format.setAudioCodec(boxValue(ui->audioCodecBox).value()); + format.setVideoCodec(boxValue(ui->videoCodecBox).value()); + + mediaRecorder->setMediaFormat(format); + mediaRecorder->setQuality(QMediaRecorder::Quality(ui->qualitySlider->value())); + mediaRecorder->setAudioSampleRate(ui->audioSampleRateBox->value()); + + const auto &cameraFormat = boxValue(ui->videoFormatBox).value(); + mediaRecorder->setVideoResolution(cameraFormat.resolution()); + mediaRecorder->setVideoFrameRate(ui->fpsSlider->value()); + + mediaRecorder->captureSession()->camera()->setCameraFormat(cameraFormat); +} + +void VideoSettings::updateFormatsAndCodecs() +{ + if (m_updatingFormats) + return; + m_updatingFormats = true; + + QMediaFormat format; + if (ui->containerFormatBox->count()) + format.setFileFormat(boxValue(ui->containerFormatBox).value()); + if (ui->audioCodecBox->count()) + format.setAudioCodec(boxValue(ui->audioCodecBox).value()); + if (ui->videoCodecBox->count()) + format.setVideoCodec(boxValue(ui->videoCodecBox).value()); + + int currentIndex = 0; + ui->audioCodecBox->clear(); + ui->audioCodecBox->addItem(tr("Default audio codec"), + QVariant::fromValue(QMediaFormat::AudioCodec::Unspecified)); + + const QList supportedAudioCodecs = format.supportedAudioCodecs(QMediaFormat::Encode); + for (auto codec : std::as_const(supportedAudioCodecs)) { + if (codec == format.audioCodec()) + currentIndex = ui->audioCodecBox->count(); + ui->audioCodecBox->addItem(QMediaFormat::audioCodecDescription(codec), + QVariant::fromValue(codec)); + } + ui->audioCodecBox->setCurrentIndex(currentIndex); + + currentIndex = 0; + ui->videoCodecBox->clear(); + ui->videoCodecBox->addItem(tr("Default video codec"), + QVariant::fromValue(QMediaFormat::VideoCodec::Unspecified)); + + const QList supportedVideoCodecs = format.supportedVideoCodecs(QMediaFormat::Encode); + for (auto codec : std::as_const(supportedVideoCodecs)) { + if (codec == format.videoCodec()) + currentIndex = ui->videoCodecBox->count(); + ui->videoCodecBox->addItem(QMediaFormat::videoCodecDescription(codec), + QVariant::fromValue(codec)); + } + ui->videoCodecBox->setCurrentIndex(currentIndex); + + currentIndex = 0; + ui->containerFormatBox->clear(); + ui->containerFormatBox->addItem(tr("Default file format"), + QVariant::fromValue(QMediaFormat::UnspecifiedFormat)); + + const QList supportedFileFormats = format.supportedFileFormats(QMediaFormat::Encode); + for (auto container : std::as_const(supportedFileFormats)) { + if (container == format.fileFormat()) + currentIndex = ui->containerFormatBox->count(); + ui->containerFormatBox->addItem(QMediaFormat::fileFormatDescription(container), + QVariant::fromValue(container)); + } + ui->containerFormatBox->setCurrentIndex(currentIndex); + + m_updatingFormats = false; +} + +QVariant VideoSettings::boxValue(const QComboBox *box) const +{ + const int idx = box->currentIndex(); + return idx != -1 ? box->itemData(idx) : QVariant{}; +} + +void VideoSettings::selectComboBoxItem(QComboBox *box, const QVariant &value) +{ + const int idx = box->findData(value); + if (idx != -1) + box->setCurrentIndex(idx); +} + +#include "moc_videosettings.cpp" diff --git a/examples/multimedia/camera/videosettings.h b/examples/multimedia/camera/videosettings.h new file mode 100644 index 0000000..358b1fb --- /dev/null +++ b/examples/multimedia/camera/videosettings.h @@ -0,0 +1,42 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef VIDEOSETTINGS_H +#define VIDEOSETTINGS_H + +#include + +QT_BEGIN_NAMESPACE +class QCameraFormat; +class QComboBox; +class QMediaRecorder; +namespace Ui { +class VideoSettingsUi; +} +QT_END_NAMESPACE + +class VideoSettings : public QDialog +{ + Q_OBJECT + +public: + explicit VideoSettings(QMediaRecorder *mediaRecorder, QWidget *parent = nullptr); + ~VideoSettings(); + + void applySettings(); + void updateFormatsAndCodecs(); + +protected: + void changeEvent(QEvent *e) override; + +private: + void setFpsRange(const QCameraFormat &format); + QVariant boxValue(const QComboBox *) const; + void selectComboBoxItem(QComboBox *box, const QVariant &value); + + Ui::VideoSettingsUi *ui; + QMediaRecorder *mediaRecorder; + bool m_updatingFormats = false; +}; + +#endif // VIDEOSETTINGS_H diff --git a/examples/multimedia/camera/videosettings.ui b/examples/multimedia/camera/videosettings.ui new file mode 100644 index 0000000..ec35e95 --- /dev/null +++ b/examples/multimedia/camera/videosettings.ui @@ -0,0 +1,213 @@ + + + VideoSettingsUi + + + + 0 + 0 + 686 + 499 + + + + Video Settings + + + + + + Qt::Orientation::Horizontal + + + QDialogButtonBox::StandardButton::Cancel|QDialogButtonBox::StandardButton::Ok + + + + + + + Video + + + + + + Camera Format + + + + + + + + + + Framerate: + + + + + + + Video Codec: + + + + + + + + + + + + + + + Qt::Orientation::Horizontal + + + + + + + + + + + + + 0 + 0 + + + + + 0 + + + 0 + + + 0 + + + 0 + + + + + Audio + + + + + + Audio Codec: + + + + + + + + + + Sample Rate: + + + + + + + + + + + + + + + + Quality: + + + + + + + 4 + + + Qt::Orientation::Horizontal + + + + + + + File Format: + + + + + + + + + + + + + + + + Qt::Orientation::Vertical + + + + 20 + 40 + + + + + + + + + + buttonBox + accepted() + VideoSettingsUi + accept() + + + 322 + 272 + + + 44 + 230 + + + + + buttonBox + rejected() + VideoSettingsUi + reject() + + + 405 + 262 + + + 364 + 227 + + + + + diff --git a/examples/multimedia/camera/videosettings_mobile.ui b/examples/multimedia/camera/videosettings_mobile.ui new file mode 100644 index 0000000..a3dbf61 --- /dev/null +++ b/examples/multimedia/camera/videosettings_mobile.ui @@ -0,0 +1,207 @@ + + + VideoSettingsUi + + + + 0 + 0 + 329 + 591 + + + + Video Settings + + + + + + + 0 + 0 + + + + + 0 + + + 0 + + + 0 + + + 0 + + + + + Audio + + + + + + Audio Codec: + + + + + + + + + + Sample Rate: + + + + + + + + + + + + + + + + Quality: + + + + + + + 4 + + + Qt::Orientation::Horizontal + + + + + + + File Format: + + + + + + + + + + + + + + + + Video + + + + + + Frames per second: + + + + + + + + + + Camera Format: + + + + + + + Video Codec: + + + + + + + + + + Qt::Orientation::Horizontal + + + QDialogButtonBox::StandardButton::Cancel|QDialogButtonBox::StandardButton::Ok + + + + + + + + + 8 + + + 30 + + + + + + + Qt::Orientation::Horizontal + + + + + + + + + + + + + + buttonBox + accepted() + VideoSettingsUi + accept() + + + 322 + 272 + + + 44 + 230 + + + + + buttonBox + rejected() + VideoSettingsUi + reject() + + + 405 + 262 + + + 364 + 227 + + + + + diff --git a/examples/multimedia/declarative-camera/CMakeLists.txt b/examples/multimedia/declarative-camera/CMakeLists.txt new file mode 100644 index 0000000..024b698 --- /dev/null +++ b/examples/multimedia/declarative-camera/CMakeLists.txt @@ -0,0 +1,69 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(declarative-camera LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/declarative-camera") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Qml Quick) + +qt_add_executable(declarative-camera + qmlcamera.cpp +) + +set_target_properties(declarative-camera PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in +) + +qt_add_ios_ffmpeg_libraries(declarative-camera) + +target_link_libraries(declarative-camera PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Qml + Qt::Quick +) + +# Resources: +set(declarative-camera_resource_files + "CameraButton.qml" + "CameraListButton.qml" + "CameraWhiteBalanceButton.qml" + "FlashControl.qml" + "PhotoCaptureControls.qml" + "PhotoPreview.qml" + "VideoCaptureControls.qml" + "VideoPreview.qml" + "ZoomControl.qml" + "declarative-camera.qml" + "images/camera_camera_setting.png" + "images/camera_flash_auto.png" + "images/camera_flash_fill.png" + "images/camera_flash_off.png" + "images/camera_flash_redeye.png" + "images/toolbutton.png" + "images/toolbutton.sci" +) + +qt_add_resources(declarative-camera "declarative-camera" + PREFIX + "/" + FILES + ${declarative-camera_resource_files} +) + +install(TARGETS declarative-camera + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/declarative-camera/CameraButton.qml b/examples/multimedia/declarative-camera/CameraButton.qml new file mode 100644 index 0000000..43837bc --- /dev/null +++ b/examples/multimedia/declarative-camera/CameraButton.qml @@ -0,0 +1,41 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + id: button + + signal clicked + + property string text + property color color: "white" + + width : 144 + height: 70 + + BorderImage { + id: buttonImage + source: "images/toolbutton.sci" + width: button.width; height: button.height + } + MouseArea { + id: mouseRegion + anchors.fill: buttonImage + onClicked: { button.clicked(); } + } + Text { + id: btnText + anchors.fill: buttonImage + anchors.margins: 5 + text: button.text + horizontalAlignment: Text.AlignHCenter + verticalAlignment: Text.AlignVCenter + elide: Text.ElideRight + color: button.color + font.bold: true + style: Text.Raised + styleColor: "black" + font.pixelSize: 14 + } +} diff --git a/examples/multimedia/declarative-camera/CameraListButton.qml b/examples/multimedia/declarative-camera/CameraListButton.qml new file mode 100644 index 0000000..613ecf5 --- /dev/null +++ b/examples/multimedia/declarative-camera/CameraListButton.qml @@ -0,0 +1,32 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick.Controls.Material + +import QtMultimedia +import QtQuick +import QtQuick.Controls + +ComboBox { + required property Camera camera + + Material.theme: Material.Dark + + MediaDevices { + id: mediaDevices + } + + model: mediaDevices.videoInputs + .map((device) => { return { + value: device, + displayText: device.description } }) + valueRole: "value" + textRole: "displayText" + visible: model.length > 1 + font.pixelSize: 14 + font.bold: true + onActivated: { + camera.cameraDevice = currentValue + } + currentIndex: model.findIndex(item => item.value === camera.cameraDevice) +} diff --git a/examples/multimedia/declarative-camera/CameraWhiteBalanceButton.qml b/examples/multimedia/declarative-camera/CameraWhiteBalanceButton.qml new file mode 100644 index 0000000..d106e08 --- /dev/null +++ b/examples/multimedia/declarative-camera/CameraWhiteBalanceButton.qml @@ -0,0 +1,64 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick.Controls.Material + +import QtMultimedia +import QtQuick +import QtQuick.Controls + +ComboBox { + id: root + + Material.theme: Material.Dark + + required property Camera camera + + // This list is not exhaustive. Contains only the modes + // supported in this example. + readonly property var allWhiteBalanceModes: [ + Camera.WhiteBalanceAuto, + Camera.WhiteBalanceCloudy, + Camera.WhiteBalanceFluorescent, + Camera.WhiteBalanceSunlight, + Camera.WhiteBalanceTungsten, ] + property var supportedWhiteBalanceModes: + allWhiteBalanceModes.filter(item => camera.isWhiteBalanceModeSupported(item)) + + // Because .isWhiteBalanceModeSupported is not a reactive binding, + // we need to explicitly update the list of supported white-balance modes + // whenever the camera-device changes. + Connections { + target: root.camera + function onCameraDeviceChanged() { + root.supportedWhiteBalanceModes = root.allWhiteBalanceModes + .filter(item => root.camera.isWhiteBalanceModeSupported(item)) + } + } + + // Helper function to turn a Camera.WhiteBalanceMode to a string. + function cameraWhiteBalanceModeToString(input) { + switch (input) { + case Camera.WhiteBalanceAuto: return "Auto" + case Camera.WhiteBalanceCloudy: return "Cloudy" + case Camera.WhiteBalanceFluorescent: return "Fluorescent" + case Camera.WhiteBalanceSunlight: return "Sunlight" + case Camera.WhiteBalanceTungsten: return "Tungsten" + default: return "Unknown" + } + } + + model: supportedWhiteBalanceModes + .map((mode) => { return { + value: mode, + displayText: cameraWhiteBalanceModeToString(mode) } }) + valueRole: "value" + textRole: "displayText" + font.pixelSize: 14 + font.bold: true + + onActivated: index => { + camera.whiteBalanceMode = currentValue + } + currentIndex: model.findIndex(item => item.value === camera.whiteBalanceMode) +} diff --git a/examples/multimedia/declarative-camera/FlashControl.qml b/examples/multimedia/declarative-camera/FlashControl.qml new file mode 100644 index 0000000..1018b52 --- /dev/null +++ b/examples/multimedia/declarative-camera/FlashControl.qml @@ -0,0 +1,68 @@ +// Copyright (C) 2023 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Item { + id: topItem + + height: column.height + + //! [0] + required property Camera camera + + property bool mIsFlashSupported: camera.isFlashModeSupported(Camera.FlashOn) + property bool mIsTorchSupported: camera.isTorchModeSupported(Camera.TorchOn) + //! [0] + + // Because the function 'camera.isFlashModeSupported()' is not a reactive binding + // we must explicitly check if the flash mode is still supported when we change + // the camera-device. + Connections { + target: topItem.camera + function onCameraDeviceChanged() { + topItem.mIsFlashSupported = topItem.camera.isFlashModeSupported(Camera.FlashOn) + topItem.mIsTorchSupported = topItem.camera.isTorchModeSupported(Camera.TorchOn) + } + } + + Column { + id: column + + //! [1] + Switch { + id: flashModeControl + visible: topItem.mIsFlashSupported + checked: topItem.camera.flashMode === Camera.FlashOn + opacity: checked ? 0.75 : 0.25 + text: "Flash" + + contentItem: Text { + text: flashModeControl.text + color: "white" + leftPadding: flashModeControl.indicator.width + flashModeControl.spacing + } + + onClicked: topItem.camera.flashMode = checked ? Camera.FlashOn : Camera.FlashOff + } + //! [1] + + Switch { + id: torchModeControl + visible: topItem.mIsTorchSupported + checked: topItem.camera.torchMode === Camera.FlashOn + opacity: checked ? 0.75 : 0.25 + text: "Torch" + + contentItem: Text { + text: torchModeControl.text + color: "white" + leftPadding: torchModeControl.indicator.width + torchModeControl.spacing + } + + onClicked: topItem.camera.torchMode = checked ? Camera.TorchOn : Camera.TorchOff + } + } +} diff --git a/examples/multimedia/declarative-camera/Info.plist.in b/examples/multimedia/declarative-camera/Info.plist.in new file mode 100644 index 0000000..46a9ecf --- /dev/null +++ b/examples/multimedia/declarative-camera/Info.plist.in @@ -0,0 +1,46 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/declarative-camera/Info.qmake.ios.plist b/examples/multimedia/declarative-camera/Info.qmake.ios.plist new file mode 100644 index 0000000..b5252bb --- /dev/null +++ b/examples/multimedia/declarative-camera/Info.qmake.ios.plist @@ -0,0 +1,41 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/declarative-camera/Info.qmake.macos.plist b/examples/multimedia/declarative-camera/Info.qmake.macos.plist new file mode 100644 index 0000000..252d4c6 --- /dev/null +++ b/examples/multimedia/declarative-camera/Info.qmake.macos.plist @@ -0,0 +1,32 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + ${EXECUTABLE_NAME} + CFBundleName + ${EXECUTABLE_NAME} + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + NSPrincipalClass + NSApplication + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + diff --git a/examples/multimedia/declarative-camera/PhotoCaptureControls.qml b/examples/multimedia/declarative-camera/PhotoCaptureControls.qml new file mode 100644 index 0000000..b9ac06d --- /dev/null +++ b/examples/multimedia/declarative-camera/PhotoCaptureControls.qml @@ -0,0 +1,226 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtMultimedia +import QtQuick +import QtQuick.Layouts + +FocusScope { + id : captureControls + required property CaptureSession captureSession + readonly property Camera camera: captureSession.camera + required property bool previewAvailable + + property int buttonsmargin: 8 + required property int buttonsPanelWidth + required property int buttonsPanelPortraitHeight + required property int buttonsWidth + + signal previewSelected + signal videoModeSelected + + Rectangle { + id: buttonPaneShadow + color: Qt.rgba(0.08, 0.08, 0.08, 1) + + GridLayout { + id: buttonsColumn + anchors.margins: captureControls.buttonsmargin + flow: captureControls.state === "MobilePortrait" + ? GridLayout.LeftToRight : GridLayout.TopToBottom + //! [0] + CameraButton { + text: "Capture" + implicitWidth: captureControls.buttonsWidth + visible: captureControls.captureSession.imageCapture.readyForCapture + onClicked: captureControls.captureSession.imageCapture.captureToFile("") + } + //! [0] + + Item { + implicitWidth: captureControls.buttonsWidth + implicitHeight: 70 + CameraButton { + text: "View" + anchors.fill: parent + onClicked: captureControls.previewSelected() + visible: captureControls.previewAvailable + } + } + + Text { + text: "White balance" + font.pixelSize: 14 + font.bold: true + color: "white" + visible: whiteBalanceComboBox.model.length > 1 + } + + CameraWhiteBalanceButton { + id: whiteBalanceComboBox + + Layout.preferredWidth: captureControls.buttonsWidth + camera: captureControls.camera + + visible: model.length > 1 + } + } + + GridLayout { + id: bottomColumn + anchors.margins: captureControls.buttonsmargin + flow: captureControls.state === "MobilePortrait" + ? GridLayout.LeftToRight : GridLayout.TopToBottom + + Text { + text: "Device" + font.pixelSize: 14 + font.bold: true + color: "white" + visible: cameraDeviceComboBox.model.length > 1 + } + CameraListButton { + id: cameraDeviceComboBox + + Layout.preferredWidth: captureControls.buttonsWidth + camera: captureControls.camera + + visible: model.length > 1 + } + + CameraButton { + text: "Switch to Video" + implicitWidth: captureControls.buttonsWidth + onClicked: captureControls.videoModeSelected() + } + + CameraButton { + id: quitButton + implicitWidth: captureControls.buttonsWidth + text: "Quit" + onClicked: Qt.quit() + } + } + } + + ZoomControl { + id: zoomControl + x : 0 + y : 0 + width : 100 + height: parent.height - (flashControl.visible * flashControl.height) - + (captureControls.state === "MobilePortrait" ? buttonPaneShadow.height : 0) + + currentZoom: captureControls.camera.zoomFactor + maximumZoom: captureControls.camera.maximumZoomFactor + minimumZoom: captureControls.camera.minimumZoomFactor + onZoomTo: (target) => captureControls.camera.zoomFactor = target + } + + FlashControl { + id: flashControl + x : 10 + y : captureControls.state === "MobilePortrait" ? + parent.height - (buttonPaneShadow.height + height) : parent.height - height + + camera: captureControls.camera + } + + states: [ + State { + name: "MobilePortrait" + PropertyChanges { + buttonPaneShadow.width: parent.width + buttonPaneShadow.height: captureControls.buttonsPanelPortraitHeight + buttonsColumn.height: captureControls.buttonsPanelPortraitHeight / 2 - buttonsmargin + bottomColumn.height: captureControls.buttonsPanelPortraitHeight / 2 - buttonsmargin + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.bottom: captureControls.bottom + anchors.left: captureControls.left + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.left: buttonPaneShadow.left + anchors.right: buttonPaneShadow.right + anchors.top: buttonPaneShadow.top + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.bottom: buttonPaneShadow.bottom + anchors.left: buttonPaneShadow.left + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + }, + State { + name: "MobileLandscape" + PropertyChanges { + buttonPaneShadow.width: buttonsPanelWidth + buttonPaneShadow.height: parent.height + buttonsColumn.height: parent.height + buttonsColumn.width: buttonPaneShadow.width / 2 + bottomColumn.height: parent.height + bottomColumn.width: buttonPaneShadow.width / 2 + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.top: captureControls.top + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.bottom: buttonPaneShadow.bottom + anchors.left: buttonPaneShadow.left + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.bottom: buttonPaneShadow.bottom + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + }, + State { + name: "Other" + PropertyChanges { + buttonPaneShadow.width: bottomColumn.width + 16 + buttonPaneShadow.height: parent.height + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.top: captureControls.top + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.bottom: buttonPaneShadow.bottom + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + } + ] +} diff --git a/examples/multimedia/declarative-camera/PhotoPreview.qml b/examples/multimedia/declarative-camera/PhotoPreview.qml new file mode 100644 index 0000000..98af8a1 --- /dev/null +++ b/examples/multimedia/declarative-camera/PhotoPreview.qml @@ -0,0 +1,24 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + property alias source : preview.source + signal closed + + Image { + id: preview + anchors.fill : parent + fillMode: Image.PreserveAspectFit + smooth: true + } + + MouseArea { + anchors.fill: parent + onClicked: { + parent.closed(); + } + } +} + diff --git a/examples/multimedia/declarative-camera/VideoCaptureControls.qml b/examples/multimedia/declarative-camera/VideoCaptureControls.qml new file mode 100644 index 0000000..237e953 --- /dev/null +++ b/examples/multimedia/declarative-camera/VideoCaptureControls.qml @@ -0,0 +1,243 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtMultimedia +import QtQuick +import QtQuick.Layouts + +FocusScope { + id : captureControls + required property CaptureSession captureSession + readonly property Camera camera: captureSession.camera + property bool previewAvailable : false + + property int buttonsmargin: 8 + required property int buttonsPanelWidth + required property int buttonsPanelPortraitHeight + required property int buttonsWidth + + signal previewSelected + signal photoModeSelected + + Rectangle { + id: buttonPaneShadow + color: Qt.rgba(0.08, 0.08, 0.08, 1) + + GridLayout { + id: buttonsColumn + anchors.margins: captureControls.buttonsmargin + flow: captureControls.state === "MobilePortrait" + ? GridLayout.LeftToRight : GridLayout.TopToBottom + Item { + implicitWidth: captureControls.buttonsWidth + implicitHeight: 70 + CameraButton { + text: "Record" + anchors.fill: parent + visible: captureControls.captureSession.recorder.recorderState !== MediaRecorder.RecordingState + onClicked: captureControls.captureSession.recorder.record() + } + } + + Item { + implicitWidth: captureControls.buttonsWidth + implicitHeight: 70 + CameraButton { + id: stopButton + text: "Stop" + anchors.fill: parent + visible: captureControls.captureSession.recorder.recorderState === MediaRecorder.RecordingState + onClicked: captureControls.captureSession.recorder.stop() + } + } + + Item { + implicitWidth: captureControls.buttonsWidth + implicitHeight: 70 + CameraButton { + text: "View" + anchors.fill: parent + onClicked: captureControls.previewSelected() + //don't show View button during recording + visible: captureControls.captureSession.recorder.actualLocation.toString() !== "" + && !stopButton.visible + } + } + + Text { + text: "White balance" + font.pixelSize: 14 + font.bold: true + color: "white" + visible: whiteBalanceComboBox.model.length > 1 + } + + CameraWhiteBalanceButton { + id: whiteBalanceComboBox + + Layout.preferredWidth: captureControls.buttonsWidth + camera: captureControls.camera + + visible: model.length > 1 + } + } + + GridLayout { + id: bottomColumn + anchors.margins: captureControls.buttonsmargin + flow: captureControls.state === "MobilePortrait" + ? GridLayout.LeftToRight : GridLayout.TopToBottom + + Text { + text: "Device" + font.pixelSize: 14 + font.bold: true + color: "white" + visible: cameraDeviceComboBox.model.length > 1 + } + CameraListButton { + id: cameraDeviceComboBox + + Layout.preferredWidth: captureControls.buttonsWidth + camera: captureControls.camera + + visible: model.length > 1 + } + + CameraButton { + text: "Switch to Photo" + implicitWidth: captureControls.buttonsWidth + onClicked: captureControls.photoModeSelected() + } + + CameraButton { + id: quitButton + text: "Quit" + implicitWidth: captureControls.buttonsWidth + onClicked: Qt.quit() + } + } + } + + //! [0] + ZoomControl { + x : 0 + y : 0 + width : 100 + height: parent.height - (flashControl.visible * flashControl.height) - + (captureControls.state === "MobilePortrait" ? buttonPaneShadow.height : 0) + + currentZoom: captureControls.camera.zoomFactor + maximumZoom: captureControls.camera.maximumZoomFactor + minimumZoom: captureControls.camera.minimumZoomFactor + onZoomTo: (target) => captureControls.camera.zoomFactor = target + } + //! [0] + + FlashControl { + id: flashControl + x : 10 + y : captureControls.state === "MobilePortrait" ? + parent.height - (buttonPaneShadow.height + height) : parent.height - height + + camera: captureControls.camera + } + + states: [ + State { + name: "MobilePortrait" + PropertyChanges { + buttonPaneShadow.width: parent.width + buttonPaneShadow.height: buttonsPanelPortraitHeight + buttonsColumn.height: captureControls.buttonsPanelPortraitHeight / 2 - buttonsmargin + bottomColumn.height: captureControls.buttonsPanelPortraitHeight / 2 - buttonsmargin + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.bottom: captureControls.bottom + anchors.left: captureControls.left + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.left: buttonPaneShadow.left + anchors.right: buttonPaneShadow.right + anchors.top: buttonPaneShadow.top + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.bottom: buttonPaneShadow.bottom + anchors.left: buttonPaneShadow.left + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + }, + State { + name: "MobileLandscape" + PropertyChanges { + buttonPaneShadow.width: buttonsPanelWidth + buttonPaneShadow.height: parent.height + buttonsColumn.height: parent.height + buttonsColumn.width: buttonPaneShadow.width / 2 + bottomColumn.height: parent.height + bottomColumn.width: buttonPaneShadow.width / 2 + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.top: captureControls.top + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.bottom: buttonPaneShadow.bottom + anchors.left: buttonPaneShadow.left + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.bottom: buttonPaneShadow.bottom + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + }, + State { + name: "Other" + PropertyChanges { + buttonPaneShadow.width: bottomColumn.width + 16 + buttonPaneShadow.height: parent.height + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.top: captureControls.top + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.bottom: buttonPaneShadow.bottom + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + } + ] +} diff --git a/examples/multimedia/declarative-camera/VideoPreview.qml b/examples/multimedia/declarative-camera/VideoPreview.qml new file mode 100644 index 0000000..f7b3067 --- /dev/null +++ b/examples/multimedia/declarative-camera/VideoPreview.qml @@ -0,0 +1,42 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +Item { + id: videoPreview + property alias source : player.source + signal closed + + MediaPlayer { + id: player + + //switch back to viewfinder after playback finished + onMediaStatusChanged: { + if (mediaStatus == MediaPlayer.EndOfMedia) + videoPreview.closed(); + } + onSourceChanged: { + if (videoPreview.visible && source !== "") + play(); + } + + videoOutput: output + audioOutput: AudioOutput { + } + } + + VideoOutput { + id: output + anchors.fill : parent + } + + MouseArea { + anchors.fill: parent + onClicked: { + videoPreview.closed(); + } + } +} + diff --git a/examples/multimedia/declarative-camera/ZoomControl.qml b/examples/multimedia/declarative-camera/ZoomControl.qml new file mode 100644 index 0000000..379afaf --- /dev/null +++ b/examples/multimedia/declarative-camera/ZoomControl.qml @@ -0,0 +1,82 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +//! [0] +Item { + id : zoomControl + property real currentZoom : 1 + property real maximumZoom : 1 + property real minimumZoom : 1 + signal zoomTo(real target) + + visible: zoomControl.maximumZoom > zoomControl.minimumZoom + + MouseArea { + id : mouseArea + anchors.fill: parent + + property real initialZoom : 0 + property real initialPos : 0 + + onPressed: { + initialPos = mouseY + initialZoom = zoomControl.currentZoom + } + + onPositionChanged: { + if (pressed) { + var target = initialZoom * Math.pow(5, (initialPos-mouseY)/zoomControl.height); + target = Math.max(zoomControl.minimumZoom, Math.min(target, zoomControl.maximumZoom)) + zoomControl.zoomTo(target) + } + } + } + + Item { + id : bar + x : 16 + y : parent.height/4 + width : 24 + height : parent.height/2 + + Rectangle { + anchors.fill: parent + + smooth: true + radius: 8 + border.color: "white" + border.width: 2 + color: "black" + opacity: 0.3 + } + + Rectangle { + id: groove + x : 0 + y : parent.height * (1.0 - (zoomControl.currentZoom-zoomControl.minimumZoom) / (zoomControl.maximumZoom-zoomControl.minimumZoom)) + width: parent.width + height: parent.height - y + smooth: true + radius: 8 + color: "white" + opacity: 0.5 + } + + Text { + id: zoomText + anchors { + left: bar.right; leftMargin: 16 + } + y: Math.min(parent.height - height, Math.max(0, groove.y - height / 2)) + text: "x" + Math.round(zoomControl.currentZoom * 100) / 100 + font.bold: true + color: "white" + style: Text.Raised; styleColor: "black" + opacity: 0.85 + font.pixelSize: 18 + } + } +} +//! [0] diff --git a/examples/multimedia/declarative-camera/declarative-camera.pro b/examples/multimedia/declarative-camera/declarative-camera.pro new file mode 100644 index 0000000..c60f1c9 --- /dev/null +++ b/examples/multimedia/declarative-camera/declarative-camera.pro @@ -0,0 +1,15 @@ +TEMPLATE=app +TARGET=declarative-camera + +QT += quick qml multimedia +CONFIG += add_ios_ffmpeg_libraries + +SOURCES += qmlcamera.cpp +RESOURCES += declarative-camera.qrc + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/declarative-camera +INSTALLS += target + +macos: QMAKE_INFO_PLIST = Info.qmake.macos.plist +ios: QMAKE_INFO_PLIST = Info.qmake.ios.plist + diff --git a/examples/multimedia/declarative-camera/declarative-camera.qml b/examples/multimedia/declarative-camera/declarative-camera.qml new file mode 100644 index 0000000..eb97837 --- /dev/null +++ b/examples/multimedia/declarative-camera/declarative-camera.qml @@ -0,0 +1,190 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtCore +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtMultimedia + +Rectangle { + id : cameraUI + + width: 800 + height: 480 + + color: "black" + state: "PhotoCapture" + + property string platformScreen: "" + property int buttonsPanelLandscapeWidth: cameraUI.width/2 + property int buttonsPanelPortraitHeight: cameraUI.height/3 + + CameraPermission { + id: cameraPermission + + onStatusChanged: { + // In case the application does not already have permissions at startup + if (status === Qt.PermissionStatus.Granted) + camera.start() + else if (status === Qt.PermissionStatus.Denied) + camera.stop() + } + } + Component.onCompleted: { + // In case the application already has permissions at startup + if (cameraPermission.status === Qt.PermissionStatus.Granted) + camera.start() + else + cameraPermission.request() + } + + //! [0] + states: [ + State { + name: "PhotoCapture" + StateChangeScript { + script: { + camera.start() + } + } + }, + State { + name: "PhotoPreview" + }, + State { + name: "VideoCapture" + StateChangeScript { + script: { + camera.start() + } + } + }, + State { + name: "VideoPreview" + StateChangeScript { + script: { + camera.stop() + } + } + } + ] + //! [0] + + CaptureSession { + id: captureSession + camera: Camera { + id: camera + } + imageCapture: ImageCapture { + id: imageCapture + } + + recorder: MediaRecorder { + id: recorder +// resolution: "640x480" +// frameRate: 30 + } + videoOutput: viewfinder + } + + PhotoPreview { + id : photoPreview + anchors.fill : parent + onClosed: cameraUI.state = "PhotoCapture" + visible: (cameraUI.state === "PhotoPreview") + focus: visible + source: imageCapture.preview + } + + VideoPreview { + id : videoPreview + anchors.fill : parent + onClosed: cameraUI.state = "VideoCapture" + visible: (cameraUI.state === "VideoPreview") + focus: visible + + //don't load recorded video if preview is invisible + source: visible ? recorder.actualLocation : "" + } + + // Display text and a button to request permission + RowLayout { + visible: cameraPermission.status !== Qt.PermissionStatus.Granted + anchors.centerIn: parent + Text { + color: "white" + text: "Camera permission not granted" + } + + Button { + text: "Press to request" + onClicked: cameraPermission.request() + } + } + + VideoOutput { + id: viewfinder + visible: ((cameraUI.state === "PhotoCapture") || (cameraUI.state === "VideoCapture")) + anchors.fill: parent + // autoOrientation: true + } + + //! [1] + Item { + id: controlLayout + + readonly property bool isMobile: Qt.platform.os === "android" || Qt.platform.os === "ios" + readonly property bool isLandscape: Screen.desktopAvailableWidth >= Screen.desktopAvailableHeight + property int buttonsWidth: state === "MobilePortrait" ? Screen.desktopAvailableWidth / 3.4 : 114 + + states: [ + State { + name: "MobileLandscape" + when: controlLayout.isMobile && controlLayout.isLandscape + }, + State { + name: "MobilePortrait" + when: controlLayout.isMobile && !controlLayout.isLandscape + }, + State { + name: "Other" + when: !controlLayout.isMobile + } + ] + + onStateChanged: { + console.log("State: " + controlLayout.state) + } + } + //! [1] + + //! [2] + PhotoCaptureControls { + id: stillControls + state: controlLayout.state + anchors.fill: parent + buttonsWidth: controlLayout.buttonsWidth + buttonsPanelPortraitHeight: cameraUI.buttonsPanelPortraitHeight + buttonsPanelWidth: cameraUI.buttonsPanelLandscapeWidth + captureSession: captureSession + visible: (cameraUI.state === "PhotoCapture") + onPreviewSelected: cameraUI.state = "PhotoPreview" + onVideoModeSelected: cameraUI.state = "VideoCapture" + previewAvailable: imageCapture.preview.length !== 0 + } + //! [2] + + VideoCaptureControls { + id: videoControls + state: controlLayout.state + anchors.fill: parent + buttonsWidth: controlLayout.buttonsWidth + buttonsPanelPortraitHeight: cameraUI.buttonsPanelPortraitHeight + buttonsPanelWidth: cameraUI.buttonsPanelLandscapeWidth + captureSession: captureSession + visible: (cameraUI.state === "VideoCapture") + onPreviewSelected: cameraUI.state = "VideoPreview" + onPhotoModeSelected: cameraUI.state = "PhotoCapture" + } +} diff --git a/examples/multimedia/declarative-camera/declarative-camera.qmlproject b/examples/multimedia/declarative-camera/declarative-camera.qmlproject new file mode 100644 index 0000000..53f5ecb --- /dev/null +++ b/examples/multimedia/declarative-camera/declarative-camera.qmlproject @@ -0,0 +1,18 @@ +/* File generated by QtCreator */ + +import QmlProject 1.0 + +Project { + /* Include .qml, .js, and image files from current directory and subdirectories */ + QmlFiles { + directory: "." + } + JavaScriptFiles { + directory: "." + } + ImageFiles { + directory: "." + } + /* List of plugin directories passed to QML runtime */ + // importPaths: [ "../exampleplugin" ] +} diff --git a/examples/multimedia/declarative-camera/declarative-camera.qrc b/examples/multimedia/declarative-camera/declarative-camera.qrc new file mode 100644 index 0000000..c6f7013 --- /dev/null +++ b/examples/multimedia/declarative-camera/declarative-camera.qrc @@ -0,0 +1,20 @@ + + + PhotoPreview.qml + ZoomControl.qml + VideoCaptureControls.qml + VideoPreview.qml + PhotoCaptureControls.qml + declarative-camera.qml + CameraButton.qml + CameraListButton.qml + FlashControl.qml + images/camera_camera_setting.png + images/camera_flash_auto.png + images/camera_flash_fill.png + images/camera_flash_off.png + images/camera_flash_redeye.png + images/toolbutton.png + images/toolbutton.sci + + diff --git a/examples/multimedia/declarative-camera/doc/images/CaptureControls.png b/examples/multimedia/declarative-camera/doc/images/CaptureControls.png new file mode 100644 index 0000000000000000000000000000000000000000..8c24d80305e725b2cd9d6a89aa830e65cb82bd71 GIT binary patch literal 41278 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 elLc(xX7@SOHJdi@+Tolm%m-#?J@K!L&}oSP literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/images/FlashControls.png b/examples/multimedia/declarative-camera/doc/images/FlashControls.png new file mode 100644 index 0000000000000000000000000000000000000000..93eec867bfbc1800688703d51f5931c692ec38bb GIT binary patch literal 69725 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 XAO#$QvelUM00000NkvXXu0mjfNWUN` literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/images/VideoCaptureControls.png b/examples/multimedia/declarative-camera/doc/images/VideoCaptureControls.png new file mode 100644 index 0000000000000000000000000000000000000000..c35be7beb5de451441e1701c802debdb8afda75b GIT binary patch literal 35913 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/images/ZoomControl.png b/examples/multimedia/declarative-camera/doc/images/ZoomControl.png new file mode 100644 index 0000000000000000000000000000000000000000..d628e60f1d29be481abc7ee3e90185baad249632 GIT binary patch literal 28291 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 N002ovPDHLkV1nTURu%vN literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/images/qml-declarative-portrait.png b/examples/multimedia/declarative-camera/doc/images/qml-declarative-portrait.png new file mode 100644 index 0000000000000000000000000000000000000000..7adfdb0210467aa60d62420a1d4205340f54b119 GIT binary patch literal 49057 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/src/declarative-camera.qdoc b/examples/multimedia/declarative-camera/doc/src/declarative-camera.qdoc new file mode 100644 index 0000000..f1eb209 --- /dev/null +++ b/examples/multimedia/declarative-camera/doc/src/declarative-camera.qdoc @@ -0,0 +1,148 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! +\example declarative-camera +\title QML Camera Application +\ingroup multimedia_examples +\ingroup camera_examples_qml +\examplecategory {Multimedia} +\examplecategory {Mobile} +\brief This Qt Quick based application shows how to use the API to capture a +still image or video. + +\image qml-camera.png + {Camera app in landscape mode showing live preview and capture controls} + +This example demonstrates how to access camera functions via QML. +It shows how to change settings and capture images or video. + +\include examples-run.qdocinc + +\section1 Application structure + +Most of the QML code in this example supports the user interface. Custom types +that support the requirements have been implemented using existing Qt Quick +controls. + +\section1 Using screen orientation to select layout + +The orientation and control layout state logic is encapsulated in a separate +Item, \c controlLayout like so: + +\snippet declarative-camera/declarative-camera.qml 1 + +The \c stillControls and \c videoControls objects both bind to the \c state +and \c buttonsWidth properties of this Item, as shown in \c stillControls: + +\snippet declarative-camera/declarative-camera.qml 2 + +To support debugging, a message about layout state change is logged. + +Here is the portrait layout: + +\image qml-declarative-portrait.png + {Camera app in portrait mode showing live preview and capture controls} + +You can see the \c state property is initially set as \c PhotoCapture. + +Then the \c states themselves are defined like so: + +\snippet declarative-camera/declarative-camera.qml 0 + +\section1 Controls for capturing + +Controls for capturing are implemented in \c PhotoCaptureControls.qml and +VideoCaptureControls.qml. They each are based on a \l FocusScope that defines +common buttons dimensions and margins that are used by the control buttons and +then declares the buttons. + +This generates a column on the right hand side of the screen which includes, +listed top to bottom, the following controls: +\div {class="multi-column"} + \div {class="doc-column"} + \list + \li A \c Capture or \c Record button, which initiates capturing. + \li A \c{capture properties} button that displays the icon of the current + white balance mode selected and when pressed uses a pop-up to displays + the following option's icons: + \list + \li Flash mode (if available) + \li White balance modes + \li Exposure compensation + \endlist + \li A \c View button, once something has been captured. + \li A button which displays the currently selected capture device and + when pressed provides a list of available devices to switch to, using a + pop-up. + \li A \c{Switch To} button that displays the alternate capture mode + (video or photo) depending on the current active selection and switches + the mode when pressed. + \li A \c Quit button, that exits the application. + \endlist + \enddiv + \div {class="doc-column"} + \inlineimage CaptureControls.png + {Photo capture control panel} + \enddiv + \div {class="doc-column"} + \inlineimage VideoCaptureControls.png + {Video capture control panel} + \enddiv +\enddiv + +\section1 Image capturing + +The button that triggers this is defined in CameraButton.qml: +but its interaction with the camera is in the controls types, lets look at +PhotoCaptureControls: + +\snippet declarative-camera/PhotoCaptureControls.qml 0 + +\section1 Zoom control + +\div {class="multi-column"} + \div {class="doc-column"} + Implemented in \c ZoomControl.qml the ZoomControl type is based on an Item + and creates a bar that represents the zoom level, which can also be dragged. + It uses an exponential calculation method to determine the zoom factor given + the position of the \c grove. + + The bar is only visible if the initialZoom is greater than 1. This means + the currently active camera has a zoom function. + \enddiv + \div {class="doc-column"} + \inlineimage ZoomControl.png + {Adjustable zoom level bar} + \enddiv +\enddiv + +\snippet declarative-camera/ZoomControl.qml 0 + +In PhotoCaptureControls.qml and VideoCaptureControls.qml the signal \c zoomTo +will set the selected camera's \l{Camera::}{zoomFactor} property to the +calculated \c target value, as well as updating the ZoomControl bar. + +\snippet declarative-camera/VideoCaptureControls.qml 0 + +\section1 Flash and torch control + +\image FlashControls.png + {Toggle between Flash and Torch mode} + +Defined in \c FlashControl.qml this enables flash mode selection and torch +functionality to be toggled via a Switch. As with the zoom control, the switches +are only visible on top of the preview window if the active device supports +these functions. + +Here we check if the functions are supported: + +\snippet declarative-camera/FlashControl.qml 0 + +Here we implement the \c flashModeControl switch, which also directly controls +the Camera device. + +\snippet declarative-camera/FlashControl.qml 1 + +Torch control is implemented in a similar way. +*/ diff --git a/examples/multimedia/declarative-camera/images/camera_camera_setting.png b/examples/multimedia/declarative-camera/images/camera_camera_setting.png new file mode 100644 index 0000000000000000000000000000000000000000..7b993eee93662d696b25c3eb4b96d7ec5757261c GIT binary patch literal 717 zcmV;;0y6!HP)bH=IIl~g3AGrrD@vSL=yt%HaVbAzVGAOJ_kT9^>ZT)h!o!$ zlIMAR0GKH*H3GtiYYdIP_`Z?QaZjZfKpoSS0t8Bhx^=&yd_d&|OAtp0;#=y02vs`| zZMR!Nvm6V63pe;n9SFCbHoI=uC)ahgOA6IQR`!i1LBIu?_jO&1F~YSe4|rSv5k_gK zBpBQADIms_64j7Tn*iuSi~(q-MAJ@A4KcQuOOSB5H3mYb8ZA{a>s$~z0M42qbk_q7 z1PU;fGJ$h;GFi|#v_;a){g=}yUQqxd!y@nzH(U@?tjJsf$*CY~EvI%=m?akk_mc9; zB~_IHlo2e8c^oKB}>5CqoweAc?iX0yS|d3avslhKoC z*APp%kTC?gPqjo48$%%T(;kw)764@k9HZ@*WQjar1c99k^80j&Ol$;k@$*zX_wKY2 z1d2f#^_-&`<%USf{4om}`|)3i2f#lE_!3|MIHUNiiFANx00000NkvXXu0mjfca||B literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_flash_auto.png b/examples/multimedia/declarative-camera/images/camera_flash_auto.png new file mode 100644 index 0000000000000000000000000000000000000000..fb5cc40eca5542c84909b6527d8be6d0eae93882 GIT binary patch literal 1119 zcmV-l1fctgP)bvAu(nqJ9C491T|o`3C(a)GoRXvV3icC%+(oc)48m27`h0;`w}brqd~Y z_Nbj~1ISJmThp`O?RHb01wnv^?o0*~ea-y+;s8RLeQf{;kovjz7(ln(Zl_6-D4k!g z*LYxTI^eAXSbCnPoqgAJ@j&k$187rA;y6}1e>@)Xu!Q^GT>u_tS7&%TcuO{e-ZFp~ z_*NP60{$RR?lAzjN$UKL0CsS&DeAm+0DwfJ)L9k4V+{v;ifd>~B<_4PFig6OfM(mhcWIZsbdxo|sM`Wlh1mr6CNu|8q9b2uEN7l*?k zgqhNL81AJBz|Xyn=Ma2vZ*O?;=$ZhAa8h$Idyvk2-_M$@;T{U$-6%11?4slLFbvav zzn?a3AOvVCAmCaS(n^E$<7O=b)iGwRP{l%~Neui)@9+QL;(ot(CX>mhPQX7}uh+A| zrK5u;#yXu&Gy1ueP4Ht~{I6E4QUK`l^74XYI~a@!HuJ?X#H1(ZF>71n;$VXRT+4`X z+3j}!UUw6MZ#*7jyr79noEGtqgvB`=6(a3w!H4JZSnX>AD2X!`W2sE@fQbxrPNm>m zEEX7NT_q(R>fj$0^#h`1sBwcDK+{D z|BTHNKr|-}+ZCBhoL*X85%)V)yUjU7FxyOrwG8*p=kpwn zTU#0pP)zC?%Yd|MZ?u9+lOh?|vXGQvObw3H7)Ll^I}UGpB_fmA%4uNu6NK5KkoHJ8iFHCo-P3ypb@al*X!Q>4n z_Kb>|i`kt#KR+L^hXmPhxm;%2C1Z`9xi0JQj%4d_s`;R?k=&Ch0l-J`>2+h{ywPXY lpJu=RYVaGtmG)PF0RV%Gi7~j*Q4jzC002ovPDHLkV1lGG4d?&> literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_flash_fill.png b/examples/multimedia/declarative-camera/images/camera_flash_fill.png new file mode 100644 index 0000000000000000000000000000000000000000..7bc5949ace84ea99d6774b77645ba59848e01432 GIT binary patch literal 610 zcmV-o0-gPdP)t09LJmb zj2eKb>)NZn5CRv`IqNbPz+j9CQ6HnG2EZfKH@Q1w4uD=MwVC`hO_nhht^OGRH4;OD zTLHj5>Yo8%q?DoRb7}yX4%gxgP`^LQ9i#wg6s9jw;Ct0S65whZeCngMrl@};fC{k< zPJKZUz-!u^`Y8jJLmUARWZF`rZCiYyJOW_!*@o0un!elsL8dJ=mZmQ^KzEY*ciWL0 zKqnTa*LFOczB3mzzA(NU-z&>a1t7+Dm{Lp1B=y%UHwAzo+p%W)C;+Gk^*J?wpuHlk z^{VMB4G?4cI5hwkVfuzrOG>`A7aF1d+K`6>p!kMi$Z99>tGS|9XG|fH6T%hreIaz( z)?z9ITB-9v<2;%oyVH9i@R_D*ZmpD+>_Qq4zPs)+u%msO?^N2Tfto(sys!`GVl9R9 zfnW$c?+!YK<$R}hBYO#f`R;nZ2|4H}Z6zKc7F#Wn;t|v8_B$Y4i=2E@CIz7KC0SL~ wUPt=l9)Hi{Hx?i?D*O4b#0TJi1N;dv05OxGiQ*@g*#H0l07*qoM6N<$g5Vniv;Y7A literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_flash_off.png b/examples/multimedia/declarative-camera/images/camera_flash_off.png new file mode 100644 index 0000000000000000000000000000000000000000..3c5db10ccf41484d22ac1867154fe3a980c43b37 GIT binary patch literal 717 zcmV;;0y6!HP)>jIJQCpI z{<17l@$`Pc{cQ0_08P#^-Pb7bNC2+;#)*cAM*$2R_m9V;?>@Jyw?jQuWK7tV5_gCrSRk9A;Ah`E!LJ;)Vwaj!Vtelm&cc)zX<0FZ7 z59`=@zg8B?J>{chip&9M-v2A{2KeUyKLQK@8$C30j-lcj00000NkvXXu0mjfY{f?I literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_flash_redeye.png b/examples/multimedia/declarative-camera/images/camera_flash_redeye.png new file mode 100644 index 0000000000000000000000000000000000000000..534a087df5c9a8418c7ccd2b7477e3a24dbdf629 GIT binary patch literal 945 zcmV;i15W&jP)D1AqvSNZ()ssXij>;2bY z2H-FPFf1HwoTd zuh-6UxdgrD&*;@=1^nS~m?7e7Bo~WCAwZQ8jpMjT)3mtX@0It^hCaL_=vI#5D~I2{ z@56ya21;uMbOA&#$_>JC7=$KCQgIfJ;(amhAT$Nl;5Z+TcL+2GivS@|Vw~3%fEY$d zU<}cN3sNP4;|DM1Mt~w zR#^=ejPO+eAtqI60T6Y9ei`|vsdq3K+|@lo^nr~U5S}Rj7fVPJk@Iy%NkD_9&8O}u zl}c)$$QJeu0L#>^4Im+Y>o|`-Y*vHw$mOg13q z{tglcXs!BNSIp(7(<#RRgQH(Z`hAo>&Zx^GEeL|rKKXz{Qr1#h2iXFMbtzQ*9he#T zH>3FU)yyc3a*7knWIzWooVFXVH!^NRhY~(0IBNY&M(g?RNWY zx}|k>BLl}%L`$Vm-R5rU!^%mzXdQ%YDD-GWVr(|L%rrR+{(~}bS{7-E$#t>|3Oxf8 z$gdG2u`w%OCC=wF=z)`TC%;VK`MdM4686KE1z-VK02Y7+U;$VF7Qp++9{~mc-o!=J TUU;|s00000NkvXXu0mjfFioSw literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/toolbutton.png b/examples/multimedia/declarative-camera/images/toolbutton.png new file mode 100644 index 0000000000000000000000000000000000000000..11310013eedc808ca278e3068d7779e708422726 GIT binary patch literal 2550 zcmVe zSad^gZEa<4bO1wgWnpw>WFU8GbZ8()Nlj2!fese{00~}6L_t(&-kn;@Ze&RjJrQ}U z%I)@yx>vMhM)Vd??@(_*@_Yb7zz49M58wmf14gXj57@F~Rl)u9qI_Ld^LrWu%xs>-#eH7mxJ+t3r+Iu8>W-a$yaW&t9&L`W+wBlS zfLl#pt~TpGtyZfqA$po-jn!)P$DjWACx19QJHykbPjPf~R4mp`GJ`_tnt(B$NSb8* zzQ_XH0$@3QS~Nt>JtdI!X60wP2}Fdu54Tva*SNgA#6MqugMWPW6^@UOzjlnD5dfT= zoc#X9ix;2&_Se6`#l;1#uCB2Ehi68#3$>GQ&EiUM!f+9^cl;4}c5EU-m|w1^6+#F& zK0e0jCqKliSFiB*FTTLXA3grv1OS`O=JT_&Gn}8F-8ETgyHgg=*R!L*lAJU z{d}G_7_K?rx!~xVyW<`}gnh^5si>^ZGTuyS(`M1OQK- zJi%tO!GCt&#n|)yL5pugLm^OmbDx@NlF)fEk><<7FboZW0t6@k(*1ymcxVtz(*#lg z>~M2)joaHB{OI{7`1arb`fLJ#^?IFS*aF2~Q>LCE71Q5IL$F-wUE-g~UqYuw-8W91xn+bx`P@ZMvZCNMK50N8G~P*pH9 zL^DqZ&ENt)LYaKi!;NQmGju%+0H$cKFZvjcX1 z3lfFb0OuH6e~;a63r9c*Ap$T>6TJ5j5$txmIfa;AP=S|S+yPBAj$oxZdvWW^Iga8uDf^wmPB@BB2s9<3e0NHtnC{zg|fO9SapsENVl)F#7d{_lx z-pvfaKzx?e2qF=uH4{adCkVLNp4_%?~t) zssKzS1E{~dcBd==y(}PTb9-<6EPnMkiUV1u74Wpq1j3YavSEM~xjDL{X3rBWDBq-> z<#R!#$?=6sL)*oQ4jItoebN65fQA9dSR|Tcb;siL5&)1=rR%hnCY8XlW7Txs2S9yq z0>A>#1BT^|;r6*U%nJZ|3@{&s&I^ZKU`=15OjQd~&kxk8G&4!G%Nngd3jkWw5uHpE zTE8-6K)Mh@i0G<9c`0x*wPo3Hi)5_megz#P>d zGxL=RL<$L!9Z94{MURcu-u1mZwpfV5?^^&0uOC9kjvofVUN1CY7d*fO<_XGa!O?dX zf~O3E191T9VoOx!Qh2aqDbFv(5YJLB(Cq5i_6u~3_ zwbCyDnC{Q~z#ImH9Be7Nq`|V2l%*Shs$cX-%JG%P28av*JeS*c9o7gn09Yqz84w3| zb2gJQ?adRETCugS_ytATwLZdBc$unVohIe{UT2{?1jH|FOJI8M;l1ytLGS$x0D06;<&KZf=^ zKY%!<#cH>~WXj~R2rdiYS@o08_Vcb{k)!l zS%IomIEvfYl$2q$^oEvSqYJt8Ub;xAvQZ7f=$f^{T^~S1nApJ)gE(4Rs=Ri5z0j3J zn$D49XHcjugx68ww7}X05jM&teE*hOT_2dK$1M0UOh0GN9i%v`kmmx6Dg0nD7!gpI3_$P_2Y zXj^4Hpb~@jABRyBv#xkv7@Q)ZX^GWhn9R`BTRahgC%42QakQgUs;|?9;zFSmM@zL% zV}$49@j^}607?MEnUtDLmgEhg>NvdsL1X{l?miLb6QL>F?fCeFO zsI4~A0h=mq2wEVgUjNPZ_SA?HcRhSr0ghPFZG_VDS?VlMl^)zw?WNM5^V=(e&bbVP zRz3Tk4%(EbBtv=*8={Q8u2YKVQik-7Z#x$-NEQ+htR;Wx&Yp9`fu<B652VFZWs1RLPz+Io`c{_x1PR z|MypJ{*KUJFE1~D@&5Yy`QyirvDs{LOy>%5{%%hECFmYHFNM)una#u=iB$nYl{xCd z>`+x%o@f%LY03<`ySu}iH*fIv?OUwZ>tEj9e)yIE;PmwL*>=1AaDTV`n{)0{=Nx!) z-Lt<3#d3W%kV<5&zUl_us};i&=sgCA%~?Pyr_&~;w%^s&Ri4EE09*nYhh&1)L;wH) M07*qoM6N<$g3{N*E&u=k literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/toolbutton.sci b/examples/multimedia/declarative-camera/images/toolbutton.sci new file mode 100644 index 0000000..9e4f965 --- /dev/null +++ b/examples/multimedia/declarative-camera/images/toolbutton.sci @@ -0,0 +1,5 @@ +border.left: 15 +border.top: 4 +border.bottom: 4 +border.right: 15 +source: toolbutton.png diff --git a/examples/multimedia/declarative-camera/qmlcamera.cpp b/examples/multimedia/declarative-camera/qmlcamera.cpp new file mode 100644 index 0000000..ff00171 --- /dev/null +++ b/examples/multimedia/declarative-camera/qmlcamera.cpp @@ -0,0 +1,19 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include +#include +#include + +int main(int argc, char *argv[]) +{ + QGuiApplication app(argc, argv); + QQuickView view; + view.setResizeMode(QQuickView::SizeRootObjectToView); + + QObject::connect(view.engine(), &QQmlEngine::quit, qApp, &QGuiApplication::quit); + view.setSource(QUrl("qrc:///declarative-camera.qml")); + view.show(); + + return app.exec(); +} diff --git a/examples/multimedia/multimedia.pro b/examples/multimedia/multimedia.pro new file mode 100644 index 0000000..aa58df1 --- /dev/null +++ b/examples/multimedia/multimedia.pro @@ -0,0 +1,22 @@ +TEMPLATE = subdirs +QT_FOR_CONFIG += multimedia-private +CONFIG += add_ios_ffmpeg_libraries + +# These examples all need widgets for now (using creator templates that use widgets) +qtHaveModule(widgets) { + SUBDIRS += \ + audiodevices \ + audiooutput \ + audiorecorder \ + camera \ + player \ + videographicsitem \ + videowidget \ + screencapture +} + +qtHaveModule(quick) { + SUBDIRS += \ + declarative-camera \ + video +} diff --git a/examples/multimedia/player/CMakeLists.txt b/examples/multimedia/player/CMakeLists.txt new file mode 100644 index 0000000..619fe82 --- /dev/null +++ b/examples/multimedia/player/CMakeLists.txt @@ -0,0 +1,45 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(player LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/player") + +find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets Network) + +qt_add_executable(player + main.cpp + player.cpp player.h + playercontrols.cpp playercontrols.h + playlistmodel.cpp playlistmodel.h + videowidget.cpp videowidget.h + qmediaplaylist.cpp qmediaplaylist.h + qmediaplaylist_p.cpp qmediaplaylist_p.h + qplaylistfileparser.cpp qplaylistfileparser.h + audiolevelmeter.cpp audiolevelmeter.h +) + +qt_add_ios_ffmpeg_libraries(player) + +set_target_properties(player PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +target_link_libraries(player PUBLIC + Qt::MultimediaWidgets + Qt::Network +) + +install(TARGETS player + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/player/audiolevelmeter.cpp b/examples/multimedia/player/audiolevelmeter.cpp new file mode 100644 index 0000000..150d75e --- /dev/null +++ b/examples/multimedia/player/audiolevelmeter.cpp @@ -0,0 +1,367 @@ +// Copyright (C) 2025 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiolevelmeter.h" + +#include +#include +#include +#include +#include + +using namespace Qt::StringLiterals; + +// Converts a float sample value to dB and clamps it between DB_MIN and DB_MAX +static float amplitudeToDb(float f) +{ + if (f <= 0) + return DB_MIN; + return std::clamp(float(20.0) * std::log10(f), DB_MIN, DB_MAX); +} + +static bool isSilent(float db) { + return db < DB_SILENCE; +} + +AudioLevelMeter::AudioLevelMeter(QWidget *parent) : QWidget(parent) +{ + // Layout and background color + setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Preferred); + setMinimumWidth(WIDGET_WIDTH); + QPalette currentPalette = palette(); + currentPalette.setColor(QPalette::Window, currentPalette.color(QPalette::Base)); + setPalette(currentPalette); + setAutoFillBackground(true); + auto *mainLayout = new QVBoxLayout(this); + mainLayout->setSpacing(2); + mainLayout->setContentsMargins(0, 0, 0, 0); + + // Meter channels + auto *meterChannelLayout = new QHBoxLayout(); + meterChannelLayout->setContentsMargins(2, 2, 2, 2); + meterChannelLayout->setSpacing(2); + for (int i = 0; i < MAX_CHANNELS; ++i) { + auto *channel = new MeterChannel(this); + meterChannelLayout->addWidget(channel); + m_channels[i] = channel; + } + mainLayout->addLayout(meterChannelLayout); + + // Peak label + m_peakLabel = new QLabel(u"-"_s, this); + m_peakLabel->setAlignment(Qt::AlignCenter); + QFont font = QApplication::font(); + font.setPointSize(10); + m_peakLabel->setFont(font); + mainLayout->addWidget(m_peakLabel); + mainLayout->setStretch(0, 1); + + // On/off button + m_onOffButton = new QToolButton(this); + mainLayout->addWidget(m_onOffButton); + m_onOffButton->setMaximumWidth(WIDGET_WIDTH); + m_onOffButton->setText(u"On"_s); + m_onOffButton->setCheckable(true); + m_onOffButton->setChecked(true); + connect(m_onOffButton, &QToolButton::clicked, this, &AudioLevelMeter::toggleOnOff); + + // Timer triggering update of the audio level bars + m_updateTimer.callOnTimeout(this, &AudioLevelMeter::updateBars); + + // Timer postponing deactivation of update timer to allow meters to fade to 0 + m_deactivationTimer.callOnTimeout(&m_updateTimer, &QTimer::stop); + m_deactivationTimer.setSingleShot(true); + + // Timer resetting the peak label + m_peakLabelHoldTimer.callOnTimeout(this, &AudioLevelMeter::resetPeakLabel); + m_peakLabelHoldTimer.setSingleShot(true); + + // Buffer analyzer and worker thread that analyzes incoming buffers + m_analyzerThread.setObjectName("AnalyzerThread"); + m_bufferAnalyzer = new BufferAnalyzer; + m_bufferAnalyzer->moveToThread(&m_analyzerThread); + connect(&m_analyzerThread, &QThread::finished, m_bufferAnalyzer, &QObject::deleteLater); + connect(this, &AudioLevelMeter::newBuffer, m_bufferAnalyzer, &BufferAnalyzer::analyzeBuffer); + connect(m_bufferAnalyzer, &BufferAnalyzer::valuesReady, this, &AudioLevelMeter::updateValues); + m_analyzerThread.start(); +} + +// Analyzes an audio buffer and emits its peak and sumOfSquares values. +// Skips remaining frames if m_stopRrequested is set to true. +void BufferAnalyzer::analyzeBuffer(const QAudioBuffer &buffer, int maxChannelsToAnalyze) +{ + if (QThread::currentThread()->isInterruptionRequested()) + return; // Interrupted by ~AudioLevelMeter, skipping remaining buffers in signal queue + + m_stopRequested.store(false); + + int channelCount = buffer.format().channelCount(); + int channelsToAnalyze = std::min(channelCount, maxChannelsToAnalyze); + + BufferValues values(channelsToAnalyze); + + const unsigned char *bufferPtr = buffer.constData(); + const unsigned char *endOfBuffer = bufferPtr + buffer.byteCount(); + int bytesPerSample = buffer.format().bytesPerSample(); + + while (bufferPtr < endOfBuffer) { + if (m_stopRequested.load()) { + auto framesSkipped = (endOfBuffer - bufferPtr) / channelCount; + qDebug() << "BufferAnalyzer::analyzeBuffer skipped" + << framesSkipped << "out of" + << buffer.frameCount() << "frames"; + // Emit incomplete values also when stop is requested to get some audio level readout + // even if frames are being skipped for every buffer. Displayed levels will be + // inaccurate. + break; + } + + for (int channelIndex = 0; channelIndex < channelsToAnalyze; ++channelIndex) { + float sample = buffer.format().normalizedSampleValue( + bufferPtr + bytesPerSample * channelIndex); + values.peaks[channelIndex] = std::max(values.peaks[channelIndex], std::abs(sample)); + values.squares[channelIndex] += sample * sample; + } + bufferPtr += bytesPerSample * channelCount; + } + + emit valuesReady(values); +} + +// Receives a buffer from QAudioBufferOutput and triggers BufferAnalyzer to analyze it +void AudioLevelMeter::onAudioBufferReceived(const QAudioBuffer &buffer) +{ + if (!m_isOn || !buffer.isValid() || !buffer.format().isValid()) + return; + + if (!m_isActive) + activate(); + + // Update internal values to match the current audio stream + updateChannelCount(buffer.format().channelCount()); + m_frameCount = buffer.frameCount(); + m_bufferDurationMs = milliseconds(buffer.duration() / 1000); + + // Stop any ongoing analysis, skipping remaining frames + m_bufferAnalyzer->requestStop(); + + emit newBuffer(buffer, m_channelCount); +} + +// Updates peak/RMS values and peak label +void AudioLevelMeter::updateValues(const BufferValues &values) +{ + if (!m_isActive) + return; // Discard incoming values from BufferAnalyzer + + float bufferPeak = 0.0f; + for (size_t i = 0; i < values.peaks.size(); ++i) { + bufferPeak = std::max(bufferPeak, values.peaks[i]); + m_channels[i]->updatePeak(values.peaks[i]); + m_channels[i]->updateRms(values.squares[i], m_bufferDurationMs, m_frameCount); + } + updatePeakLabel(bufferPeak); +} + +// Updates peak label and restarts m_peakLabelHoldTimer if peak >= m_highestPeak +void AudioLevelMeter::updatePeakLabel(float peak) +{ + if (peak < m_highestPeak) + return; + + m_peakLabelHoldTimer.start(PEAK_LABEL_HOLD_TIME); + m_highestPeak = peak; + float dB = amplitudeToDb(m_highestPeak); + m_peakLabel->setText(QString::number(dB, 'f', 1)); +} + +// Resets peak label. Called when m_labelHoldTimer timeouts +void AudioLevelMeter::resetPeakLabel() +{ + if (!m_isOn) { + m_highestPeak = 0.0f; + m_peakLabel->setText({}); + return; + } + + m_highestPeak = 0.0f; + m_peakLabel->setText(QString::number(DB_MIN, 'f', 1)); +} + +// Clears internal data used to calculate RMS values +void AudioLevelMeter::clearAllRmsData() +{ + const QList meterChannels = m_channels; + for (MeterChannel *channel : std::as_const(meterChannels)) + channel->clearRmsData(); +} + +// Starts the update timer that updates the meter bar +void AudioLevelMeter::activate() +{ + m_isActive = true; + m_deactivationTimer.stop(); + m_updateTimer.start(UPDATE_INTERVAL); +} + +// Start the deactiviation timer that eventually stops the update timer +void AudioLevelMeter::deactivate() +{ + m_isActive = false; + clearAllRmsData(); + // Calculate the time it takes to decay fram max to min dB + m_deactivationTimer.start( + (DB_MAX - DB_MIN) / (DB_DECAY_PER_SECOND / 1000) + DECAY_EASE_IN_TIME.count()); +} + +// Decays internal peak and RMS values and triggers repainting of meter bars +void AudioLevelMeter::updateBars() +{ + for (int i = 0; i < m_channelCount; ++i) { + MeterChannel *channel = m_channels.at(i); + channel->decayPeak(); + channel->decayRms(); + channel->update(); // Trigger paint event + } +} + +// Toggles between on (activated) and off (deactivated) state. +void AudioLevelMeter::toggleOnOff() +{ + m_isOn = !m_isOn; + if (!m_isOn) + deactivate(); + else + activate(); + m_onOffButton->setText(m_isOn ? u"On"_s : u"Off"_s); +} + +// Updates the number of visible MeterChannel widgets +void AudioLevelMeter::updateChannelCount(int channelCount) +{ + if (channelCount == m_channelCount + || (channelCount > MAX_CHANNELS && MAX_CHANNELS == m_channelCount)) { + return; + } + + m_channelCount = std::min(channelCount, MAX_CHANNELS); + + for (int i = 0; i < MAX_CHANNELS; ++i) + m_channels.at(i)->setVisible(i < m_channelCount); +} + +MeterChannel::MeterChannel(QWidget *parent) + : QWidget(parent) +{ +} + +// Normalizes a dB value for visualization +float MeterChannel::normalize(float dB) +{ + return (dB - DB_MIN) / (DB_MAX - DB_MIN); +} + +// Clears the data used to calculate RMS values +void MeterChannel::clearRmsData() +{ + m_sumOfSquares = 0.0f; + m_sumOfSquaresQueue = std::queue(); +} + +// Decays m_peak value by DB_DECAY_PER_UPDATE with ease-in animation based on DECAY_EASE_IN_TIME +void MeterChannel::decayPeak() +{ + float peak = m_peak; + if (isSilent(peak)) + return; + + float cubicEaseInFactor = m_peakDecayRate * m_peakDecayRate * m_peakDecayRate; + m_peak = std::max(DB_MIN, peak - DB_DECAY_PER_UPDATE * cubicEaseInFactor); + + if (m_peakDecayRate < 1) { + m_peakDecayRate += static_cast(UPDATE_INTERVAL.count()) + / DECAY_EASE_IN_TIME.count(); + if (m_peakDecayRate > 1.0f) + m_peakDecayRate = 1.0f; + } +} + +// Decays m_rms value by DB_DECAY_PER_UPDATE with ease-in animation based on DECAY_EASE_IN_TIME +void MeterChannel::decayRms() +{ + float rms = m_rms; + if (isSilent(rms)) + return; + + float cubicEaseInFactor = m_rmsDecayRate * m_rmsDecayRate * m_rmsDecayRate; + m_rms = std::max(DB_MIN, rms - DB_DECAY_PER_UPDATE * cubicEaseInFactor); + + if (m_rmsDecayRate < 1) { + m_rmsDecayRate += static_cast(UPDATE_INTERVAL.count()) + / DECAY_EASE_IN_TIME.count(); + if (m_rmsDecayRate > 1.0f) + m_rmsDecayRate = 1.0f; + } +} + +// Updates m_peak and resets m_peakDecayRate if sampleValue > m_peak +void MeterChannel::updatePeak(float sampleValue) +{ + float dB = amplitudeToDb(sampleValue); + if (dB > m_peak) { + m_peakDecayRate = 0; + m_peak = dB; + } +} + +// Calculates current RMS. Resets m_rmsDecayRate and updates m_rms if current RMS > m_rms. +void MeterChannel::updateRms(float sumOfSquaresForOneBuffer, milliseconds duration, int frameCount) +{ + // Add the new sumOfSquares to the queue and update the total + m_sumOfSquaresQueue.push(sumOfSquaresForOneBuffer); + m_sumOfSquares += sumOfSquaresForOneBuffer; + + // Remove the oldest sumOfSquares to stay within the RMS window + if (int64_t(m_sumOfSquaresQueue.size() * duration.count()) > int64_t(RMS_WINDOW.count())) { + m_sumOfSquares -= m_sumOfSquaresQueue.front(); + m_sumOfSquaresQueue.pop(); + } + + // Fix negative values caused by floating point precision errors + if (m_sumOfSquares < 0) + m_sumOfSquares = 0; + + // Calculate the new RMS value + if (m_sumOfSquares > 0 && m_sumOfSquaresQueue.size() > 0) { + float newRms = std::sqrt(m_sumOfSquares / (frameCount * m_sumOfSquaresQueue.size())); + float dB = amplitudeToDb(newRms); + if (dB > m_rms) { + m_rmsDecayRate = 0; + m_rms = dB; + } + } +} + +// Paints the level bar of the meter channel based on the decayed peak and rms values. +void MeterChannel::paintEvent(QPaintEvent *event) +{ + Q_UNUSED(event); + if (isSilent(m_peak) && isSilent(m_rms)) + return; // Nothing to paint + + float peakLevel = normalize(m_peak); + float rmsLevel = normalize(m_rms); + + QPainter painter(this); + auto rect = QRectF( + 0, + height(), + width(), + -peakLevel * height()); + + painter.fillRect(rect, m_peakBrush); // Paint the peak level + rect.setHeight(-rmsLevel * height()); + painter.fillRect(rect, m_rmsBrush); // Paint the RMS level +} + +#include "moc_audiolevelmeter.cpp" diff --git a/examples/multimedia/player/audiolevelmeter.h b/examples/multimedia/player/audiolevelmeter.h new file mode 100644 index 0000000..60aba4e --- /dev/null +++ b/examples/multimedia/player/audiolevelmeter.h @@ -0,0 +1,144 @@ +// Copyright (C) 2025 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIOLEVELMETER_H +#define AUDIOLEVELMETER_H + +#include +#include +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE +class QToolButton; +class QLabel; +QT_END_NAMESPACE + +using namespace std::chrono_literals; +using std::chrono::milliseconds; + +// Constants used by AudioLevelMeter and MeterChannel +static constexpr int WIDGET_WIDTH = 34; +static constexpr int MAX_CHANNELS = 8; +static constexpr auto PEAK_COLOR = "#1F9B5D"; +static constexpr auto RMS_COLOR = "#28C878"; +static constexpr milliseconds RMS_WINDOW = 400ms; +static constexpr milliseconds PEAK_LABEL_HOLD_TIME = 2000ms; +static constexpr milliseconds DECAY_EASE_IN_TIME = 160ms; +static constexpr milliseconds UPDATE_INTERVAL = 16ms; // Assuming 60 Hz refresh rate. +static constexpr float DB_DECAY_PER_SECOND = 20.0f; +static constexpr float DB_DECAY_PER_UPDATE = + DB_DECAY_PER_SECOND / (1000 / UPDATE_INTERVAL.count()); +static constexpr float DB_MAX = 0.0f; +static constexpr float DB_SILENCE = -60.0f; +static constexpr float DB_MIN = -90.0f; + +// A struct used by BufferAnalyzer to emit its results back to AudioLevelMeter +struct BufferValues { + BufferValues(int nChannels) : peaks(nChannels, 0.0f), squares(nChannels, 0.0f) {} + std::vector peaks; + std::vector squares; +}; + +// A worker class analyzing incoming buffers on a separate worker thread +class BufferAnalyzer : public QObject +{ + Q_OBJECT +public: + void requestStop() { m_stopRequested.store(true); } + +public slots: + void analyzeBuffer(const QAudioBuffer &buffer, int maxChannelsToAnalyze); + +signals: + void valuesReady(const BufferValues &values); + +private: + std::atomic m_stopRequested = false; +}; + +// A custom QWidget representing an audio channel in the audio level meter. It serves +// both as a model for the channels's peak and RMS values and as a view using the overrided +// paintEvent() +class MeterChannel : public QWidget +{ + Q_OBJECT + friend class AudioLevelMeter; + +private: + explicit MeterChannel(QWidget *parent = nullptr); + + void paintEvent(QPaintEvent *event) override; + void activate(); + void deactivate(); + void updatePeak(float peak); + void updateRms(float sumOfSquaresForOneBuffer, milliseconds duration, int frameCount); + void clearRmsData(); + void decayPeak(); + void decayRms(); + float normalize(float dB); + + float m_peakDecayRate = 0.0f; + float m_rmsDecayRate = 0.0f; + float m_peak = DB_MIN; + float m_rms = DB_MIN; + float m_sumOfSquares = 0.0f; + std::queue m_sumOfSquaresQueue{}; + QBrush m_peakBrush{PEAK_COLOR}; + QBrush m_rmsBrush{RMS_COLOR}; +}; + +// The audio level meter´s parent widget class. It acts as a controller +// for the MeterChannel widgets and the BufferAnalyzer worker. +class AudioLevelMeter : public QWidget +{ + Q_OBJECT + +public: + explicit AudioLevelMeter(QWidget *parent = nullptr); + ~AudioLevelMeter() { + m_analyzerThread.requestInterruption(); + m_bufferAnalyzer->requestStop(); + m_analyzerThread.quit(); + m_analyzerThread.wait(); + }; + +signals: + void newBuffer(const QAudioBuffer &buffer, int nChannels); + +public slots: + void onAudioBufferReceived(const QAudioBuffer &buffer); + void deactivate(); + +private slots: + void toggleOnOff(); + void updateValues(const BufferValues &values); + void updateBars(); + void resetPeakLabel(); + +private: + void activate(); + void updateChannelCount(int nCh); + void updatePeakLabel(float peak); + void clearAllRmsData(); + + bool m_isOn = true; + bool m_isActive = false; + QList m_channels{MAX_CHANNELS}; + int m_channelCount = 0; + milliseconds m_bufferDurationMs = 0ms; + int m_frameCount = 0; + float m_highestPeak = 0.0f; + + QTimer m_updateTimer; + QTimer m_deactivationTimer; + QTimer m_peakLabelHoldTimer; + QLabel *m_peakLabel = nullptr; + QToolButton *m_onOffButton = nullptr; + BufferAnalyzer *m_bufferAnalyzer = nullptr; + QThread m_analyzerThread; +}; + +#endif // AUDIOLEVELMETER_H diff --git a/examples/multimedia/player/doc/images/mediaplayerex.jpg b/examples/multimedia/player/doc/images/mediaplayerex.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ba05b69bcf971ab014116c3592974582703514b7 GIT binary patch literal 58304 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 Mvd$*}QSj~m08BSE_y7O^ literal 0 HcmV?d00001 diff --git a/examples/multimedia/player/doc/src/player.qdoc b/examples/multimedia/player/doc/src/player.qdoc new file mode 100644 index 0000000..51dfd5c --- /dev/null +++ b/examples/multimedia/player/doc/src/player.qdoc @@ -0,0 +1,56 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example player + \title Media Player Example + \ingroup multimedia_examples + \ingroup video_examples + \examplecategory {Multimedia} + \brief Playing audio and video using Qt Widgets. + \meta {tag} {widgets} + + \image mediaplayerex.jpg + {Media player showing video playback and control panel} + + \e{Media Player} demonstrates a simple multimedia player that can play + audio and video files using various codecs. + + \include examples-run.qdocinc + + The example uses a QMediaPlayer object passed into a QVideoWidget to + control the video output. To give the application playlist capability + we also use a QMediaPlaylist object. QMediaPlaylist was removed from + our API in Qt 6, but its implementation is included in this example. + + An audio level meter shows peak and RMS levels during playback. + This is implemented by setting a QAudioBufferOutput to QMediaPlayer, + processing each QAudioBuffer it emits on a separate thread and + visualising the values through QWidget::paintEvent. + + To activate the various functions such as play and stop on the dialog, + the button clicked events emit the play() and stop() signals, which + are connected to the play() and stop() slots of QMediaPlayer. + + \code + connect(controls, SIGNAL(play()), player, SLOT(play())); + connect(controls, SIGNAL(pause()), player, SLOT(pause())); + connect(controls, SIGNAL(stop()), player, SLOT(stop())); + \endcode + + We can get the volume (and set our user interface representation) + + \code + controls->setVolume(player->volume()); + \endcode + + and we can make widget 'volume' changes change the volume + + \code + connect(controls, SIGNAL(changeVolume(int)), player, SLOT(setVolume(int))); + \endcode + + The example also allows us to change video properties by means + of the QVideoWidget object. We can go to Full Screen mode with a single + button click, and back again. +*/ diff --git a/examples/multimedia/player/main.cpp b/examples/multimedia/player/main.cpp new file mode 100644 index 0000000..475d6ce --- /dev/null +++ b/examples/multimedia/player/main.cpp @@ -0,0 +1,39 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "player.h" + +#include +#include +#include +#include +#include + +using namespace Qt::StringLiterals; + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + + QCoreApplication::setApplicationName(u"Player Example"_s); + QCoreApplication::setOrganizationName(u"QtProject"_s); + QCoreApplication::setApplicationVersion(QLatin1StringView(QT_VERSION_STR)); + QCommandLineParser parser; + parser.setApplicationDescription(u"Qt MultiMedia Player Example"_s); + parser.addHelpOption(); + parser.addVersionOption(); + parser.addPositionalArgument(u"url"_s, u"The URL(s) to open."_s); + parser.process(app); + + Player player; + + if (!parser.positionalArguments().isEmpty() && player.isPlayerAvailable()) { + QList urls; + for (const auto &a : parser.positionalArguments()) + urls.append(QUrl::fromUserInput(a, QDir::currentPath())); + player.addToPlaylist(urls); + } + + player.show(); + return QCoreApplication::exec(); +} diff --git a/examples/multimedia/player/player.cpp b/examples/multimedia/player/player.cpp new file mode 100644 index 0000000..48446f7 --- /dev/null +++ b/examples/multimedia/player/player.cpp @@ -0,0 +1,599 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "player.h" +#include "playercontrols.h" +#include "playlistmodel.h" +#include "qmediaplaylist.h" +#include "videowidget.h" +#include "audiolevelmeter.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +using namespace Qt::Literals; +using namespace Qt::StringLiterals; + +Player::Player(QWidget *parent) : QWidget(parent) +{ + //! [create-objs] + m_player = new QMediaPlayer(this); + m_audioOutput = new QAudioOutput(this); + m_player->setAudioOutput(m_audioOutput); + //! [create-objs] + connect(m_player, &QMediaPlayer::durationChanged, this, &Player::durationChanged); + connect(m_player, &QMediaPlayer::positionChanged, this, &Player::positionChanged); + connect(m_player, &QMediaPlayer::metaDataChanged, this, &Player::metaDataChanged); + connect(m_player, &QMediaPlayer::mediaStatusChanged, this, &Player::statusChanged); + connect(m_player, &QMediaPlayer::bufferProgressChanged, this, &Player::bufferingProgress); + connect(m_player, &QMediaPlayer::hasVideoChanged, this, &Player::videoAvailableChanged); + connect(m_player, &QMediaPlayer::errorChanged, this, &Player::displayErrorMessage); + connect(m_player, &QMediaPlayer::tracksChanged, this, &Player::tracksChanged); + + //! [2] + m_videoWidget = new VideoWidget(this); + m_videoWidget->resize(1280, 720); + m_player->setVideoOutput(m_videoWidget); + + m_playlistModel = new PlaylistModel(this); + m_playlist = m_playlistModel->playlist(); + //! [2] + connect(m_playlist, &QMediaPlaylist::currentIndexChanged, this, + &Player::playlistPositionChanged); + + // audio level meter + m_audioBufferOutput = new QAudioBufferOutput(this); + m_player->setAudioBufferOutput(m_audioBufferOutput); + m_audioLevelMeter = new AudioLevelMeter(this); + connect(m_audioBufferOutput, &QAudioBufferOutput::audioBufferReceived, + m_audioLevelMeter, &AudioLevelMeter::onAudioBufferReceived); + connect(m_player, &QMediaPlayer::playingChanged, + m_audioLevelMeter, &AudioLevelMeter::deactivate); + + // player layout + QBoxLayout *layout = new QVBoxLayout(this); + + // display + QBoxLayout *displayLayout = new QHBoxLayout; + displayLayout->addWidget(m_videoWidget, 2); + displayLayout->addWidget(m_audioLevelMeter, 3); +#if !defined(Q_OS_ANDROID) && !defined(Q_OS_IOS) + m_playlistView = new QListView(); + m_playlistView->setModel(m_playlistModel); + m_playlistView->setCurrentIndex(m_playlistModel->index(m_playlist->currentIndex(), 0)); + connect(m_playlistView, &QAbstractItemView::activated, this, &Player::jump); + displayLayout->addWidget(m_playlistView); +#endif + layout->addLayout(displayLayout); + + // duration slider and label + QHBoxLayout *hLayout = new QHBoxLayout; + + m_slider = new QSlider(Qt::Horizontal, this); + m_slider->setRange(0, m_player->duration()); + connect(m_slider, &QSlider::sliderMoved, this, &Player::seek); + hLayout->addWidget(m_slider); + + m_labelDuration = new QLabel(); + m_labelDuration->setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Fixed); + hLayout->addWidget(m_labelDuration); + layout->addLayout(hLayout); + + // controls + QBoxLayout *controlLayout = new QHBoxLayout; + controlLayout->setContentsMargins(0, 0, 0, 0); + + QPushButton *openButton = new QPushButton(tr("Open"), this); + connect(openButton, &QPushButton::clicked, this, &Player::open); + controlLayout->addWidget(openButton); + controlLayout->addStretch(1); + + PlayerControls *controls = new PlayerControls(); + controls->setState(m_player->playbackState()); + controls->setVolume(m_audioOutput->volume()); + controls->setMuted(controls->isMuted()); + + connect(controls, &PlayerControls::play, m_player, &QMediaPlayer::play); + connect(controls, &PlayerControls::pause, m_player, &QMediaPlayer::pause); + connect(controls, &PlayerControls::stop, m_player, &QMediaPlayer::stop); + connect(controls, &PlayerControls::next, m_playlist, &QMediaPlaylist::next); + connect(controls, &PlayerControls::previous, this, &Player::previousClicked); + connect(controls, &PlayerControls::changeVolume, m_audioOutput, &QAudioOutput::setVolume); + connect(controls, &PlayerControls::changeMuting, m_audioOutput, &QAudioOutput::setMuted); + connect(controls, &PlayerControls::changeRate, m_player, &QMediaPlayer::setPlaybackRate); + connect(controls, &PlayerControls::stop, m_videoWidget, QOverload<>::of(&QVideoWidget::update)); + + connect(m_player, &QMediaPlayer::playbackStateChanged, controls, + [controls](QMediaPlayer::PlaybackState arg) { + controls->setState(arg); + }); + connect(m_audioOutput, &QAudioOutput::volumeChanged, controls, &PlayerControls::setVolume); + connect(m_audioOutput, &QAudioOutput::mutedChanged, controls, &PlayerControls::setMuted); + + controlLayout->addWidget(controls); + controlLayout->addStretch(1); + + m_fullScreenButton = new QPushButton(tr("FullScreen"), this); + m_fullScreenButton->setCheckable(true); + controlLayout->addWidget(m_fullScreenButton); + + m_pitchCompensationButton = new QPushButton(tr("Pitch compensation"), this); + m_pitchCompensationButton->setCheckable(true); + switch (m_player->pitchCompensationAvailability()) { + case QMediaPlayer::PitchCompensationAvailability::AlwaysOn: + m_pitchCompensationButton->setEnabled(false); + m_pitchCompensationButton->setChecked(true); + m_pitchCompensationButton->setToolTip( + u"Pitch compensation always enabled on this backend"_s); + break; + case QMediaPlayer::PitchCompensationAvailability::Unavailable: + m_pitchCompensationButton->setEnabled(false); + m_pitchCompensationButton->setChecked(false); + m_pitchCompensationButton->setToolTip(u"Pitch compensation unavailable on this backend"_s); + break; + case QMediaPlayer::PitchCompensationAvailability::Available: + m_pitchCompensationButton->setEnabled(true); + m_pitchCompensationButton->setChecked(m_player->pitchCompensation()); + break; + default: + Q_UNREACHABLE(); + } + + controlLayout->addWidget(m_pitchCompensationButton); + connect(m_player, &QMediaPlayer::pitchCompensationChanged, this, [this] { + m_pitchCompensationButton->setChecked(m_player->pitchCompensation()); + }); + m_pitchCompensationButton->setChecked(m_player->pitchCompensation()); + connect(m_pitchCompensationButton, &QPushButton::toggled, m_player, + &QMediaPlayer::setPitchCompensation); + +#if !defined(Q_OS_ANDROID) && !defined(Q_OS_IOS) + m_audioOutputCombo = new QComboBox(this); + controlLayout->addWidget(m_audioOutputCombo); + + updateAudioDevices(); + + connect(m_audioOutputCombo, QOverload::of(&QComboBox::activated), this, + &Player::audioOutputChanged); + + QObject::connect(&m_mediaDevices, &QMediaDevices::audioOutputsChanged, this, [this] { + updateAudioDevices(); + }); +#endif + + layout->addLayout(controlLayout); + + // tracks + QGridLayout *tracksLayout = new QGridLayout; + + m_audioTracks = new QComboBox(this); + connect(m_audioTracks, &QComboBox::activated, this, &Player::selectAudioStream); + tracksLayout->addWidget(new QLabel(tr("Audio Tracks:")), 0, 0); + tracksLayout->addWidget(m_audioTracks, 0, 1); + + m_videoTracks = new QComboBox(this); + connect(m_videoTracks, &QComboBox::activated, this, &Player::selectVideoStream); + tracksLayout->addWidget(new QLabel(tr("Video Tracks:")), 1, 0); + tracksLayout->addWidget(m_videoTracks, 1, 1); + + m_subtitleTracks = new QComboBox(this); + connect(m_subtitleTracks, &QComboBox::activated, this, &Player::selectSubtitleStream); + tracksLayout->addWidget(new QLabel(tr("Subtitle Tracks:")), 2, 0); + tracksLayout->addWidget(m_subtitleTracks, 2, 1); + + layout->addLayout(tracksLayout); + +#if !defined(Q_OS_ANDROID) && !defined(Q_OS_IOS) + // metadata + + QLabel *metaDataLabel = new QLabel(tr("Metadata for file:")); + layout->addWidget(metaDataLabel); + + QGridLayout *metaDataLayout = new QGridLayout; + int key = QMediaMetaData::Title; + for (int i = 0; i < (QMediaMetaData::NumMetaData + 2) / 3; i++) { + for (int j = 0; j < 6; j += 2) { + m_metaDataLabels[key] = new QLabel( + QMediaMetaData::metaDataKeyToString(static_cast(key))); + if (key == QMediaMetaData::ThumbnailImage || key == QMediaMetaData::CoverArtImage) { + m_metaDataFields[key] = new QLabel; + } else { + auto lineEdit = new QLineEdit; + lineEdit->setReadOnly(true); + m_metaDataFields[key] = lineEdit; + } + m_metaDataLabels[key]->setDisabled(true); + m_metaDataFields[key]->setDisabled(true); + metaDataLayout->addWidget(m_metaDataLabels[key], i, j); + metaDataLayout->addWidget(m_metaDataFields[key], i, j + 1); + key++; + if (key == QMediaMetaData::NumMetaData) + break; + } + } + + layout->addLayout(metaDataLayout); +#endif + +#if defined(Q_OS_QNX) + // On QNX, the main window doesn't have a title bar (or any other decorations). + // Create a status bar for the status information instead. + m_statusLabel = new QLabel; + m_statusBar = new QStatusBar; + m_statusBar->addPermanentWidget(m_statusLabel); + m_statusBar->setSizeGripEnabled(false); // Without mouse grabbing, it doesn't work very well. + layout->addWidget(m_statusBar); +#endif + + if (!isPlayerAvailable()) { + QMessageBox::warning(this, tr("Service not available"), + tr("The QMediaPlayer object does not have a valid service.\n" + "Please check the media service plugins are installed.")); + + controls->setEnabled(false); + if (m_playlistView) + m_playlistView->setEnabled(false); + openButton->setEnabled(false); + m_fullScreenButton->setEnabled(false); + } + + metaDataChanged(); +} + +bool Player::isPlayerAvailable() const +{ + return m_player->isAvailable(); +} + +void Player::open() +{ + QFileDialog fileDialog(this); + fileDialog.setAcceptMode(QFileDialog::AcceptOpen); + fileDialog.setWindowTitle(tr("Open Files")); + fileDialog.setDirectory(QStandardPaths::standardLocations(QStandardPaths::MoviesLocation) + .value(0, QDir::homePath())); + if (fileDialog.exec() == QDialog::Accepted) + addToPlaylist(fileDialog.selectedUrls()); +} + +static bool isPlaylist(const QUrl &url) // Check for ".m3u" playlists. +{ + if (!url.isLocalFile()) + return false; + const QFileInfo fileInfo(url.toLocalFile()); + return fileInfo.exists() + && !fileInfo.suffix().compare(QLatin1String("m3u"), Qt::CaseInsensitive); +} + +void Player::addToPlaylist(const QList &urls) +{ + const int previousMediaCount = m_playlist->mediaCount(); + for (auto &url : urls) { + if (isPlaylist(url)) + m_playlist->load(url); + else + m_playlist->addMedia(url); + } + if (m_playlist->mediaCount() > previousMediaCount) { + auto index = m_playlistModel->index(previousMediaCount, 0); + if (m_playlistView) + m_playlistView->setCurrentIndex(index); + jump(index); + } +} + +void Player::durationChanged(qint64 duration) +{ + m_duration = duration / 1000; + m_slider->setMaximum(duration); +} + +void Player::positionChanged(qint64 progress) +{ + if (!m_slider->isSliderDown()) + m_slider->setValue(progress); + + updateDurationInfo(progress / 1000); +} + +void Player::metaDataChanged() +{ + auto metaData = m_player->metaData(); + setTrackInfo(metaData.value(QMediaMetaData::AlbumArtist).toString() + " - "_L1 + + metaData.value(QMediaMetaData::Title).toString()); + +#if !defined(Q_OS_ANDROID) && !defined(Q_OS_IOS) + for (int i = 0; i < QMediaMetaData::NumMetaData; i++) { + if (QLineEdit *field = qobject_cast(m_metaDataFields[i])) + field->clear(); + else if (QLabel *label = qobject_cast(m_metaDataFields[i])) + label->clear(); + m_metaDataFields[i]->setDisabled(true); + m_metaDataLabels[i]->setDisabled(true); + } + + for (auto &&[key, value] : metaData.asKeyValueRange()) { + int i = int(key); + if (key == QMediaMetaData::CoverArtImage) { + if (QLabel *cover = qobject_cast(m_metaDataFields[key])) { + QImage coverImage = value.value(); + cover->setPixmap(QPixmap::fromImage(coverImage)); + } + } else if (key == QMediaMetaData::ThumbnailImage) { + if (QLabel *thumbnail = qobject_cast(m_metaDataFields[key])) { + QImage thumbnailImage = value.value(); + thumbnail->setPixmap(QPixmap::fromImage(thumbnailImage)); + } + } else if (QLineEdit *field = qobject_cast(m_metaDataFields[key])) { + QString stringValue = metaData.stringValue(key); + field->setText(stringValue); + } + m_metaDataFields[i]->setDisabled(false); + m_metaDataLabels[i]->setDisabled(false); + } + + const QList tracks = m_player->videoTracks(); + const int currentVideoTrack = m_player->activeVideoTrack(); + if (currentVideoTrack >= 0 && currentVideoTrack < tracks.size()) { + const QMediaMetaData track = tracks.value(currentVideoTrack); + + const QList trackKeys = track.keys(); + for (const QMediaMetaData::Key &key : std::as_const(trackKeys)) { + if (QLineEdit *field = qobject_cast(m_metaDataFields[key])) { + QString stringValue = track.stringValue(key); + field->setText(stringValue); + } + m_metaDataFields[key]->setDisabled(true); + m_metaDataLabels[key]->setDisabled(true); + } + } +#endif +} + +QString Player::trackName(const QMediaMetaData &metaData, int index) +{ + QString name; + QString title = metaData.stringValue(QMediaMetaData::Title); + QLocale::Language lang = metaData.value(QMediaMetaData::Language).value(); + + if (title.isEmpty()) { + if (lang == QLocale::Language::AnyLanguage) + name = tr("Track %1").arg(index + 1); + else + name = QLocale::languageToString(lang); + } else { + if (lang == QLocale::Language::AnyLanguage) + name = title; + else + name = title + " - ["_L1 + QLocale::languageToString(lang) + u']'; + } + return name; +} + +void Player::tracksChanged() +{ + m_audioTracks->clear(); + m_videoTracks->clear(); + m_subtitleTracks->clear(); + + const auto audioTracks = m_player->audioTracks(); + m_audioTracks->addItem(u"No audio"_s, -1); + for (int i = 0; i < audioTracks.size(); ++i) + m_audioTracks->addItem(trackName(audioTracks.at(i), i), i); + m_audioTracks->setCurrentIndex(m_player->activeAudioTrack() + 1); + + const auto videoTracks = m_player->videoTracks(); + m_videoTracks->addItem(u"No video"_s, -1); + for (int i = 0; i < videoTracks.size(); ++i) + m_videoTracks->addItem(trackName(videoTracks.at(i), i), i); + m_videoTracks->setCurrentIndex(m_player->activeVideoTrack() + 1); + + m_subtitleTracks->addItem(u"No subtitles"_s, -1); + const auto subtitleTracks = m_player->subtitleTracks(); + for (int i = 0; i < subtitleTracks.size(); ++i) + m_subtitleTracks->addItem(trackName(subtitleTracks.at(i), i), i); + m_subtitleTracks->setCurrentIndex(m_player->activeSubtitleTrack() + 1); +} + +void Player::previousClicked() +{ + // Go to previous track if we are within the first 5 seconds of playback + // Otherwise, seek to the beginning. + if (m_player->position() <= 5000) { + m_playlist->previous(); + } else { + m_player->setPosition(0); + } +} + +void Player::jump(const QModelIndex &index) +{ + if (index.isValid()) { + m_playlist->setCurrentIndex(index.row()); + } +} + +void Player::playlistPositionChanged(int currentItem) +{ + if (m_playlistView) + m_playlistView->setCurrentIndex(m_playlistModel->index(currentItem, 0)); + m_player->setSource(m_playlist->currentMedia()); +} + +void Player::seek(int mseconds) +{ + m_player->setPosition(mseconds); +} + +void Player::statusChanged(QMediaPlayer::MediaStatus status) +{ + handleCursor(status); + + // handle status message + switch (status) { + case QMediaPlayer::NoMedia: + case QMediaPlayer::LoadedMedia: + setStatusInfo(QString()); + break; + case QMediaPlayer::LoadingMedia: + setStatusInfo(tr("Loading...")); + break; + case QMediaPlayer::BufferingMedia: + case QMediaPlayer::BufferedMedia: + setStatusInfo(tr("Buffering %1%").arg(qRound(m_player->bufferProgress() * 100.))); + break; + case QMediaPlayer::StalledMedia: + setStatusInfo(tr("Stalled %1%").arg(qRound(m_player->bufferProgress() * 100.))); + break; + case QMediaPlayer::EndOfMedia: + QApplication::alert(this); + m_playlist->next(); + break; + case QMediaPlayer::InvalidMedia: + displayErrorMessage(); + break; + } +} + +void Player::handleCursor(QMediaPlayer::MediaStatus status) +{ +#ifndef QT_NO_CURSOR + if (status == QMediaPlayer::LoadingMedia || status == QMediaPlayer::BufferingMedia + || status == QMediaPlayer::StalledMedia) + setCursor(QCursor(Qt::BusyCursor)); + else + unsetCursor(); +#endif +} + +void Player::bufferingProgress(float progress) +{ + if (m_player->mediaStatus() == QMediaPlayer::StalledMedia) + setStatusInfo(tr("Stalled %1%").arg(qRound(progress * 100.))); + else + setStatusInfo(tr("Buffering %1%").arg(qRound(progress * 100.))); +} + +void Player::videoAvailableChanged(bool available) +{ + if (!available) { + disconnect(m_fullScreenButton, &QPushButton::clicked, m_videoWidget, + &QVideoWidget::setFullScreen); + disconnect(m_videoWidget, &QVideoWidget::fullScreenChanged, m_fullScreenButton, + &QPushButton::setChecked); + m_videoWidget->setFullScreen(false); + } else { + connect(m_fullScreenButton, &QPushButton::clicked, m_videoWidget, + &QVideoWidget::setFullScreen); + connect(m_videoWidget, &QVideoWidget::fullScreenChanged, m_fullScreenButton, + &QPushButton::setChecked); + + if (m_fullScreenButton->isChecked()) + m_videoWidget->setFullScreen(true); + } +} + +void Player::selectAudioStream() +{ + int stream = m_audioTracks->currentData().toInt(); + m_player->setActiveAudioTrack(stream); +} + +void Player::selectVideoStream() +{ + int stream = m_videoTracks->currentData().toInt(); + m_player->setActiveVideoTrack(stream); +} + +void Player::selectSubtitleStream() +{ + int stream = m_subtitleTracks->currentData().toInt(); + m_player->setActiveSubtitleTrack(stream); +} + +void Player::setTrackInfo(const QString &info) +{ + m_trackInfo = info; + + if (m_statusBar) { + m_statusBar->showMessage(m_trackInfo); + m_statusLabel->setText(m_statusInfo); + } else { + if (!m_statusInfo.isEmpty()) + setWindowTitle(m_trackInfo + " | "_L1 + m_statusInfo); + else + setWindowTitle(m_trackInfo); + } +} + +void Player::setStatusInfo(const QString &info) +{ + m_statusInfo = info; + + if (m_statusBar) { + m_statusBar->showMessage(m_trackInfo); + m_statusLabel->setText(m_statusInfo); + } else { + if (!m_statusInfo.isEmpty()) + setWindowTitle(m_trackInfo + " | "_L1 + m_statusInfo); + else + setWindowTitle(m_trackInfo); + } +} + +void Player::displayErrorMessage() +{ + if (m_player->error() == QMediaPlayer::NoError) + return; + setStatusInfo(m_player->errorString()); +} + +void Player::updateDurationInfo(qint64 currentInfo) +{ + QString tStr; + if (currentInfo || m_duration) { + QTime currentTime((currentInfo / 3600) % 60, (currentInfo / 60) % 60, currentInfo % 60, + (currentInfo * 1000) % 1000); + QTime totalTime((m_duration / 3600) % 60, (m_duration / 60) % 60, m_duration % 60, + (m_duration * 1000) % 1000); + QString format = m_duration > 3600 ? u"hh:mm:ss"_s : u"mm:ss"_s; + tStr = currentTime.toString(format) + " / "_L1 + totalTime.toString(format); + } + m_labelDuration->setText(tStr); +} + +void Player::updateAudioDevices() +{ + m_audioOutputCombo->clear(); + + m_audioOutputCombo->addItem(u"Default"_s, QVariant::fromValue(QAudioDevice())); + for (auto &deviceInfo : QMediaDevices::audioOutputs()) + m_audioOutputCombo->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); +} + +void Player::audioOutputChanged(int index) +{ + auto device = m_audioOutputCombo->itemData(index).value(); + m_player->audioOutput()->setDevice(device); +} + +#include "moc_player.cpp" diff --git a/examples/multimedia/player/player.h b/examples/multimedia/player/player.h new file mode 100644 index 0000000..ff99299 --- /dev/null +++ b/examples/multimedia/player/player.h @@ -0,0 +1,110 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PLAYER_H +#define PLAYER_H + +#include "qmediaplaylist.h" + +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE +class QAbstractItemView; +class QLabel; +class QMediaPlayer; +class QModelIndex; +class QPushButton; +class QComboBox; +class QSlider; +class QStatusBar; +class QVideoWidget; +class QAudioBufferOutput; +QT_END_NAMESPACE + +class PlaylistModel; +class AudioLevelMeter; + +class Player : public QWidget +{ + Q_OBJECT + +public: + explicit Player(QWidget *parent = nullptr); + ~Player() override = default; + + bool isPlayerAvailable() const; + + void addToPlaylist(const QList &urls); + +signals: + void fullScreenChanged(bool fullScreen); + +private slots: + void open(); + void durationChanged(qint64 duration); + void positionChanged(qint64 progress); + void metaDataChanged(); + void tracksChanged(); + + void previousClicked(); + + void seek(int mseconds); + void jump(const QModelIndex &index); + void playlistPositionChanged(int); + + void statusChanged(QMediaPlayer::MediaStatus status); + void bufferingProgress(float progress); + void videoAvailableChanged(bool available); + + void selectAudioStream(); + void selectVideoStream(); + void selectSubtitleStream(); + + void displayErrorMessage(); + + void audioOutputChanged(int); + +private: + void setTrackInfo(const QString &info); + void setStatusInfo(const QString &info); + void handleCursor(QMediaPlayer::MediaStatus status); + void updateDurationInfo(qint64 currentInfo); + + void updateAudioDevices(); + + QString trackName(const QMediaMetaData &metaData, int index); + + QMediaPlayer *m_player = nullptr; + QAudioOutput *m_audioOutput = nullptr; + AudioLevelMeter *m_audioLevelMeter = nullptr; + QAudioBufferOutput *m_audioBufferOutput = nullptr; + QMediaPlaylist *m_playlist = nullptr; + QVideoWidget *m_videoWidget = nullptr; + QSlider *m_slider = nullptr; + QLabel *m_labelDuration = nullptr; + QPushButton *m_fullScreenButton = nullptr; + QPushButton *m_pitchCompensationButton = nullptr; + QComboBox *m_audioOutputCombo = nullptr; + QLabel *m_statusLabel = nullptr; + QStatusBar *m_statusBar = nullptr; + + QComboBox *m_audioTracks = nullptr; + QComboBox *m_videoTracks = nullptr; + QComboBox *m_subtitleTracks = nullptr; + + PlaylistModel *m_playlistModel = nullptr; + QAbstractItemView *m_playlistView = nullptr; + QString m_trackInfo; + QString m_statusInfo; + qint64 m_duration; + + QMediaDevices m_mediaDevices; + + QWidget *m_metaDataFields[QMediaMetaData::NumMetaData] = {}; + QLabel *m_metaDataLabels[QMediaMetaData::NumMetaData] = {}; +}; + +#endif // PLAYER_H diff --git a/examples/multimedia/player/player.pro b/examples/multimedia/player/player.pro new file mode 100644 index 0000000..1df3057 --- /dev/null +++ b/examples/multimedia/player/player.pro @@ -0,0 +1,32 @@ +TEMPLATE = app +TARGET = player + +QT += network \ + multimedia \ + multimediawidgets \ + widgets + +CONFIG += add_ios_ffmpeg_libraries + +HEADERS = \ + player.h \ + playercontrols.h \ + playlistmodel.h \ + videowidget.h \ + qmediaplaylist.h \ + qmediaplaylist_p.h \ + qplaylistfileparser.h \ + audiolevelmeter.h + +SOURCES = main.cpp \ + player.cpp \ + playercontrols.cpp \ + playlistmodel.cpp \ + videowidget.cpp \ + qmediaplaylist.cpp \ + qmediaplaylist_p.cpp \ + qplaylistfileparser.cpp \ + audiolevelmeter.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/player +INSTALLS += target diff --git a/examples/multimedia/player/playercontrols.cpp b/examples/multimedia/player/playercontrols.cpp new file mode 100644 index 0000000..2cc9629 --- /dev/null +++ b/examples/multimedia/player/playercontrols.cpp @@ -0,0 +1,172 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "playercontrols.h" + +#include +#include +#include +#include +#include +#include + +using namespace Qt::StringLiterals; + +PlayerControls::PlayerControls(QWidget *parent) : QWidget(parent) +{ + m_playButton = new QToolButton(this); + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + + connect(m_playButton, &QAbstractButton::clicked, this, &PlayerControls::playClicked); + + m_pauseButton = new QToolButton(this); + m_pauseButton->setIcon(style()->standardIcon(QStyle::SP_MediaPause)); + connect(m_pauseButton, &QAbstractButton::clicked, this, &PlayerControls::pauseClicked); + + m_stopButton = new QToolButton(this); + m_stopButton->setIcon(style()->standardIcon(QStyle::SP_MediaStop)); + connect(m_stopButton, &QAbstractButton::clicked, this, &PlayerControls::stop); + + m_nextButton = new QToolButton(this); + m_nextButton->setIcon(style()->standardIcon(QStyle::SP_MediaSkipForward)); + + connect(m_nextButton, &QAbstractButton::clicked, this, &PlayerControls::next); + + m_previousButton = new QToolButton(this); + m_previousButton->setIcon(style()->standardIcon(QStyle::SP_MediaSkipBackward)); + + connect(m_previousButton, &QAbstractButton::clicked, this, &PlayerControls::previous); + + m_muteButton = new QToolButton(this); + m_muteButton->setIcon(style()->standardIcon(QStyle::SP_MediaVolume)); + + connect(m_muteButton, &QAbstractButton::clicked, this, &PlayerControls::muteClicked); + + m_volumeSlider = new QSlider(Qt::Horizontal, this); + m_volumeSlider->setRange(0, 100); + QSizePolicy sp = m_volumeSlider->sizePolicy(); + sp.setHorizontalPolicy(QSizePolicy::MinimumExpanding); + m_volumeSlider->setSizePolicy(sp); + + connect(m_volumeSlider, &QSlider::valueChanged, this, + &PlayerControls::onVolumeSliderValueChanged); + + m_rateBox = new QComboBox(this); + m_rateBox->addItem(u"0.5x"_s, QVariant(0.5)); + m_rateBox->addItem(u"1.0x"_s, QVariant(1.0)); + m_rateBox->addItem(u"2.0x"_s, QVariant(2.0)); + m_rateBox->setCurrentIndex(1); + + connect(m_rateBox, &QComboBox::activated, this, &PlayerControls::updateRate); + + setState(QMediaPlayer::StoppedState, /*force=*/true); + + QBoxLayout *layout = new QHBoxLayout(this); + layout->setContentsMargins(0, 0, 0, 0); + layout->addWidget(m_stopButton); + layout->addWidget(m_previousButton); + layout->addWidget(m_pauseButton); + layout->addWidget(m_playButton); + layout->addWidget(m_nextButton); + layout->addWidget(m_muteButton); + layout->addWidget(m_volumeSlider); + layout->addWidget(m_rateBox); +} + +QMediaPlayer::PlaybackState PlayerControls::state() const +{ + return m_playerState; +} + +void PlayerControls::setState(QMediaPlayer::PlaybackState state, bool force) +{ + if (state != m_playerState || force) { + m_playerState = state; + + QColor baseColor = palette().color(QPalette::Base); + QString inactiveStyleSheet = "background-color: "_L1 + baseColor.name(); + QString defaultStyleSheet = QString(); + + switch (state) { + case QMediaPlayer::StoppedState: + m_stopButton->setStyleSheet(inactiveStyleSheet); + m_playButton->setStyleSheet(defaultStyleSheet); + m_pauseButton->setStyleSheet(defaultStyleSheet); + break; + case QMediaPlayer::PlayingState: + m_stopButton->setStyleSheet(defaultStyleSheet); + m_playButton->setStyleSheet(inactiveStyleSheet); + m_pauseButton->setStyleSheet(defaultStyleSheet); + break; + case QMediaPlayer::PausedState: + m_stopButton->setStyleSheet(defaultStyleSheet); + m_playButton->setStyleSheet(defaultStyleSheet); + m_pauseButton->setStyleSheet(inactiveStyleSheet); + break; + } + } +} + +float PlayerControls::volume() const +{ + qreal linearVolume = + QtAudio::convertVolume(m_volumeSlider->value() / qreal(100), + QtAudio::LogarithmicVolumeScale, QtAudio::LinearVolumeScale); + + return linearVolume; +} + +void PlayerControls::setVolume(float volume) +{ + qreal logarithmicVolume = QtAudio::convertVolume(volume, QtAudio::LinearVolumeScale, + QtAudio::LogarithmicVolumeScale); + + m_volumeSlider->setValue(qRound(logarithmicVolume * 100)); +} + +bool PlayerControls::isMuted() const +{ + return m_playerMuted; +} + +void PlayerControls::setMuted(bool muted) +{ + if (muted != m_playerMuted) { + m_playerMuted = muted; + + m_muteButton->setIcon(style()->standardIcon(muted ? QStyle::SP_MediaVolumeMuted + : QStyle::SP_MediaVolume)); + } +} + +void PlayerControls::playClicked() +{ + emit play(); +} + +void PlayerControls::pauseClicked() +{ + emit pause(); +} + +void PlayerControls::muteClicked() +{ + emit changeMuting(!m_playerMuted); +} + +qreal PlayerControls::playbackRate() const +{ + return m_rateBox->itemData(m_rateBox->currentIndex()).toDouble(); +} + +void PlayerControls::updateRate() +{ + emit changeRate(playbackRate()); +} + +void PlayerControls::onVolumeSliderValueChanged() +{ + emit changeVolume(volume()); +} + +#include "moc_playercontrols.cpp" diff --git a/examples/multimedia/player/playercontrols.h b/examples/multimedia/player/playercontrols.h new file mode 100644 index 0000000..4b280be --- /dev/null +++ b/examples/multimedia/player/playercontrols.h @@ -0,0 +1,63 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PLAYERCONTROLS_H +#define PLAYERCONTROLS_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QAbstractButton; +class QAbstractSlider; +class QComboBox; +QT_END_NAMESPACE + +class PlayerControls : public QWidget +{ + Q_OBJECT + +public: + explicit PlayerControls(QWidget *parent = nullptr); + + QMediaPlayer::PlaybackState state() const; + float volume() const; + bool isMuted() const; + qreal playbackRate() const; + +public slots: + void setState(QMediaPlayer::PlaybackState state, bool force = false); + void setVolume(float volume); + void setMuted(bool muted); + +signals: + void play(); + void pause(); + void stop(); + void next(); + void previous(); + void changeVolume(float volume); + void changeMuting(bool muting); + void changeRate(qreal rate); + +private slots: + void playClicked(); + void pauseClicked(); + void muteClicked(); + void updateRate(); + void onVolumeSliderValueChanged(); + +private: + QMediaPlayer::PlaybackState m_playerState = QMediaPlayer::StoppedState; + bool m_playerMuted = false; + QAbstractButton *m_playButton = nullptr; + QAbstractButton *m_pauseButton = nullptr; + QAbstractButton *m_stopButton = nullptr; + QAbstractButton *m_nextButton = nullptr; + QAbstractButton *m_previousButton = nullptr; + QAbstractButton *m_muteButton = nullptr; + QAbstractSlider *m_volumeSlider = nullptr; + QComboBox *m_rateBox = nullptr; +}; + +#endif // PLAYERCONTROLS_H diff --git a/examples/multimedia/player/playlistmodel.cpp b/examples/multimedia/player/playlistmodel.cpp new file mode 100644 index 0000000..a49c7c8 --- /dev/null +++ b/examples/multimedia/player/playlistmodel.cpp @@ -0,0 +1,105 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "playlistmodel.h" +#include "qmediaplaylist.h" + +#include +#include + +PlaylistModel::PlaylistModel(QObject *parent) : + QAbstractItemModel(parent), + m_playlist(std::make_unique()) +{ + connect(m_playlist.get(), &QMediaPlaylist::mediaAboutToBeInserted, this, + &PlaylistModel::beginInsertItems); + connect(m_playlist.get(), &QMediaPlaylist::mediaInserted, this, &PlaylistModel::endInsertItems); + connect(m_playlist.get(), &QMediaPlaylist::mediaAboutToBeRemoved, this, + &PlaylistModel::beginRemoveItems); + connect(m_playlist.get(), &QMediaPlaylist::mediaRemoved, this, &PlaylistModel::endRemoveItems); + connect(m_playlist.get(), &QMediaPlaylist::mediaChanged, this, &PlaylistModel::changeItems); +} + +PlaylistModel::~PlaylistModel() = default; + +int PlaylistModel::rowCount(const QModelIndex &parent) const +{ + return m_playlist && !parent.isValid() ? m_playlist->mediaCount() : 0; +} + +int PlaylistModel::columnCount(const QModelIndex &parent) const +{ + return !parent.isValid() ? ColumnCount : 0; +} + +QModelIndex PlaylistModel::index(int row, int column, const QModelIndex &parent) const +{ + return m_playlist && !parent.isValid() && row >= 0 && row < m_playlist->mediaCount() + && column >= 0 && column < ColumnCount + ? createIndex(row, column) + : QModelIndex(); +} + +QModelIndex PlaylistModel::parent(const QModelIndex &child) const +{ + Q_UNUSED(child); + + return {}; +} + +QVariant PlaylistModel::data(const QModelIndex &index, int role) const +{ + if (index.isValid() && role == Qt::DisplayRole) { + QVariant value = m_data[index]; + if (!value.isValid() && index.column() == Title) { + QUrl location = m_playlist->media(index.row()); + return QFileInfo(location.path()).fileName(); + } + + return value; + } + return {}; +} + +QMediaPlaylist *PlaylistModel::playlist() const +{ + return m_playlist.get(); +} + +bool PlaylistModel::setData(const QModelIndex &index, const QVariant &value, int role) +{ + Q_UNUSED(role); + m_data[index] = value; + emit dataChanged(index, index); + return true; +} + +void PlaylistModel::beginInsertItems(int start, int end) +{ + m_data.clear(); + beginInsertRows(QModelIndex(), start, end); +} + +void PlaylistModel::endInsertItems() +{ + endInsertRows(); +} + +void PlaylistModel::beginRemoveItems(int start, int end) +{ + m_data.clear(); + beginRemoveRows(QModelIndex(), start, end); +} + +void PlaylistModel::endRemoveItems() +{ + endInsertRows(); +} + +void PlaylistModel::changeItems(int start, int end) +{ + m_data.clear(); + emit dataChanged(index(start, 0), index(end, ColumnCount)); +} + +#include "moc_playlistmodel.cpp" diff --git a/examples/multimedia/player/playlistmodel.h b/examples/multimedia/player/playlistmodel.h new file mode 100644 index 0000000..69ef8b9 --- /dev/null +++ b/examples/multimedia/player/playlistmodel.h @@ -0,0 +1,53 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PLAYLISTMODEL_H +#define PLAYLISTMODEL_H + +#include +#include +#include + +#include + +QT_BEGIN_NAMESPACE +class QMediaPlaylist; +QT_END_NAMESPACE + +class PlaylistModel : public QAbstractItemModel +{ + Q_OBJECT + +public: + enum Column { Title = 0, ColumnCount }; + + explicit PlaylistModel(QObject *parent = nullptr); + ~PlaylistModel(); + + int rowCount(const QModelIndex &parent = QModelIndex()) const override; + int columnCount(const QModelIndex &parent = QModelIndex()) const override; + + QModelIndex index(int row, int column, + const QModelIndex &parent = QModelIndex()) const override; + QModelIndex parent(const QModelIndex &child) const override; + + QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; + + QMediaPlaylist *playlist() const; + + bool setData(const QModelIndex &index, const QVariant &value, + int role = Qt::DisplayRole) override; + +private slots: + void beginInsertItems(int start, int end); + void endInsertItems(); + void beginRemoveItems(int start, int end); + void endRemoveItems(); + void changeItems(int start, int end); + +private: + std::unique_ptr m_playlist; + QMap m_data; +}; + +#endif // PLAYLISTMODEL_H diff --git a/examples/multimedia/player/qmediaplaylist.cpp b/examples/multimedia/player/qmediaplaylist.cpp new file mode 100644 index 0000000..739dd1c --- /dev/null +++ b/examples/multimedia/player/qmediaplaylist.cpp @@ -0,0 +1,643 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "qmediaplaylist.h" +#include "qmediaplaylist_p.h" +#include "qplaylistfileparser.h" + +#include +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE + +class QM3uPlaylistWriter +{ +public: + QM3uPlaylistWriter(QIODevice *device) + : m_device(device), m_textStream(new QTextStream(m_device)) + { + } + + ~QM3uPlaylistWriter() { delete m_textStream; } + + bool writeItem(const QUrl &item) + { + *m_textStream << item.toString() << Qt::endl; + return true; + } + +private: + QIODevice *m_device; + QTextStream *m_textStream; +}; + +int QMediaPlaylistPrivate::nextPosition(int steps) const +{ + if (playlist.count() == 0) + return -1; + + int next = currentPos + steps; + + switch (playbackMode) { + case QMediaPlaylist::CurrentItemOnce: + return steps != 0 ? -1 : currentPos; + case QMediaPlaylist::CurrentItemInLoop: + return currentPos; + case QMediaPlaylist::Sequential: + if (next >= playlist.size()) + next = 0; + break; + case QMediaPlaylist::Loop: + next %= playlist.count(); + break; + } + + return next; +} + +int QMediaPlaylistPrivate::prevPosition(int steps) const +{ + if (playlist.count() == 0) + return -1; + + int next = currentPos; + if (next < 0) + next = playlist.size(); + next -= steps; + + switch (playbackMode) { + case QMediaPlaylist::CurrentItemOnce: + return steps != 0 ? -1 : currentPos; + case QMediaPlaylist::CurrentItemInLoop: + return currentPos; + case QMediaPlaylist::Sequential: + if (next < 0) + next = playlist.size() - 1; + break; + case QMediaPlaylist::Loop: + next %= playlist.size(); + if (next < 0) + next += playlist.size(); + break; + } + + return next; +} + +/*! + \class QMediaPlaylist + \inmodule QtMultimedia + \ingroup multimedia + \ingroup multimedia_playback + + + \brief The QMediaPlaylist class provides a list of media content to play. + + QMediaPlaylist is intended to be used with other media objects, + like QMediaPlayer. + + QMediaPlaylist allows to access the service intrinsic playlist functionality + if available, otherwise it provides the local memory playlist implementation. + + \snippet multimedia-snippets/media.cpp Movie playlist + + Depending on playlist source implementation, most of the playlist mutating + operations can be asynchronous. + + QMediaPlayList currently supports M3U playlists (file extension .m3u and .m3u8). + + \sa QUrl +*/ + +/*! + \enum QMediaPlaylist::PlaybackMode + + The QMediaPlaylist::PlaybackMode describes the order items in playlist are played. + + \value CurrentItemOnce The current item is played only once. + + \value CurrentItemInLoop The current item is played repeatedly in a loop. + + \value Sequential Playback starts from the current and moves through each successive + item until the last is reached and then stops. The next item is a null item when the last one is + currently playing. + + \value Loop Playback restarts at the first item after the last has finished + playing. + + \value Random Play items in random order. +*/ + +/*! + Create a new playlist object with the given \a parent. +*/ + +QMediaPlaylist::QMediaPlaylist(QObject *parent) : QObject(parent), d_ptr(new QMediaPlaylistPrivate) +{ + Q_D(QMediaPlaylist); + + d->q_ptr = this; +} + +/*! + Destroys the playlist. + */ + +QMediaPlaylist::~QMediaPlaylist() +{ + delete d_ptr; +} + +/*! + \property QMediaPlaylist::playbackMode + + This property defines the order that items in the playlist are played. + + \sa QMediaPlaylist::PlaybackMode +*/ + +QMediaPlaylist::PlaybackMode QMediaPlaylist::playbackMode() const +{ + return d_func()->playbackMode; +} + +void QMediaPlaylist::setPlaybackMode(QMediaPlaylist::PlaybackMode mode) +{ + Q_D(QMediaPlaylist); + + if (mode == d->playbackMode) + return; + + d->playbackMode = mode; + + emit playbackModeChanged(mode); +} + +/*! + Returns position of the current media content in the playlist. +*/ +int QMediaPlaylist::currentIndex() const +{ + return d_func()->currentPos; +} + +/*! + Returns the current media content. +*/ + +QUrl QMediaPlaylist::currentMedia() const +{ + Q_D(const QMediaPlaylist); + if (d->currentPos < 0 || d->currentPos >= d->playlist.size()) + return QUrl(); + return d_func()->playlist.at(d_func()->currentPos); +} + +/*! + Returns the index of the item, which would be current after calling next() + \a steps times. + + Returned value depends on the size of playlist, current position + and playback mode. + + \sa QMediaPlaylist::playbackMode(), previousIndex() +*/ +int QMediaPlaylist::nextIndex(int steps) const +{ + return d_func()->nextPosition(steps); +} + +/*! + Returns the index of the item, which would be current after calling previous() + \a steps times. + + \sa QMediaPlaylist::playbackMode(), nextIndex() +*/ + +int QMediaPlaylist::previousIndex(int steps) const +{ + return d_func()->prevPosition(steps); +} + +/*! + Returns the number of items in the playlist. + + \sa isEmpty() + */ +int QMediaPlaylist::mediaCount() const +{ + return d_func()->playlist.count(); +} + +/*! + Returns true if the playlist contains no items, otherwise returns false. + + \sa mediaCount() + */ +bool QMediaPlaylist::isEmpty() const +{ + return mediaCount() == 0; +} + +/*! + Returns the media content at \a index in the playlist. +*/ + +QUrl QMediaPlaylist::media(int index) const +{ + Q_D(const QMediaPlaylist); + if (index < 0 || index >= d->playlist.size()) + return QUrl(); + return d->playlist.at(index); +} + +/*! + Append the media \a content to the playlist. + + Returns true if the operation is successful, otherwise returns false. + */ +void QMediaPlaylist::addMedia(const QUrl &content) +{ + Q_D(QMediaPlaylist); + int pos = d->playlist.size(); + emit mediaAboutToBeInserted(pos, pos); + d->playlist.append(content); + emit mediaInserted(pos, pos); +} + +/*! + Append multiple media content \a items to the playlist. + + Returns true if the operation is successful, otherwise returns false. + */ +void QMediaPlaylist::addMedia(const QList &items) +{ + if (!items.size()) + return; + + Q_D(QMediaPlaylist); + int first = d->playlist.size(); + int last = first + items.size() - 1; + emit mediaAboutToBeInserted(first, last); + d_func()->playlist.append(items); + emit mediaInserted(first, last); +} + +/*! + Insert the media \a content to the playlist at position \a pos. + + Returns true if the operation is successful, otherwise returns false. +*/ + +bool QMediaPlaylist::insertMedia(int pos, const QUrl &content) +{ + Q_D(QMediaPlaylist); + pos = qBound(0, pos, d->playlist.size()); + emit mediaAboutToBeInserted(pos, pos); + d->playlist.insert(pos, content); + emit mediaInserted(pos, pos); + return true; +} + +/*! + Insert multiple media content \a items to the playlist at position \a pos. + + Returns true if the operation is successful, otherwise returns false. +*/ + +bool QMediaPlaylist::insertMedia(int pos, const QList &items) +{ + if (!items.size()) + return true; + + Q_D(QMediaPlaylist); + pos = qBound(0, pos, d->playlist.size()); + int last = pos + items.size() - 1; + emit mediaAboutToBeInserted(pos, last); + auto newList = d->playlist.mid(0, pos); + newList += items; + newList += d->playlist.mid(pos); + d->playlist = newList; + emit mediaInserted(pos, last); + return true; +} + +/*! + Move the item from position \a from to position \a to. + + Returns true if the operation is successful, otherwise false. + + \since 5.7 +*/ +bool QMediaPlaylist::moveMedia(int from, int to) +{ + Q_D(QMediaPlaylist); + if (from < 0 || from > d->playlist.count() || to < 0 || to > d->playlist.count()) + return false; + + d->playlist.move(from, to); + emit mediaChanged(from, to); + return true; +} + +/*! + Remove the item from the playlist at position \a pos. + + Returns true if the operation is successful, otherwise return false. + */ +bool QMediaPlaylist::removeMedia(int pos) +{ + return removeMedia(pos, pos); +} + +/*! + Remove items in the playlist from \a start to \a end inclusive. + + Returns true if the operation is successful, otherwise return false. + */ +bool QMediaPlaylist::removeMedia(int start, int end) +{ + Q_D(QMediaPlaylist); + if (end < start || end < 0 || start >= d->playlist.count()) + return false; + start = qBound(0, start, d->playlist.size() - 1); + end = qBound(0, end, d->playlist.size() - 1); + + emit mediaAboutToBeRemoved(start, end); + d->playlist.remove(start, end - start + 1); + emit mediaRemoved(start, end); + return true; +} + +/*! + Remove all the items from the playlist. + + Returns true if the operation is successful, otherwise return false. + */ +void QMediaPlaylist::clear() +{ + Q_D(QMediaPlaylist); + int size = d->playlist.size(); + emit mediaAboutToBeRemoved(0, size - 1); + d->playlist.clear(); + emit mediaRemoved(0, size - 1); +} + +/*! + Load playlist from \a location. If \a format is specified, it is used, + otherwise format is guessed from location name and data. + + New items are appended to playlist. + + QMediaPlaylist::loaded() signal is emitted if playlist was loaded successfully, + otherwise the playlist emits loadFailed(). +*/ + +void QMediaPlaylist::load(const QUrl &location, const char *format) +{ + Q_D(QMediaPlaylist); + + d->error = NoError; + d->errorString.clear(); + + d->ensureParser(); + d->parser->start(location, QString::fromUtf8(format)); +} + +/*! + Load playlist from QIODevice \a device. If \a format is specified, it is used, + otherwise format is guessed from device data. + + New items are appended to playlist. + + QMediaPlaylist::loaded() signal is emitted if playlist was loaded successfully, + otherwise the playlist emits loadFailed(). +*/ +void QMediaPlaylist::load(QIODevice *device, const char *format) +{ + Q_D(QMediaPlaylist); + + d->error = NoError; + d->errorString.clear(); + + d->ensureParser(); + d->parser->start(device, QString::fromUtf8(format)); +} + +/*! + Save playlist to \a location. If \a format is specified, it is used, + otherwise format is guessed from location name. + + Returns true if playlist was saved successfully, otherwise returns false. + */ +bool QMediaPlaylist::save(const QUrl &location, const char *format) const +{ + Q_D(const QMediaPlaylist); + + d->error = NoError; + d->errorString.clear(); + + if (!d->checkFormat(format)) + return false; + + QFile file(location.toLocalFile()); + + if (!file.open(QIODevice::WriteOnly | QIODevice::Truncate)) { + d->error = AccessDeniedError; + d->errorString = tr("The file could not be accessed."); + return false; + } + + return save(&file, format); +} + +/*! + Save playlist to QIODevice \a device using format \a format. + + Returns true if playlist was saved successfully, otherwise returns false. +*/ +bool QMediaPlaylist::save(QIODevice *device, const char *format) const +{ + Q_D(const QMediaPlaylist); + + d->error = NoError; + d->errorString.clear(); + + if (!d->checkFormat(format)) + return false; + + QM3uPlaylistWriter writer(device); + for (const auto &entry : d->playlist) + writer.writeItem(entry); + return true; +} + +/*! + Returns the last error condition. +*/ +QMediaPlaylist::Error QMediaPlaylist::error() const +{ + return d_func()->error; +} + +/*! + Returns the string describing the last error condition. +*/ +QString QMediaPlaylist::errorString() const +{ + return d_func()->errorString; +} + +/*! + Shuffle items in the playlist. +*/ +void QMediaPlaylist::shuffle() +{ + Q_D(QMediaPlaylist); + QList playlist; + + // keep the current item when shuffling + QUrl current; + if (d->currentPos != -1) + current = d->playlist.takeAt(d->currentPos); + + while (!d->playlist.isEmpty()) + playlist.append( + d->playlist.takeAt(QRandomGenerator::global()->bounded(int(d->playlist.size())))); + + if (d->currentPos != -1) + playlist.insert(d->currentPos, current); + d->playlist = playlist; + emit mediaChanged(0, d->playlist.count()); +} + +/*! + Advance to the next media content in playlist. +*/ +void QMediaPlaylist::next() +{ + Q_D(QMediaPlaylist); + d->currentPos = d->nextPosition(1); + + emit currentIndexChanged(d->currentPos); + emit currentMediaChanged(currentMedia()); +} + +/*! + Return to the previous media content in playlist. +*/ +void QMediaPlaylist::previous() +{ + Q_D(QMediaPlaylist); + d->currentPos = d->prevPosition(1); + + emit currentIndexChanged(d->currentPos); + emit currentMediaChanged(currentMedia()); +} + +/*! + Activate media content from playlist at position \a playlistPosition. +*/ + +void QMediaPlaylist::setCurrentIndex(int playlistPosition) +{ + Q_D(QMediaPlaylist); + if (playlistPosition < 0 || playlistPosition >= d->playlist.size()) + playlistPosition = -1; + d->currentPos = playlistPosition; + + emit currentIndexChanged(d->currentPos); + emit currentMediaChanged(currentMedia()); +} + +/*! + \fn void QMediaPlaylist::mediaInserted(int start, int end) + + This signal is emitted after media has been inserted into the playlist. + The new items are those between \a start and \a end inclusive. + */ + +/*! + \fn void QMediaPlaylist::mediaRemoved(int start, int end) + + This signal is emitted after media has been removed from the playlist. + The removed items are those between \a start and \a end inclusive. + */ + +/*! + \fn void QMediaPlaylist::mediaChanged(int start, int end) + + This signal is emitted after media has been changed in the playlist + between \a start and \a end positions inclusive. + */ + +/*! + \fn void QMediaPlaylist::currentIndexChanged(int position) + + Signal emitted when playlist position changed to \a position. +*/ + +/*! + \fn void QMediaPlaylist::playbackModeChanged(QMediaPlaylist::PlaybackMode mode) + + Signal emitted when playback mode changed to \a mode. +*/ + +/*! + \fn void QMediaPlaylist::mediaAboutToBeInserted(int start, int end) + + Signal emitted when items are to be inserted at \a start and ending at \a end. +*/ + +/*! + \fn void QMediaPlaylist::mediaAboutToBeRemoved(int start, int end) + + Signal emitted when item are to be deleted at \a start and ending at \a end. +*/ + +/*! + \fn void QMediaPlaylist::currentMediaChanged(const QUrl &content) + + Signal emitted when current media changes to \a content. +*/ + +/*! + \property QMediaPlaylist::currentIndex + \brief Current position. +*/ + +/*! + \property QMediaPlaylist::currentMedia + \brief Current media content. +*/ + +/*! + \fn QMediaPlaylist::loaded() + + Signal emitted when playlist finished loading. +*/ + +/*! + \fn QMediaPlaylist::loadFailed() + + Signal emitted if failed to load playlist. +*/ + +/*! + \enum QMediaPlaylist::Error + + This enum describes the QMediaPlaylist error codes. + + \value NoError No errors. + \value FormatError Format error. + \value FormatNotSupportedError Format not supported. + \value NetworkError Network error. + \value AccessDeniedError Access denied error. +*/ + +QT_END_NAMESPACE + +#include "moc_qmediaplaylist.cpp" diff --git a/examples/multimedia/player/qmediaplaylist.h b/examples/multimedia/player/qmediaplaylist.h new file mode 100644 index 0000000..d677753 --- /dev/null +++ b/examples/multimedia/player/qmediaplaylist.h @@ -0,0 +1,90 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef QMEDIAPLAYLIST_H +#define QMEDIAPLAYLIST_H + +#include + +QT_BEGIN_NAMESPACE + +class QMediaPlaylistPrivate; +class QMediaPlaylist : public QObject +{ + Q_OBJECT + Q_PROPERTY(QMediaPlaylist::PlaybackMode playbackMode READ playbackMode WRITE setPlaybackMode + NOTIFY playbackModeChanged) + Q_PROPERTY(QUrl currentMedia READ currentMedia NOTIFY currentMediaChanged) + Q_PROPERTY(int currentIndex READ currentIndex WRITE setCurrentIndex NOTIFY currentIndexChanged) + +public: + enum PlaybackMode { CurrentItemOnce, CurrentItemInLoop, Sequential, Loop }; + Q_ENUM(PlaybackMode) + enum Error { NoError, FormatError, FormatNotSupportedError, NetworkError, AccessDeniedError }; + Q_ENUM(Error) + + explicit QMediaPlaylist(QObject *parent = nullptr); + virtual ~QMediaPlaylist(); + + PlaybackMode playbackMode() const; + void setPlaybackMode(PlaybackMode mode); + + int currentIndex() const; + QUrl currentMedia() const; + + int nextIndex(int steps = 1) const; + int previousIndex(int steps = 1) const; + + QUrl media(int index) const; + + int mediaCount() const; + bool isEmpty() const; + + void addMedia(const QUrl &content); + void addMedia(const QList &items); + bool insertMedia(int index, const QUrl &content); + bool insertMedia(int index, const QList &items); + bool moveMedia(int from, int to); + bool removeMedia(int pos); + bool removeMedia(int start, int end); + void clear(); + + void load(const QUrl &location, const char *format = nullptr); + void load(QIODevice *device, const char *format = nullptr); + + bool save(const QUrl &location, const char *format = nullptr) const; + bool save(QIODevice *device, const char *format) const; + + Error error() const; + QString errorString() const; + +public slots: + void shuffle(); + + void next(); + void previous(); + + void setCurrentIndex(int index); + +signals: + void currentIndexChanged(int index); + void playbackModeChanged(QMediaPlaylist::PlaybackMode mode); + void currentMediaChanged(const QUrl &); + + void mediaAboutToBeInserted(int start, int end); + void mediaInserted(int start, int end); + void mediaAboutToBeRemoved(int start, int end); + void mediaRemoved(int start, int end); + void mediaChanged(int start, int end); + + void loaded(); + void loadFailed(); + +private: + QMediaPlaylistPrivate *d_ptr = nullptr; + Q_DECLARE_PRIVATE(QMediaPlaylist) +}; + +QT_END_NAMESPACE + +#endif // QMEDIAPLAYLIST_H diff --git a/examples/multimedia/player/qmediaplaylist_p.cpp b/examples/multimedia/player/qmediaplaylist_p.cpp new file mode 100644 index 0000000..13e1644 --- /dev/null +++ b/examples/multimedia/player/qmediaplaylist_p.cpp @@ -0,0 +1,65 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "qmediaplaylist_p.h" + +QT_BEGIN_NAMESPACE + +QMediaPlaylistPrivate::QMediaPlaylistPrivate() : error(QMediaPlaylist::NoError) { } + +QMediaPlaylistPrivate::~QMediaPlaylistPrivate() +{ + delete parser; +} + +void QMediaPlaylistPrivate::loadFailed(QMediaPlaylist::Error error, const QString &errorString) +{ + this->error = error; + this->errorString = errorString; + + emit q_ptr->loadFailed(); +} + +void QMediaPlaylistPrivate::loadFinished() +{ + q_ptr->addMedia(parser->playlist); + + emit q_ptr->loaded(); +} + +bool QMediaPlaylistPrivate::checkFormat(const char *format) const +{ + QLatin1String f(format); + QPlaylistFileParser::FileType type = + format ? QPlaylistFileParser::UNKNOWN : QPlaylistFileParser::M3U8; + if (format) { + if (f == QLatin1String("m3u") || f == QLatin1String("text/uri-list") + || f == QLatin1String("audio/x-mpegurl") || f == QLatin1String("audio/mpegurl")) + type = QPlaylistFileParser::M3U; + else if (f == QLatin1String("m3u8") || f == QLatin1String("application/x-mpegURL") + || f == QLatin1String("application/vnd.apple.mpegurl")) + type = QPlaylistFileParser::M3U8; + } + + if (type == QPlaylistFileParser::UNKNOWN || type == QPlaylistFileParser::PLS) { + error = QMediaPlaylist::FormatNotSupportedError; + errorString = QMediaPlaylist::tr("This file format is not supported."); + return false; + } + return true; +} + +void QMediaPlaylistPrivate::ensureParser() +{ + if (parser) + return; + + parser = new QPlaylistFileParser(q_ptr); + QObject::connect(parser, &QPlaylistFileParser::finished, q_ptr, [this]() { loadFinished(); }); + QObject::connect(parser, &QPlaylistFileParser::error, q_ptr, + [this](QMediaPlaylist::Error err, const QString &errorMsg) { + loadFailed(err, errorMsg); + }); +} + +QT_END_NAMESPACE diff --git a/examples/multimedia/player/qmediaplaylist_p.h b/examples/multimedia/player/qmediaplaylist_p.h new file mode 100644 index 0000000..9755526 --- /dev/null +++ b/examples/multimedia/player/qmediaplaylist_p.h @@ -0,0 +1,66 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef QMEDIAPLAYLIST_P_H +#define QMEDIAPLAYLIST_P_H + +// +// W A R N I N G +// ------------- +// +// This file is not part of the Qt API. It exists purely as an +// implementation detail. This header file may change from version to +// version without notice, or even be removed. +// +// We mean it. +// + +#include "qmediaplaylist.h" +#include "qplaylistfileparser.h" + +#include + +#include + +#ifdef Q_MOC_RUN +# pragma Q_MOC_EXPAND_MACROS +#endif + +QT_BEGIN_NAMESPACE + +class QMediaPlaylistControl; + +class QMediaPlaylistPrivate +{ + Q_DECLARE_PUBLIC(QMediaPlaylist) +public: + QMediaPlaylistPrivate(); + + virtual ~QMediaPlaylistPrivate(); + + void loadFailed(QMediaPlaylist::Error error, const QString &errorString); + + void loadFinished(); + + bool checkFormat(const char *format) const; + + void ensureParser(); + + int nextPosition(int steps) const; + int prevPosition(int steps) const; + + QList playlist; + + int currentPos = -1; + QMediaPlaylist::PlaybackMode playbackMode = QMediaPlaylist::Sequential; + + QPlaylistFileParser *parser = nullptr; + mutable QMediaPlaylist::Error error; + mutable QString errorString; + + QMediaPlaylist *q_ptr = nullptr; +}; + +QT_END_NAMESPACE + +#endif // QMEDIAPLAYLIST_P_H diff --git a/examples/multimedia/player/qplaylistfileparser.cpp b/examples/multimedia/player/qplaylistfileparser.cpp new file mode 100644 index 0000000..32195c8 --- /dev/null +++ b/examples/multimedia/player/qplaylistfileparser.cpp @@ -0,0 +1,623 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause +// Qt-Security score:critical reason:data-parser + +#include "qmediametadata.h" +#include "qmediaplayer.h" +#include "qplaylistfileparser.h" + +#include +#include +#include +#include +#include +#include + +#include + +QT_BEGIN_NAMESPACE + +namespace { + +class ParserBase +{ +public: + explicit ParserBase(QPlaylistFileParser *parent) : m_parent(parent), m_aborted(false) + { + Q_ASSERT(m_parent); + } + + bool parseLine(int lineIndex, const QString &line, const QUrl &root) + { + if (m_aborted) + return false; + + const bool ok = parseLineImpl(lineIndex, line, root); + return ok && !m_aborted; + } + + virtual void abort() { m_aborted = true; } + virtual ~ParserBase() = default; + +protected: + virtual bool parseLineImpl(int lineIndex, const QString &line, const QUrl &root) = 0; + + static QUrl expandToFullPath(const QUrl &root, const QString &line) + { + // On Linux, backslashes are not converted to forward slashes :/ + if (line.startsWith(QLatin1String("//")) || line.startsWith(QLatin1String("\\\\"))) { + // Network share paths are not resolved + return QUrl::fromLocalFile(line); + } + + QUrl url(line); + if (url.scheme().isEmpty()) { + // Resolve it relative to root + if (root.isLocalFile()) + return QUrl::fromUserInput(line, root.adjusted(QUrl::RemoveFilename).toLocalFile(), + QUrl::AssumeLocalFile); + return root.resolved(url); + } + if (url.scheme().length() == 1) + // Assume it's a drive letter for a Windows path + url = QUrl::fromLocalFile(line); + + return url; + } + + void newItemFound(const QVariant &content) { Q_EMIT m_parent->newItem(content); } + + QPlaylistFileParser *m_parent; + bool m_aborted; +}; + +class M3UParser : public ParserBase +{ +public: + explicit M3UParser(QPlaylistFileParser *q) : ParserBase(q), m_extendedFormat(false) { } + + /* + * + Extended M3U directives + + #EXTM3U - header - must be first line of file + #EXTINF - extra info - length (seconds), title + #EXTINF - extra info - length (seconds), artist '-' title + + Example + + #EXTM3U + #EXTINF:123, Sample artist - Sample title + C:\Documents and Settings\I\My Music\Sample.mp3 + #EXTINF:321,Example Artist - Example title + C:\Documents and Settings\I\My Music\Greatest Hits\Example.ogg + + */ + bool parseLineImpl(int lineIndex, const QString &line, const QUrl &root) override + { + if (line[0] == u'#') { + if (m_extendedFormat) { + if (line.startsWith(QLatin1String("#EXTINF:"))) { + m_extraInfo.clear(); + int artistStart = line.indexOf(QLatin1String(","), 8); + bool ok = false; + QStringView lineView{ line }; + int length = lineView.mid(8, artistStart < 8 ? -1 : artistStart - 8) + .trimmed() + .toInt(&ok); + if (ok && length > 0) { + // convert from second to milisecond + m_extraInfo[QMediaMetaData::Duration] = QVariant(length * 1000); + } + if (artistStart > 0) { + int titleStart = getSplitIndex(line, artistStart); + if (titleStart > artistStart) { + m_extraInfo[QMediaMetaData::Author] = + lineView.mid(artistStart + 1, titleStart - artistStart - 1) + .trimmed() + .toString() + .replace(QLatin1String("--"), QLatin1String("-")); + m_extraInfo[QMediaMetaData::Title] = + lineView.mid(titleStart + 1) + .trimmed() + .toString() + .replace(QLatin1String("--"), QLatin1String("-")); + } else { + m_extraInfo[QMediaMetaData::Title] = + lineView.mid(artistStart + 1) + .trimmed() + .toString() + .replace(QLatin1String("--"), QLatin1String("-")); + } + } + } + } else if (lineIndex == 0 && line.startsWith(QLatin1String("#EXTM3U"))) { + m_extendedFormat = true; + } + } else { + QUrl url = expandToFullPath(root, line); + m_extraInfo[QMediaMetaData::Url] = url; + m_parent->playlist.append(url); + newItemFound(QVariant::fromValue(m_extraInfo)); + m_extraInfo.clear(); + } + + return true; + } + + int getSplitIndex(const QString &line, int startPos) + { + if (startPos < 0) + startPos = 0; + const QChar *buf = line.data(); + for (int i = startPos; i < line.length(); ++i) { + if (buf[i] == u'-') { + if (i == line.length() - 1) + return i; + ++i; + if (buf[i] != u'-') + return i - 1; + } + } + return -1; + } + +private: + QMediaMetaData m_extraInfo; + bool m_extendedFormat; +}; + +class PLSParser : public ParserBase +{ +public: + explicit PLSParser(QPlaylistFileParser *q) : ParserBase(q) { } + + /* + * + The format is essentially that of an INI file structured as follows: + + Header + + * [playlist] : This tag indicates that it is a Playlist File + + Track Entry + Assuming track entry #X + + * FileX : Variable defining location of stream. + * TitleX : Defines track title. + * LengthX : Length in seconds of track. Value of -1 indicates indefinite. + + Footer + + * NumberOfEntries : This variable indicates the number of tracks. + * Version : Playlist version. Currently only a value of 2 is valid. + + [playlist] + + File1=Alternative\everclear - SMFTA.mp3 + + Title1=Everclear - So Much For The Afterglow + + Length1=233 + + File2=http://www.site.com:8000/listen.pls + + Title2=My Cool Stream + + Length5=-1 + + NumberOfEntries=2 + + Version=2 + */ + bool parseLineImpl(int, const QString &line, const QUrl &root) override + { + // We ignore everything but 'File' entries, since that's the only thing we care about. + if (!line.startsWith(QLatin1String("File"))) + return true; + + QString value = getValue(line); + if (value.isEmpty()) + return true; + + QUrl path = expandToFullPath(root, value); + m_parent->playlist.append(path); + newItemFound(path); + + return true; + } + + QString getValue(QStringView line) + { + int start = line.indexOf(u'='); + if (start < 0) + return QString(); + return line.mid(start + 1).trimmed().toString(); + } +}; +} + +///////////////////////////////////////////////////////////////////////////////////////////////// + +class QPlaylistFileParserPrivate +{ + Q_DECLARE_PUBLIC(QPlaylistFileParser) +public: + QPlaylistFileParserPrivate(QPlaylistFileParser *q) + : q_ptr(q), + m_stream(nullptr), + m_type(QPlaylistFileParser::UNKNOWN), + m_scanIndex(0), + m_lineIndex(-1), + m_utf8(false), + m_aborted(false) + { + } + + void handleData(); + void handleParserFinished(); + void abort(); + void reset(); + + std::unique_ptr m_source; + std::unique_ptr m_currentParser; + QByteArray m_buffer; + QUrl m_root; + QNetworkAccessManager m_mgr; + QString m_mimeType; + QPlaylistFileParser *q_ptr; + QPointer m_stream; + QPlaylistFileParser::FileType m_type; + struct ParserJob + { + QIODevice *m_stream = nullptr; + QUrl m_media; + QString m_mimeType; + [[nodiscard]] bool isValid() const { return m_stream || !m_media.isEmpty(); } + void reset() + { + m_stream = nullptr; + m_media = QUrl(); + m_mimeType = QString(); + } + } m_pendingJob; + int m_scanIndex; + int m_lineIndex; + bool m_utf8; + bool m_aborted; + +private: + bool processLine(int startIndex, int length); +}; + +#define LINE_LIMIT 4096 +#define READ_LIMIT 64 + +bool QPlaylistFileParserPrivate::processLine(int startIndex, int length) +{ + Q_Q(QPlaylistFileParser); + m_lineIndex++; + + if (!m_currentParser) { + const QString urlString = m_root.toString(); + const QString &suffix = !urlString.isEmpty() ? QFileInfo(urlString).suffix() : urlString; + QString mimeType; + if (m_source) + mimeType = m_source->header(QNetworkRequest::ContentTypeHeader).toString(); + m_type = QPlaylistFileParser::findPlaylistType( + suffix, !mimeType.isEmpty() ? mimeType : m_mimeType, m_buffer.constData(), + quint32(m_buffer.size())); + + switch (m_type) { + case QPlaylistFileParser::UNKNOWN: + emit q->error(QMediaPlaylist::FormatError, + QMediaPlaylist::tr("%1 playlist type is unknown").arg(m_root.toString())); + q->abort(); + return false; + case QPlaylistFileParser::M3U: + m_currentParser.reset(new M3UParser(q)); + break; + case QPlaylistFileParser::M3U8: + m_currentParser.reset(new M3UParser(q)); + m_utf8 = true; + break; + case QPlaylistFileParser::PLS: + m_currentParser.reset(new PLSParser(q)); + break; + } + + Q_ASSERT(m_currentParser); + } + + QString line; + + if (m_utf8) { + line = QString::fromUtf8(m_buffer.constData() + startIndex, length).trimmed(); + } else { + line = QString::fromLatin1(m_buffer.constData() + startIndex, length).trimmed(); + } + if (line.isEmpty()) + return true; + + Q_ASSERT(m_currentParser); + return m_currentParser->parseLine(m_lineIndex, line, m_root); +} + +void QPlaylistFileParserPrivate::handleData() +{ + Q_Q(QPlaylistFileParser); + + if (!m_stream) + return; + + while (m_stream->bytesAvailable() && !m_aborted) { + int expectedBytes = + qMin(READ_LIMIT, + int(qMin(m_stream->bytesAvailable(), qint64(LINE_LIMIT - m_buffer.size())))); + m_buffer.push_back(m_stream->read(expectedBytes)); + int processedBytes = 0; + while (m_scanIndex < m_buffer.length() && !m_aborted) { + char s = m_buffer[m_scanIndex]; + if (s == '\r' || s == '\n') { + int l = m_scanIndex - processedBytes; + if (l > 0) { + if (!processLine(processedBytes, l)) + break; + } + processedBytes = m_scanIndex + 1; + } + m_scanIndex++; + } + + if (m_aborted) + break; + + if (m_buffer.length() - processedBytes >= LINE_LIMIT) { + emit q->error(QMediaPlaylist::FormatError, + QMediaPlaylist::tr("invalid line in playlist file")); + q->abort(); + break; + } + + if (!m_stream->bytesAvailable() && (!m_source || !m_source->isFinished())) { + // last line + processLine(processedBytes, -1); + break; + } + + Q_ASSERT(m_buffer.length() == m_scanIndex); + if (processedBytes == 0) + continue; + + int copyLength = m_buffer.length() - processedBytes; + if (copyLength > 0) { + Q_ASSERT(copyLength <= READ_LIMIT); + m_buffer = m_buffer.right(copyLength); + } else { + m_buffer.clear(); + } + m_scanIndex = 0; + } + + handleParserFinished(); +} + +QPlaylistFileParser::QPlaylistFileParser(QObject *parent) + : QObject(parent), d_ptr(new QPlaylistFileParserPrivate(this)) +{ +} + +QPlaylistFileParser::~QPlaylistFileParser() = default; + +QPlaylistFileParser::FileType QPlaylistFileParser::findByMimeType(const QString &mime) +{ + if (mime == QLatin1String("text/uri-list") || mime == QLatin1String("audio/x-mpegurl") + || mime == QLatin1String("audio/mpegurl")) + return QPlaylistFileParser::M3U; + + if (mime == QLatin1String("application/x-mpegURL") + || mime == QLatin1String("application/vnd.apple.mpegurl")) + return QPlaylistFileParser::M3U8; + + if (mime == QLatin1String("audio/x-scpls")) + return QPlaylistFileParser::PLS; + + return QPlaylistFileParser::UNKNOWN; +} + +QPlaylistFileParser::FileType QPlaylistFileParser::findBySuffixType(const QString &suffix) +{ + const QString &s = suffix.toLower(); + + if (s == QLatin1String("m3u")) + return QPlaylistFileParser::M3U; + + if (s == QLatin1String("m3u8")) + return QPlaylistFileParser::M3U8; + + if (s == QLatin1String("pls")) + return QPlaylistFileParser::PLS; + + return QPlaylistFileParser::UNKNOWN; +} + +QPlaylistFileParser::FileType QPlaylistFileParser::findByDataHeader(const char *data, quint32 size) +{ + if (!data || size == 0) + return QPlaylistFileParser::UNKNOWN; + + if (size >= 7 && strncmp(data, "#EXTM3U", 7) == 0) + return QPlaylistFileParser::M3U; + + if (size >= 10 && strncmp(data, "[playlist]", 10) == 0) + return QPlaylistFileParser::PLS; + + return QPlaylistFileParser::UNKNOWN; +} + +QPlaylistFileParser::FileType QPlaylistFileParser::findPlaylistType(const QString &suffix, + const QString &mime, + const char *data, quint32 size) +{ + + FileType dataHeaderType = findByDataHeader(data, size); + if (dataHeaderType != UNKNOWN) + return dataHeaderType; + + FileType mimeType = findByMimeType(mime); + if (mimeType != UNKNOWN) + return mimeType; + + mimeType = findBySuffixType(mime); + if (mimeType != UNKNOWN) + return mimeType; + + FileType suffixType = findBySuffixType(suffix); + if (suffixType != UNKNOWN) + return suffixType; + + return UNKNOWN; +} + +/* + * Delegating + */ +void QPlaylistFileParser::start(const QUrl &media, QIODevice *stream, const QString &mimeType) +{ + if (stream) + start(stream, mimeType); + else + start(media, mimeType); +} + +void QPlaylistFileParser::start(QIODevice *stream, const QString &mimeType) +{ + Q_D(QPlaylistFileParser); + const bool validStream = stream ? (stream->isOpen() && stream->isReadable()) : false; + + if (!validStream) { + Q_EMIT error(QMediaPlaylist::AccessDeniedError, QMediaPlaylist::tr("Invalid stream")); + return; + } + + if (d->m_currentParser) { + abort(); + d->m_pendingJob = { stream, QUrl(), mimeType }; + return; + } + + playlist.clear(); + d->reset(); + d->m_mimeType = mimeType; + d->m_stream = stream; + connect(d->m_stream, SIGNAL(readyRead()), this, SLOT(handleData())); + d->handleData(); +} + +void QPlaylistFileParser::start(const QUrl &url, const QString &mimeType) +{ + Q_D(QPlaylistFileParser); + + if (url.isLocalFile() && !QFile::exists(url.toLocalFile())) { + emit error(QMediaPlaylist::AccessDeniedError, + QString(QMediaPlaylist::tr("%1 does not exist")).arg(url.toString())); + return; + } + + if (d->m_currentParser) { + abort(); + d->m_pendingJob = { nullptr, url, mimeType }; + return; + } + + d->reset(); + d->m_root = url; + d->m_mimeType = mimeType; + d->m_source.reset(d->m_mgr.get(QNetworkRequest(url))); + d->m_stream = d->m_source.get(); + connect(d->m_source.get(), SIGNAL(readyRead()), this, SLOT(handleData())); + connect(d->m_source.get(), SIGNAL(finished()), this, SLOT(handleData())); + connect(d->m_source.get(), SIGNAL(errorOccurred(QNetworkReply::NetworkError)), this, + SLOT(handleError())); + + if (url.isLocalFile()) + d->handleData(); +} + +void QPlaylistFileParser::abort() +{ + Q_D(QPlaylistFileParser); + d->abort(); + + if (d->m_source) + d->m_source->disconnect(); + + if (d->m_stream) + disconnect(d->m_stream, SIGNAL(readyRead()), this, SLOT(handleData())); + + playlist.clear(); +} + +void QPlaylistFileParser::handleData() +{ + Q_D(QPlaylistFileParser); + d->handleData(); +} + +void QPlaylistFileParserPrivate::handleParserFinished() +{ + Q_Q(QPlaylistFileParser); + const bool isParserValid = bool(m_currentParser); + if (!isParserValid && !m_aborted) + emit q->error(QMediaPlaylist::FormatNotSupportedError, + QMediaPlaylist::tr("Empty file provided")); + + if (isParserValid && !m_aborted) { + m_currentParser.reset(); + emit q->finished(); + } + + if (!m_aborted) + q->abort(); + + if (m_source) + m_source.reset(); + + if (m_pendingJob.isValid()) + q->start(m_pendingJob.m_media, m_pendingJob.m_stream, m_pendingJob.m_mimeType); +} + +void QPlaylistFileParserPrivate::abort() +{ + m_aborted = true; + if (m_currentParser) + m_currentParser->abort(); +} + +void QPlaylistFileParserPrivate::reset() +{ + Q_ASSERT(m_currentParser == nullptr); + Q_ASSERT(m_source == nullptr); + m_buffer.clear(); + m_root.clear(); + m_mimeType.clear(); + m_stream = nullptr; + m_type = QPlaylistFileParser::UNKNOWN; + m_scanIndex = 0; + m_lineIndex = -1; + m_utf8 = false; + m_aborted = false; + m_pendingJob.reset(); +} + +void QPlaylistFileParser::handleError() +{ + Q_D(QPlaylistFileParser); + const QString &errorString = d->m_source->errorString(); + Q_EMIT error(QMediaPlaylist::NetworkError, errorString); + abort(); +} + +QT_END_NAMESPACE + +#include "moc_qplaylistfileparser.cpp" diff --git a/examples/multimedia/player/qplaylistfileparser.h b/examples/multimedia/player/qplaylistfileparser.h new file mode 100644 index 0000000..f53c332 --- /dev/null +++ b/examples/multimedia/player/qplaylistfileparser.h @@ -0,0 +1,78 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PLAYLISTFILEPARSER_P_H +#define PLAYLISTFILEPARSER_P_H + +// +// W A R N I N G +// ------------- +// +// This file is not part of the Qt API. It exists purely as an +// implementation detail. This header file may change from version to +// version without notice, or even be removed. +// +// We mean it. +// + +#include "qmediaplaylist.h" +#include "qtmultimediaglobal.h" + +#include + +#include + +QT_BEGIN_NAMESPACE + +class QIODevice; +class QUrl; +class QNetworkRequest; + +class QPlaylistFileParserPrivate; + +class QPlaylistFileParser : public QObject +{ + Q_OBJECT +public: + QPlaylistFileParser(QObject *parent = nullptr); + ~QPlaylistFileParser(); + + enum FileType { + UNKNOWN, + M3U, + M3U8, // UTF-8 version of M3U + PLS + }; + + void start(const QUrl &media, QIODevice *stream = nullptr, const QString &mimeType = QString()); + void start(const QUrl &request, const QString &mimeType = QString()); + void start(QIODevice *stream, const QString &mimeType = QString()); + void abort(); + + QList playlist; + +signals: + void newItem(const QVariant &content); + void finished(); + void error(QMediaPlaylist::Error err, const QString &errorMsg); + +private slots: + void handleData(); + void handleError(); + +private: + static FileType findByMimeType(const QString &mime); + static FileType findBySuffixType(const QString &suffix); + static FileType findByDataHeader(const char *data, quint32 size); + static FileType findPlaylistType(QIODevice *device, const QString &mime); + static FileType findPlaylistType(const QString &suffix, const QString &mime, + const char *data = nullptr, quint32 size = 0); + + Q_DISABLE_COPY(QPlaylistFileParser) + Q_DECLARE_PRIVATE(QPlaylistFileParser) + std::unique_ptr d_ptr; +}; + +QT_END_NAMESPACE + +#endif // PLAYLISTFILEPARSER_P_H diff --git a/examples/multimedia/player/videowidget.cpp b/examples/multimedia/player/videowidget.cpp new file mode 100644 index 0000000..102b9c4 --- /dev/null +++ b/examples/multimedia/player/videowidget.cpp @@ -0,0 +1,46 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videowidget.h" + +#include +#include +#include + +VideoWidget::VideoWidget(QWidget *parent) : QVideoWidget(parent) +{ + setSizePolicy(QSizePolicy::Ignored, QSizePolicy::Ignored); + + QPalette p = palette(); + p.setColor(QPalette::Window, Qt::black); + setPalette(p); + + if constexpr (QOperatingSystemVersion::currentType() != QOperatingSystemVersion::Android) // QTBUG-95723 + setAttribute(Qt::WA_OpaquePaintEvent); +} + +void VideoWidget::keyPressEvent(QKeyEvent *event) +{ + if ((event->key() == Qt::Key_Escape || event->key() == Qt::Key_Back) && isFullScreen()) { + setFullScreen(false); + event->accept(); + } else if (event->key() == Qt::Key_Enter && event->modifiers() & Qt::Key_Alt) { + setFullScreen(!isFullScreen()); + event->accept(); + } else { + QVideoWidget::keyPressEvent(event); + } +} + +void VideoWidget::mouseDoubleClickEvent(QMouseEvent *event) +{ + setFullScreen(!isFullScreen()); + event->accept(); +} + +void VideoWidget::mousePressEvent(QMouseEvent *event) +{ + QVideoWidget::mousePressEvent(event); +} + +#include "moc_videowidget.cpp" diff --git a/examples/multimedia/player/videowidget.h b/examples/multimedia/player/videowidget.h new file mode 100644 index 0000000..3505a3f --- /dev/null +++ b/examples/multimedia/player/videowidget.h @@ -0,0 +1,22 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef VIDEOWIDGET_H +#define VIDEOWIDGET_H + +#include + +class VideoWidget : public QVideoWidget +{ + Q_OBJECT + +public: + explicit VideoWidget(QWidget *parent = nullptr); + +protected: + void keyPressEvent(QKeyEvent *event) override; + void mouseDoubleClickEvent(QMouseEvent *event) override; + void mousePressEvent(QMouseEvent *event) override; +}; + +#endif // VIDEOWIDGET_H diff --git a/examples/multimedia/screencapture/CMakeLists.txt b/examples/multimedia/screencapture/CMakeLists.txt new file mode 100644 index 0000000..a8603d1 --- /dev/null +++ b/examples/multimedia/screencapture/CMakeLists.txt @@ -0,0 +1,61 @@ +cmake_minimum_required(VERSION 3.16) + +project(screencapture VERSION 0.1 LANGUAGES CXX) + +set(CMAKE_INCLUDE_CURRENT_DIR ON) + +set(CMAKE_AUTOUIC ON) +set(CMAKE_AUTOMOC ON) +set(CMAKE_AUTORCC ON) + +set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD_REQUIRED ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/screencapture") + +find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Widgets) +find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS MultimediaWidgets Widgets) + +set(PROJECT_SOURCES + screencapture.pro + main.cpp + screencapturepreview.cpp + screencapturepreview.h + screenlistmodel.h + screenlistmodel.cpp + windowlistmodel.h + windowlistmodel.cpp +) + +qt_add_executable(screencapture + MANUAL_FINALIZATION + ${PROJECT_SOURCES} + ) + +target_link_libraries(screencapture PRIVATE + Qt${QT_VERSION_MAJOR}::Core + Qt${QT_VERSION_MAJOR}::Gui + Qt${QT_VERSION_MAJOR}::Widgets + Qt${QT_VERSION_MAJOR}::Multimedia + Qt${QT_VERSION_MAJOR}::MultimediaWidgets) + +set_target_properties(screencapture PROPERTIES + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in + MACOSX_BUNDLE TRUE + WIN32_EXECUTABLE TRUE + QT_ANDROID_PACKAGE_SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/android +) + +qt_add_ios_ffmpeg_libraries(screencapture) + +install(TARGETS screencapture + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) + +qt_finalize_executable(screencapture) diff --git a/examples/multimedia/screencapture/Info.plist.in b/examples/multimedia/screencapture/Info.plist.in new file mode 100644 index 0000000..02c09f8 --- /dev/null +++ b/examples/multimedia/screencapture/Info.plist.in @@ -0,0 +1,41 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/screencapture/android/AndroidManifest.xml b/examples/multimedia/screencapture/android/AndroidManifest.xml new file mode 100644 index 0000000..95f66eb --- /dev/null +++ b/examples/multimedia/screencapture/android/AndroidManifest.xml @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/screencapture/doc/images/screencapture.jpg b/examples/multimedia/screencapture/doc/images/screencapture.jpg new file mode 100644 index 0000000000000000000000000000000000000000..fb61fcd73d766c18f50a5fb73a41f4a267be0880 GIT binary patch literal 42725 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/screencapture/doc/src/screencapture.qdoc b/examples/multimedia/screencapture/doc/src/screencapture.qdoc new file mode 100644 index 0000000..32a58a3 --- /dev/null +++ b/examples/multimedia/screencapture/doc/src/screencapture.qdoc @@ -0,0 +1,49 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example screencapture + \title Screen Capture Example + \ingroup multimedia_examples + \examplecategory {Multimedia} + \brief Capturing a screen or window. + \meta {tag} {widgets} + + \e{Screen Capture} demonstrates how to capture a screen or window using + QScreenCapture and QWindowCapture. The example shows a list of screens and + windows and displays a live preview of the selected item using a + QMediaCaptureSession and a QVideoWidget. Capturing can be started and stopped + with a \l{QPushButton}{button}. + + \image screencapture.jpg + {UI showing list of screens together with the screenshotted image} + + \include examples-run.qdocinc + + \section1 Application Structure + + The example consists of three custom classes. The UI and all screen capture + functionality is implemented in the class ScreenCapturePreview. The classes + ScreenListModel and WindowListModel only serve as models behind the two + QListView widgets. The main function creates a ScreenCapturePreview object, + which in turn creates instances of QScreenCapture and QWindowCapture, + and a QMediaCaptureSession and QVideoWidget, in addition to all the UI widgets. + + The screen and window models are populated with the return values of + \l QGuiApplication::screens() and \l QWindowCapture::capturableWindows(), + respectively. + + When a list item is selected, it is connected to the QScreenCapture object + with \l{QScreenCapture::}{setScreen()}, or to the QWindowCapture object + with \l{QWindowCapture::}{setWindow()}. The capture object is connected to + the QMediaCaptureSession object with \l{QMediaCaptureSession::}{setScreenCapture()} + and \l{QMediaCaptureSession::}{setWindowCapture()}, respectively. + The capture session in turn is connected to the QVideoWidget object with + \l{QMediaCaptureSession::}{setVideoOutput()}. Thus, the capture output is + previewed in the video widget on the right hand side of the UI. + + The start/stop button calls \l QScreenCapture::start() and \l QScreenCapture::stop(), + or \l QWindowCapture::start() and \l QWindowCapture::stop(). + + A QMessageBox pops up if the \l{QScreenCapture::}{errorOccurred} signal is emitted. +*/ diff --git a/examples/multimedia/screencapture/main.cpp b/examples/multimedia/screencapture/main.cpp new file mode 100644 index 0000000..6ed104f --- /dev/null +++ b/examples/multimedia/screencapture/main.cpp @@ -0,0 +1,14 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "screencapturepreview.h" + +#include + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + ScreenCapturePreview screenCapturePreview; + screenCapturePreview.show(); + return app.exec(); +} diff --git a/examples/multimedia/screencapture/screencapture.pro b/examples/multimedia/screencapture/screencapture.pro new file mode 100644 index 0000000..daeb3ba --- /dev/null +++ b/examples/multimedia/screencapture/screencapture.pro @@ -0,0 +1,19 @@ +TEMPLATE = app +TARGET = screencapture + +QT += multimedia multimediawidgets +CONFIG += add_ios_ffmpeg_libraries + +HEADERS = \ + screencapturepreview.h \ + screenlistmodel.h \ + windowlistmodel.h + +SOURCES = \ + main.cpp \ + screencapturepreview.cpp \ + screenlistmodel.cpp \ + windowlistmodel.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/screencapture +INSTALLS += target diff --git a/examples/multimedia/screencapture/screencapturepreview.cpp b/examples/multimedia/screencapture/screencapturepreview.cpp new file mode 100644 index 0000000..6eda008 --- /dev/null +++ b/examples/multimedia/screencapture/screencapturepreview.cpp @@ -0,0 +1,179 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "screencapturepreview.h" +#include "screenlistmodel.h" +#include "windowlistmodel.h" + +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include + +ScreenCapturePreview::ScreenCapturePreview(QWidget *parent) + : QWidget(parent), + screenListView(new QListView(this)), + windowListView(new QListView(this)), + screenCapture(new QScreenCapture(this)), + windowCapture(new QWindowCapture(this)), + mediaCaptureSession(new QMediaCaptureSession(this)), + videoWidget(new QVideoWidget(this)), + gridLayout(new QGridLayout(this)), + startStopButton(new QPushButton(this)), + screenLabel(new QLabel(tr("Select screen to capture:"), this)), + windowLabel(new QLabel(tr("Select window to capture:"), this)), + videoWidgetLabel(new QLabel(tr("Capture output:"), this)) +{ + // Get lists of screens and windows: + screenListModel = new ScreenListModel(this); + windowListModel = new WindowListModel(this); + + // Setup QScreenCapture with initial source: + + mediaCaptureSession->setScreenCapture(screenCapture); + mediaCaptureSession->setWindowCapture(windowCapture); + mediaCaptureSession->setVideoOutput(videoWidget); + + // Setup UI: + + screenListView->setModel(screenListModel); + windowListView->setModel(windowListModel); + + auto updateAction = new QAction(tr("Update Windows List"), this); + connect(updateAction, &QAction::triggered, windowListModel, &WindowListModel::populate); + windowListView->addAction(updateAction); + windowListView->setContextMenuPolicy(Qt::ActionsContextMenu); + + gridLayout->addWidget(screenLabel, 0, 0); + gridLayout->addWidget(screenListView, 1, 0); + gridLayout->addWidget(windowLabel, 2, 0); + gridLayout->addWidget(windowListView, 3, 0); + gridLayout->addWidget(startStopButton, 4, 0); + gridLayout->addWidget(videoWidgetLabel, 0, 1); + gridLayout->addWidget(videoWidget, 1, 1, 4, 1); + + gridLayout->setColumnStretch(1, 1); + gridLayout->setRowStretch(1, 1); + gridLayout->setColumnMinimumWidth(0, 400); + gridLayout->setColumnMinimumWidth(1, 400); + gridLayout->setRowMinimumHeight(3, 1); + + connect(screenListView->selectionModel(), &QItemSelectionModel::selectionChanged, this, + &ScreenCapturePreview::onCurrentScreenSelectionChanged); + connect(windowListView->selectionModel(), &QItemSelectionModel::selectionChanged, this, + &ScreenCapturePreview::onCurrentWindowSelectionChanged); + connect(startStopButton, &QPushButton::clicked, this, + &ScreenCapturePreview::onStartStopButtonClicked); + connect(screenCapture, &QScreenCapture::errorChanged, this, + &ScreenCapturePreview::onScreenCaptureErrorChanged, Qt::QueuedConnection); + connect(windowCapture, &QWindowCapture::errorChanged, this, + &ScreenCapturePreview::onWindowCaptureErrorChanged, Qt::QueuedConnection); + + updateActive(SourceType::Screen, true); +} + +ScreenCapturePreview::~ScreenCapturePreview() = default; + +void ScreenCapturePreview::onCurrentScreenSelectionChanged(QItemSelection selection) +{ + if (auto indexes = selection.indexes(); !indexes.empty()) { + screenCapture->setScreen(screenListModel->screen(indexes.front())); + updateActive(SourceType::Screen, isActive()); + + windowListView->clearSelection(); + } else { + screenCapture->setScreen(nullptr); + } +} + +void ScreenCapturePreview::onCurrentWindowSelectionChanged(QItemSelection selection) +{ + if (auto indexes = selection.indexes(); !indexes.empty()) { + auto window = windowListModel->window(indexes.front()); + if (!window.isValid()) { + const auto questionResult = QMessageBox::question( + this, tr("Invalid window"), + tr("The window is no longer valid. Update the list of windows?")); + if (questionResult == QMessageBox::Yes) { + updateActive(SourceType::Window, false); + + windowListView->clearSelection(); + windowListModel->populate(); + return; + } + } + + windowCapture->setWindow(window); + updateActive(SourceType::Window, isActive()); + + screenListView->clearSelection(); + } else { + windowCapture->setWindow({}); + } +} + +void ScreenCapturePreview::onWindowCaptureErrorChanged() +{ + if (windowCapture->error() == QWindowCapture::NoError) + return; + + QMessageBox::warning(this, tr("QWindowCapture: Error occurred"), windowCapture->errorString()); +} + +void ScreenCapturePreview::onScreenCaptureErrorChanged() +{ + if (screenCapture->error() == QScreenCapture::NoError) + return; + + QMessageBox::warning(this, tr("QScreenCapture: Error occurred"), screenCapture->errorString()); +} + +void ScreenCapturePreview::onStartStopButtonClicked() +{ + updateActive(sourceType, !isActive()); +} + +void ScreenCapturePreview::updateStartStopButtonText() +{ + switch (sourceType) { + case SourceType::Window: + startStopButton->setText(isActive() ? tr("Stop window capture") + : tr("Start window capture")); + break; + case SourceType::Screen: + startStopButton->setText(isActive() ? tr("Stop screen capture") + : tr("Start screen capture")); + break; + } +} + +void ScreenCapturePreview::updateActive(SourceType sourceType, bool active) +{ + this->sourceType = sourceType; + + screenCapture->setActive(active && sourceType == SourceType::Screen); + windowCapture->setActive(active && sourceType == SourceType::Window); + + updateStartStopButtonText(); +} + +bool ScreenCapturePreview::isActive() const +{ + switch (sourceType) { + case SourceType::Window: + return windowCapture->isActive(); + case SourceType::Screen: + return screenCapture->isActive(); + default: + return false; + } +} + +#include "moc_screencapturepreview.cpp" diff --git a/examples/multimedia/screencapture/screencapturepreview.h b/examples/multimedia/screencapture/screencapturepreview.h new file mode 100644 index 0000000..d7be17a --- /dev/null +++ b/examples/multimedia/screencapture/screencapturepreview.h @@ -0,0 +1,66 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef SCREENCAPTUREPREVIEW_H +#define SCREENCAPTUREPREVIEW_H + +#include +#include +#include +#include + +class ScreenListModel; +class WindowListModel; + +QT_BEGIN_NAMESPACE +class QListView; +class QMediaCaptureSession; +class QVideoWidget; +class QGridLayout; +class QHBoxLayout; +class QLineEdit; +class QPushButton; +class QLabel; +QT_END_NAMESPACE + + +class ScreenCapturePreview : public QWidget +{ + Q_OBJECT + +public: + explicit ScreenCapturePreview(QWidget *parent = nullptr); + ~ScreenCapturePreview() override; + +private slots: + void onCurrentScreenSelectionChanged(QItemSelection index); + void onCurrentWindowSelectionChanged(QItemSelection index); + void onWindowCaptureErrorChanged(); + void onScreenCaptureErrorChanged(); + void onStartStopButtonClicked(); + +private: + enum class SourceType { Screen, Window }; + + void updateActive(SourceType sourceType, bool active); + void updateStartStopButtonText(); + bool isActive() const; + +private: + ScreenListModel *screenListModel = nullptr; + WindowListModel *windowListModel = nullptr; + QListView *screenListView = nullptr; + QListView *windowListView = nullptr; + QScreenCapture *screenCapture = nullptr; + QWindowCapture *windowCapture = nullptr; + QMediaCaptureSession *mediaCaptureSession = nullptr; + QVideoWidget *videoWidget = nullptr; + QGridLayout *gridLayout = nullptr; + QPushButton *startStopButton = nullptr; + QLabel *screenLabel = nullptr; + QLabel *windowLabel = nullptr; + QLabel *videoWidgetLabel = nullptr; + SourceType sourceType = SourceType::Screen; +}; + +#endif // SCREENCAPTUREPREVIEW_H diff --git a/examples/multimedia/screencapture/screenlistmodel.cpp b/examples/multimedia/screencapture/screenlistmodel.cpp new file mode 100644 index 0000000..0b46560 --- /dev/null +++ b/examples/multimedia/screencapture/screenlistmodel.cpp @@ -0,0 +1,54 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "screenlistmodel.h" + +#include +#include + +#include + +ScreenListModel::ScreenListModel(QObject *parent) : + QAbstractListModel(parent) +{ + auto *app = qApp; + connect(app, &QGuiApplication::screenAdded, this, &ScreenListModel::screensChanged); + connect(app, &QGuiApplication::screenRemoved, this, &ScreenListModel::screensChanged); + connect(app, &QGuiApplication::primaryScreenChanged, this, &ScreenListModel::screensChanged); +} + +int ScreenListModel::rowCount(const QModelIndex &) const +{ + return QGuiApplication::screens().size(); +} + +QVariant ScreenListModel::data(const QModelIndex &index, int role) const +{ + const auto screenList = QGuiApplication::screens(); + Q_ASSERT(index.isValid()); + Q_ASSERT(index.row() <= screenList.size()); + + if (role == Qt::DisplayRole) { + auto *screen = screenList.at(index.row()); + QString description; + QTextStream str(&description); + str << '"' << screen->name() << "\" " << screen->size().width() << 'x' + << screen->size().height() << ", " << screen->logicalDotsPerInch() << "DPI"; + return description; + } + + return {}; +} + +QScreen *ScreenListModel::screen(const QModelIndex &index) const +{ + return QGuiApplication::screens().value(index.row()); +} + +void ScreenListModel::screensChanged() +{ + beginResetModel(); + endResetModel(); +} + +#include "moc_screenlistmodel.cpp" diff --git a/examples/multimedia/screencapture/screenlistmodel.h b/examples/multimedia/screencapture/screenlistmodel.h new file mode 100644 index 0000000..288419c --- /dev/null +++ b/examples/multimedia/screencapture/screenlistmodel.h @@ -0,0 +1,29 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef SCREENLISTMODEL_H +#define SCREENLISTMODEL_H + +#include + +QT_BEGIN_NAMESPACE +class QScreen; +QT_END_NAMESPACE + + +class ScreenListModel : public QAbstractListModel +{ + Q_OBJECT + +public: + explicit ScreenListModel(QObject *parent = nullptr); + + int rowCount(const QModelIndex &parent = QModelIndex()) const override; + QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; + QScreen *screen(const QModelIndex &index) const; + +private Q_SLOTS: + void screensChanged(); +}; + +#endif // SCREENLISTMODEL_H diff --git a/examples/multimedia/screencapture/windowlistmodel.cpp b/examples/multimedia/screencapture/windowlistmodel.cpp new file mode 100644 index 0000000..45b8cea --- /dev/null +++ b/examples/multimedia/screencapture/windowlistmodel.cpp @@ -0,0 +1,42 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "windowlistmodel.h" +#include + +WindowListModel::WindowListModel(QObject *parent) + : QAbstractListModel(parent), windowList(QWindowCapture::capturableWindows()) +{ +} + +int WindowListModel::rowCount(const QModelIndex &) const +{ + return windowList.size(); +} + +QVariant WindowListModel::data(const QModelIndex &index, int role) const +{ + Q_ASSERT(index.isValid()); + Q_ASSERT(index.row() <= windowList.size()); + + if (role == Qt::DisplayRole) { + auto window = windowList.at(index.row()); + return window.description(); + } + + return {}; +} + +QCapturableWindow WindowListModel::window(const QModelIndex &index) const +{ + return windowList.at(index.row()); +} + +void WindowListModel::populate() +{ + beginResetModel(); + windowList = QWindowCapture::capturableWindows(); + endResetModel(); +} + +#include "moc_windowlistmodel.cpp" diff --git a/examples/multimedia/screencapture/windowlistmodel.h b/examples/multimedia/screencapture/windowlistmodel.h new file mode 100644 index 0000000..4d210fc --- /dev/null +++ b/examples/multimedia/screencapture/windowlistmodel.h @@ -0,0 +1,30 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef WINDOWLISTMODEL_H +#define WINDOWLISTMODEL_H + +#include +#include + + +class WindowListModel : public QAbstractListModel +{ + Q_OBJECT + +public: + explicit WindowListModel(QObject *parent = nullptr); + + int rowCount(const QModelIndex &parent = QModelIndex()) const override; + QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; + + QCapturableWindow window(const QModelIndex &index) const; + +public Q_SLOTS: + void populate(); + +private: + QList windowList; +}; + +#endif // WINDOWLISTMODEL_H diff --git a/examples/multimedia/video/CMakeLists.txt b/examples/multimedia/video/CMakeLists.txt new file mode 100644 index 0000000..72e5d7e --- /dev/null +++ b/examples/multimedia/video/CMakeLists.txt @@ -0,0 +1,10 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +qt_internal_add_example(qmlvideo) +if(TARGET Qt::QuickControls2) + if(TARGET Qt::Svg) + qt_internal_add_example(mediaplayer) + endif() + qt_internal_add_example(recorder) +endif() diff --git a/examples/multimedia/video/mediaplayer/CMakeLists.txt b/examples/multimedia/video/mediaplayer/CMakeLists.txt new file mode 100644 index 0000000..df8e988 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/CMakeLists.txt @@ -0,0 +1,71 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) + +project(mediaplayer LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/mediaplayer") + +find_package(Qt6 REQUIRED COMPONENTS Multimedia Core Quick QuickControls2 Svg) + +qt_standard_project_setup(REQUIRES 6.8) + +qt_add_executable(mediaplayerexample + main.cpp +) + +qt_add_ios_ffmpeg_libraries(mediaplayerexample) + +set_target_properties(mediaplayerexample PROPERTIES + MACOSX_BUNDLE TRUE +) + +qt_add_qml_module(mediaplayerexample + URI mediaplayer + QML_FILES + "Main.qml" + "controls/PlaybackControl.qml" + "controls/AudioControl.qml" + "controls/PlaybackSeekControl.qml" + "controls/SettingsPopup.qml" + "controls/UrlPopup.qml" + "controls/MetadataInfo.qml" + "controls/TracksInfo.qml" + RESOURCES + "images/backward10.svg" + "images/mute.svg" + "images/open_new.svg" + "images/pause_symbol.svg" + "images/play_symbol.svg" + "images/forward10.svg" + "images/more.svg" + "images/speaker.svg" + "images/stop_symbol.svg" + "images/volume.svg" + "images/volume_mute.svg" + "images/zoom_maximize.svg" + "images/zoom_minimize.svg" + "images/link.svg" + "images/loop.svg" +) + +target_link_libraries(mediaplayerexample PRIVATE + Qt6::Core + Qt6::Multimedia + Qt6::Svg + Qt6::Quick + Qt6::Multimedia +) + +install(TARGETS mediaplayerexample + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/video/mediaplayer/Main.qml b/examples/multimedia/video/mediaplayer/Main.qml new file mode 100644 index 0000000..b605460 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/Main.qml @@ -0,0 +1,185 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Window +import QtQuick.Controls +import QtQuick.Dialogs +import QtMultimedia +import "controls" + +//! [0] +ApplicationWindow { + id: root + title: qsTr("Multimedia Player") + width: 1280 + height: 720 + //! [0] + minimumWidth: 960 + minimumHeight: 540 + visible: true + color: "black" + + property alias source: mediaPlayer.source + property alias playbackRate: mediaPlayer.playbackRate + property bool fullScreen: false + + MessageDialog { + id: mediaError + buttons: MessageDialog.Ok + } + + MouseArea { + // an activity listener to hide the playback contols when idle + id: activityListener + anchors.fill: parent + z: 1 + propagateComposedEvents: true + hoverEnabled: true + + property bool inactiveMouse: false + + Timer { + id: timer + interval: 1500 // milliseconds + onTriggered: activityListener.inactiveMouse = true + } + + function activityHandler(mouse) { + if (activityListener.inactiveMouse) + activityListener.inactiveMouse = false + timer.restart() + timer.start() + mouse.accepted = false + } + + onPositionChanged: mouse => activityHandler(mouse) + onPressed: mouse => activityHandler(mouse) + onDoubleClicked: mouse => mouse.accepted = false + } + + MetadataInfo { + id: metadataInfo + } + + TracksInfo { + id: audioTracksInfo + onSelectedTrackChanged: { + mediaPlayer.activeAudioTrack = selectedTrack + mediaPlayer.updateMetadata() + } + } + + TracksInfo { + id: videoTracksInfo + onSelectedTrackChanged: { + mediaPlayer.activeVideoTrack = selectedTrack + mediaPlayer.updateMetadata() + } + } + + TracksInfo { + id: subtitleTracksInfo + onSelectedTrackChanged: { + mediaPlayer.activeSubtitleTrack = selectedTrack + mediaPlayer.updateMetadata() + } + } + + MediaDevices { + id: mediaDevices + onAudioOutputsChanged: { + audio.device = mediaDevices.defaultAudioOutput + } + } + + //! [1] + MediaPlayer { + id: mediaPlayer + //! [1] + function updateMetadata() { + metadataInfo.clear() + metadataInfo.read(mediaPlayer.metaData) + metadataInfo.read(mediaPlayer.audioTracks[mediaPlayer.activeAudioTrack]) + metadataInfo.read(mediaPlayer.videoTracks[mediaPlayer.activeVideoTrack]) + metadataInfo.read(mediaPlayer.subtitleTracks[mediaPlayer.activeSubtitleTrack]) + } + //! [2] + videoOutput: videoOutput + audioOutput: AudioOutput { + id: audio + muted: playbackController.muted + volume: playbackController.volume + } + //! [2] + //! [4] + onErrorOccurred: { + mediaError.text = mediaPlayer.errorString + mediaError.open() + } + //! [4] + onMetaDataChanged: { updateMetadata() } + //! [6] + onTracksChanged: { + audioTracksInfo.read(mediaPlayer.audioTracks) + videoTracksInfo.read(mediaPlayer.videoTracks) + subtitleTracksInfo.read(mediaPlayer.subtitleTracks, 6) /* QMediaMetaData::Language = 6 */ + updateMetadata() + mediaPlayer.play() + } + //! [6] + source: new URL("https://download.qt.io/learning/videos/media-player-example/Qt_LogoMergeEffect.mp4") + } + + //! [3] + VideoOutput { + id: videoOutput + anchors.fill: parent + visible: mediaPlayer.mediaStatus > 0 + + TapHandler { + onDoubleTapped: { + root.fullScreen ? root.showNormal() : root.showFullScreen() + root.fullScreen = !root.fullScreen + } + } + } + //! [3] + + Rectangle { + anchors.fill: parent + visible: mediaPlayer.mediaStatus === 0 + color: "black" + + TapHandler { + onDoubleTapped: { + root.fullScreen ? root.showNormal() : root.showFullScreen() + root.fullScreen = !root.fullScreen + } + } + } + + //! [5] + PlaybackControl { + id: playbackController + //! [5] + + property bool showControls: !activityListener.inactiveMouse || busy + opacity: showControls + // onOpacityChanged can't be used as it is animated and therefore not immediate + onShowControlsChanged: activityListener.cursorShape = showControls ? + Qt.ArrowCursor : Qt.BlankCursor + + anchors.bottom: parent.bottom + anchors.left: parent.left + anchors.right: parent.right + + //! [6] + mediaPlayer: mediaPlayer + audioTracksInfo: audioTracksInfo + videoTracksInfo: videoTracksInfo + subtitleTracksInfo: subtitleTracksInfo + metadataInfo: metadataInfo + } + //! [6] +} diff --git a/examples/multimedia/video/mediaplayer/controls/AudioControl.qml b/examples/multimedia/video/mediaplayer/controls/AudioControl.qml new file mode 100644 index 0000000..404bc08 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/AudioControl.qml @@ -0,0 +1,51 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts + +Item { + id: audioController + + property alias busy: slider.pressed + //! [0] + property alias muted: muteButton.checked + property real volume: slider.value + //! [0] + property alias showSlider: slider.visible + property int iconDimension: 24 + + implicitHeight: 46 + implicitWidth: mainLayout.width + + RowLayout { + id: mainLayout + spacing: 10 + anchors.verticalCenter: parent.verticalCenter + + RoundButton { + id: muteButton + implicitHeight: 40 + implicitWidth: 40 + radius: 4 + icon.source: audioController.muted ? "../images/volume_mute.svg" : "../images/volume.svg" + icon.width: audioController.iconDimension + icon.height: audioController.iconDimension + icon.color: palette.buttonText + flat: true + checkable: true + } + + Slider { + id: slider + visible: !audioController.showSlider + implicitWidth: 136 + Layout.fillWidth: true + Layout.alignment: Qt.AlignVCenter + + enabled: !audioController.muted + value: 1 + } + } +} diff --git a/examples/multimedia/video/mediaplayer/controls/MetadataInfo.qml b/examples/multimedia/video/mediaplayer/controls/MetadataInfo.qml new file mode 100644 index 0000000..3e68faa --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/MetadataInfo.qml @@ -0,0 +1,30 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + property alias metadata: listModel + property alias count: listModel.count + + function clear() { + listModel.clear() + } + + //! [0] + function read(metadata) { + if (!metadata) + return + for (const key of metadata.keys()) + if (metadata.stringValue(key)) + listModel.append({ + name: metadata.metaDataKeyToString(key), + value: metadata.stringValue(key) + }) + } + + ListModel { + id: listModel + } + //! [0] +} diff --git a/examples/multimedia/video/mediaplayer/controls/PlaybackControl.qml b/examples/multimedia/video/mediaplayer/controls/PlaybackControl.qml new file mode 100644 index 0000000..2250af6 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/PlaybackControl.qml @@ -0,0 +1,317 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtMultimedia +import QtQuick.Dialogs + +//! [0] +Item { + id: playbackController + + required property MediaPlayer mediaPlayer + required property MetadataInfo metadataInfo + required property TracksInfo audioTracksInfo + required property TracksInfo videoTracksInfo + required property TracksInfo subtitleTracksInfo + //! [0] + + property alias muted: audioControl.muted + property alias volume: audioControl.volume + + property bool landscapePlaybackControls: root.width >= 668 + property bool busy: fileDialog.visible + || urlPopup.visible + || settingsPopup.visible + || audioControl.busy + || playbackSeekControl.busy + + implicitHeight: landscapePlaybackControls ? 168 : 208 + + Behavior on opacity { NumberAnimation { duration: 300 } } + + FileDialog { + id: fileDialog + title: "Please choose a file" + onAccepted: { + playbackController.mediaPlayer.stop() + playbackController.mediaPlayer.source = fileDialog.selectedFile + playbackController.mediaPlayer.play() + } + } + + UrlPopup { + id: urlPopup + anchors.centerIn: Overlay.overlay + mediaPlayer: playbackController.mediaPlayer + } + + SettingsPopup { + id: settingsPopup + anchors.centerIn: Overlay.overlay + + metadataInfo: playbackController.metadataInfo + mediaPlayer: playbackController.mediaPlayer + audioTracksInfo: playbackController.audioTracksInfo + videoTracksInfo: playbackController.videoTracksInfo + subtitleTracksInfo: playbackController.subtitleTracksInfo + } + + component CustomButton: RoundButton { + implicitWidth: 40 + implicitHeight: 40 + radius: 4 + icon.width: 24 + icon.height: 24 + flat: true + } + + component CustomRoundButton: RoundButton { + property int diameter: 40 + Layout.preferredWidth: diameter + Layout.preferredHeight: diameter + radius: diameter / 2 + icon.width: 24 + icon.height: 24 + } + + //! [1] + CustomButton { + id: fileDialogButton + icon.source: "../images/open_new.svg" + flat: false + onClicked: fileDialog.open() + } + + CustomButton { + id: openUrlButton + icon.source: "../images/link.svg" + flat: false + onClicked: urlPopup.open() + } + //! [1] + + CustomButton { + id: loopButton + icon.source: "../images/loop.svg" + icon.color: playbackController.mediaPlayer.loops === MediaPlayer.Once ? palette.buttonText : palette.accent + onClicked: playbackController.mediaPlayer.loops = playbackController.mediaPlayer.loops === MediaPlayer.Once + ? MediaPlayer.Infinite + : MediaPlayer.Once + } + + CustomButton { + id: settingsButton + icon.source: "../images/more.svg" + onClicked: settingsPopup.open() + } + + CustomButton { + id: fullScreenButton + icon.source: root.fullScreen ? "../images/zoom_minimize.svg" + : "../images/zoom_maximize.svg" + onClicked: { + root.fullScreen ? root.showNormal() : root.showFullScreen() + root.fullScreen = !root.fullScreen + } + } + + RowLayout { + id: controlButtons + spacing: 16 + + CustomRoundButton { + id: backward10Button + icon.source: "../images/backward10.svg" + onClicked: { + const pos = Math.max(0, playbackController.mediaPlayer.position - 10000) + playbackController.mediaPlayer.setPosition(pos) + } + } + + //! [2] + CustomRoundButton { + id: playButton + visible: playbackController.mediaPlayer.playbackState !== MediaPlayer.PlayingState + icon.source: "../images/play_symbol.svg" + onClicked: playbackController.mediaPlayer.play() + } + + CustomRoundButton { + id: pauseButton + visible: playbackController.mediaPlayer.playbackState === MediaPlayer.PlayingState + icon.source: "../images/pause_symbol.svg" + onClicked: playbackController.mediaPlayer.pause() + } + //! [2] + + //! [3] + CustomRoundButton { + id: forward10Button + icon.source: "../images/forward10.svg" + onClicked: { + const pos = Math.min(playbackController.mediaPlayer.duration, + playbackController.mediaPlayer.position + 10000) + playbackController.mediaPlayer.setPosition(pos) + } + } + //! [3] + } // RowLayout controlButtons + + AudioControl { + id: audioControl + showSlider: root.width >= 960 + } + + PlaybackSeekControl { + id: playbackSeekControl + Layout.fillWidth: true + mediaPlayer: playbackController.mediaPlayer + } + + Frame { + id: landscapeLayout + anchors.fill: parent + padding: 32 + topPadding: 28 + visible: landscapePlaybackControls + background: Rectangle { + color: palette.window + } + + ColumnLayout { + anchors.fill: parent + spacing: 16 + + Item { + Layout.fillWidth: true + implicitHeight: 40 + + LayoutItemProxy { + id: fdbProxy + target: fileDialogButton + anchors.left: parent.left + } + + LayoutItemProxy { + target: openUrlButton + anchors.left: fdbProxy.right + anchors.leftMargin: 12 + } + + LayoutItemProxy { + target: controlButtons + anchors.horizontalCenter: parent.horizontalCenter + } + + LayoutItemProxy { + target: loopButton + anchors.right: acProxy.left + anchors.rightMargin: 12 + } + + LayoutItemProxy { + id: acProxy + target: audioControl + anchors.right: sbProxy.left + anchors.rightMargin: 30 + anchors.verticalCenter: parent.verticalCenter + } + + LayoutItemProxy { + id: sbProxy + target: settingsButton + anchors.right: fbProxy.left + anchors.rightMargin: 12 + } + + LayoutItemProxy { + id: fbProxy + target: fullScreenButton + anchors.right: parent.right + } + } // Item + + LayoutItemProxy { + target: playbackSeekControl + Layout.topMargin: 16 + Layout.bottomMargin: 16 + } + } + } // Frame frame + + Frame { + id: portraitLayout + anchors.fill: parent + padding: 32 + topPadding: 28 + visible: !landscapePlaybackControls + background: Rectangle { + color: palette.window + } + + ColumnLayout { + anchors.fill: parent + spacing: 16 + + Item { + Layout.fillWidth: true + implicitHeight: 40 + + LayoutItemProxy { + target: loopButton + anchors.right: cbProxy.left + anchors.rightMargin: 16 + } + + LayoutItemProxy { + id: cbProxy + target: controlButtons + anchors.horizontalCenter: parent.horizontalCenter + } + + LayoutItemProxy { + target: audioControl + anchors.left: cbProxy.right + anchors.leftMargin: 16 + } + } + Item { + Layout.fillWidth: true + implicitHeight: 40 + + LayoutItemProxy { + id: fdbProxy_ + target: fileDialogButton + anchors.left: parent.left + } + + LayoutItemProxy { + target: openUrlButton + anchors.left: fdbProxy_.right + anchors.leftMargin: 12 + } + + LayoutItemProxy { + target: settingsButton + anchors.right: fbProxy_.left + anchors.rightMargin: 12 + } + + LayoutItemProxy { + id: fbProxy_ + target: fullScreenButton + anchors.right: parent.right + } + } + + LayoutItemProxy { + target: playbackSeekControl + Layout.topMargin: 8 + Layout.bottomMargin: 8 + } + } + } +} diff --git a/examples/multimedia/video/mediaplayer/controls/PlaybackSeekControl.qml b/examples/multimedia/video/mediaplayer/controls/PlaybackSeekControl.qml new file mode 100644 index 0000000..c2d4002 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/PlaybackSeekControl.qml @@ -0,0 +1,56 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtMultimedia + +Item { + id: seekController + required property MediaPlayer mediaPlayer + property alias busy: slider.pressed + + implicitHeight: 20 + + function formatToMinutes(milliseconds) { + const min = Math.floor(milliseconds / 60000) + const sec = ((milliseconds - min * 60000) / 1000).toFixed(1) + return `${min}:${sec.padStart(4, 0)}` + } + + RowLayout { + anchors.fill: parent + spacing: 22 + + //! [0] + Label { + id: currentTime + Layout.preferredWidth: 45 + text: seekController.formatToMinutes(seekController.mediaPlayer.position) + horizontalAlignment: Text.AlignLeft + font.pixelSize: 11 + } + //! [0] + + Slider { + id: slider + Layout.fillWidth: true + //! [2] + enabled: seekController.mediaPlayer.seekable + value: seekController.mediaPlayer.position / seekController.mediaPlayer.duration + //! [2] + onMoved: seekController.mediaPlayer.setPosition(value * seekController.mediaPlayer.duration) + } + + //! [1] + Label { + id: remainingTime + Layout.preferredWidth: 45 + text: seekController.formatToMinutes(seekController.mediaPlayer.duration - seekController.mediaPlayer.position) + horizontalAlignment: Text.AlignRight + font.pixelSize: 11 + } + //! [1] + } +} diff --git a/examples/multimedia/video/mediaplayer/controls/SettingsPopup.qml b/examples/multimedia/video/mediaplayer/controls/SettingsPopup.qml new file mode 100644 index 0000000..e5ca84b --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/SettingsPopup.qml @@ -0,0 +1,238 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Layouts +import QtQuick.Controls +import QtMultimedia + +Popup { + id: settingsController + focus: true + closePolicy: Popup.CloseOnEscape | Popup.CloseOnPressOutside + + // returns tool tip body, if any + function pcTooltip(availability) { + switch (availability) { + case MediaPlayer.AlwaysOn: + return qsTr("Pitch compensation enforced on by this backend") + case MediaPlayer.Available: + return mediaPlayer.playbackRate === 1 ? + qsTr("Pitch compensation will not have any noticeable effect at normal speed") : "" + case MediaPlayer.Unavailable: + return qsTr("Pitch compensation is not supported on this backend") + } + } + + required property MetadataInfo metadataInfo + required property MediaPlayer mediaPlayer + required property TracksInfo audioTracksInfo + required property TracksInfo videoTracksInfo + required property TracksInfo subtitleTracksInfo + + property int vPadding: 20 + property int hPadding: 26 + property bool landscapeSettingsPopup: root.width >= settingsLayout.width + metadataLayout.width + 2 * hPadding + 20 + 24 + + padding: { + top: vPadding + bottom: vPadding + left: hPadding + right: hPadding + } + + Flickable { + id: flickable + implicitWidth: mainLayout.width + implicitHeight: landscapeSettingsPopup ? 250 : 340 + contentWidth: mainLayout.width + contentHeight: mainLayout.height + flickableDirection: Flickable.VerticalFlick + clip: true + + GridLayout { + id: mainLayout + + columns: landscapeSettingsPopup ? 2 : 1 + columnSpacing: 24 + rowSpacing: 24 + + ColumnLayout { + id: settingsLayout + spacing: 16 + Layout.alignment: Qt.AlignTop + + Label { + id: settingsLabel + text: qsTr("Settings") + font.pixelSize: 16 + font.bold: true + } + + GridLayout { + id: gridLayout + columns: 2 + rowSpacing: 16 + columnSpacing: 16 + + component CustomComboBox: ComboBox { + required property TracksInfo tracksInfo + + model: tracksInfo.model + enabled: model.count > 0 + textRole: "data" + currentIndex: model.count > 0 ? 0 : -1 + + onActivated: { + //! [1] + settingsController.mediaPlayer.pause() + tracksInfo.selectedTrack = currentIndex + settingsController.mediaPlayer.play() + //! [1] + } + } + + Label { + text: qsTr("Playback Speed") + Layout.fillWidth: true + font.pixelSize: 14 + } + + ComboBox { + id: rateCb + model: ["0.25", "0.5", "0.75", "Normal", "1.25", "1.5", "1.75", "2"] + currentIndex: 3 + + onCurrentIndexChanged: { + //! [0] + settingsController.mediaPlayer.playbackRate = (currentIndex + 1) * 0.25 + //! [0] + } + } + + Label { + text: qsTr("Pitch Compensation") + Layout.fillWidth: true + enabled: mediaPlayer.pitchCompensationAvailability === MediaPlayer.Available + font.pixelSize: 14 + } + + Switch { + id: pitchSwitch + + // initial value for pitchcompensation + checked: mediaPlayer.pitchCompensation + + // enabled being false means greyed out, uninteractable switch + enabled: mediaPlayer.pitchCompensationAvailability === MediaPlayer.Available + + ToolTip { + visible: pitchSwitch.hovered && text !== "" + text: pcTooltip(mediaPlayer.pitchCompensationAvailability) + } + + // sets the backend based on switch status + onToggled: { + settingsController.mediaPlayer.pitchCompensation = checked + } + } + + Label { + text: qsTr("Audio Tracks") + enabled: audioCb.enabled + Layout.fillWidth: true + font.pixelSize: 14 + } + + CustomComboBox { + id: audioCb + tracksInfo: settingsController.audioTracksInfo + } + + Label { + text: qsTr("Video Tracks") + enabled: videoCb.enabled + Layout.fillWidth: true + font.pixelSize: 14 + } + + CustomComboBox { + id: videoCb + tracksInfo: settingsController.videoTracksInfo + } + + Label { + text: qsTr("Subtitle Tracks") + enabled: subtitlesCb.enabled + font.pixelSize: 14 + } + + CustomComboBox { + id: subtitlesCb + tracksInfo: settingsController.subtitleTracksInfo + } + } + } + + ColumnLayout { + id: metadataLayout + spacing: 16 + Layout.alignment: Qt.AlignTop + + Label { + id: metadataLabel + text: qsTr("Metadata") + font.pixelSize: 16 + font.bold: true + } + + Rectangle { + id: metadataRect + implicitWidth: 240 + implicitHeight: metadataList.height + border.color: palette.dark + color: palette.window + radius: 6 + + Column { + id: metadataList + visible: settingsController.metadataInfo.count > 0 + + padding: 10 + Repeater { + Row { + spacing: metadataList.padding + Label { + text: model.name + font.bold: true + width: (metadataRect.width - 3 * metadataList.padding) / 2 + horizontalAlignment: Text.AlignRight + wrapMode: Text.WordWrap + font.pixelSize: 12 + } + + Label { + text: model.value + width: (metadataRect.width - 3 * metadataList.padding) / 2 + horizontalAlignment: Text.AlignLeft + anchors.verticalCenter: parent.verticalCenter + wrapMode: Text.WrapAnywhere + font.pixelSize: 12 + } + } + model: settingsController.metadataInfo.metadata + } + } + + Label { + id: metadataNoList + visible: settingsController.metadataInfo.count === 0 + anchors.centerIn: parent + text: qsTr("No metadata present") + font.pixelSize: 14 + } + } + } + } + } +} diff --git a/examples/multimedia/video/mediaplayer/controls/TracksInfo.qml b/examples/multimedia/video/mediaplayer/controls/TracksInfo.qml new file mode 100644 index 0000000..a2ae96f --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/TracksInfo.qml @@ -0,0 +1,25 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + property alias model: model + property int selectedTrack: 0 + + function read(tracks, key = 0) { + // language is the 6th index in the enum QMediaMetaData::Key + model.clear() + + if (!tracks) + return + + tracks.forEach((metadata, index) => { + const data = metadata.stringValue(key) + const label = data ? data : qsTr("track ") + (index + 1) + model.append({data: label, index: index}) + }) + } + + ListModel { id: model } +} diff --git a/examples/multimedia/video/mediaplayer/controls/UrlPopup.qml b/examples/multimedia/video/mediaplayer/controls/UrlPopup.qml new file mode 100644 index 0000000..5bc3041 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/UrlPopup.qml @@ -0,0 +1,54 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause +import QtQuick +import QtQuick.Layouts +import QtQuick.Controls +import QtMultimedia + + +Popup { + id: popupController + width: Math.min(500, root.width - 40) + + required property MediaPlayer mediaPlayer + + function loadUrl(url) { + popupController.mediaPlayer.stop() + popupController.mediaPlayer.source = url + popupController.mediaPlayer.play() + } + + RowLayout { + id: rowOpenUrl + anchors.fill: parent + Label { + text: qsTr("URL:"); + } + + TextField { + id: urlText + Layout.fillWidth: true + focus: true + + placeholderText: qsTr("Enter text here...") + wrapMode: TextInput.WrapAnywhere + + Keys.onReturnPressed: { + popupController.loadUrl(text) + urlText.text = "" + popupController.close() + } + } + + Button { + text: qsTr("Load") + enabled: urlText.text !== "" + onClicked: { + popupController.loadUrl(urlText.text) + urlText.text = "" + popupController.close() + } + } + } + onOpened: { popupController.forceActiveFocus() } +} diff --git a/examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player-settings.png b/examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player-settings.png new file mode 100644 index 0000000000000000000000000000000000000000..cd0c4f805a0a38e08a41c43ab2a8110ce0ae637e GIT binary patch literal 33956 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�vZA7VXktO~|$1c1m z(a$m7$&JW&W$c+84KVY$0YG<^PI7kj?QZIC#cksdZE6Due zgPcYSXcfE<1lRYcs|Q#%6qoWVAT#c9Td&Qt$!TlH2vg%IeS788N*1g*9{6-e5PY`%PP|TJlTDAu+tGOH<8*gc{7V zW(iz1lMT6Rg>|Qs@53PQ(8bD4A*kPjZy6JoYz=Z&<8qrAq7(6}}tyQzghldA!$)YlXo^O4wv$*^Fcxv4D-oqB8 zNHs?A-J1v)Kbs}u5k3RzwAbl3exk;#ldc_%jStU=3>Al^MD@PN&$|&DYi6cew`*ga zW~rS&Ob1U~*r#UL*j+9nv!^j}JL3I$lksuqKwdusnMhoPr|(iy0_y}qru@ryDfY|m zZ$#y^x`*4*q*go}|6aFMI)DZ9zZ$n20P5;lhhEjm2R4;6$5#9=9r1ZfGJs4W0eqnU zRj&G5SpkU84<))2RyM${Qi^|sgP=54BoXCWzmaWTG)_EA#U00V#BVFQ`Y_FZW)b8qmRe( z_4DP{Ek#u+wcU-kkdHnjkDse|GR^W?JUdpq5t3_QXDrb`nIO;#-9 z;Hl&Q)C2GapQtX&>pL4o`Wd1d4{-_6O+EE`>2L1aPclsw&>97HOOK`ucex-0-i!B+7s=0P0hQy2*O|9_>Zmtbnkz31$1)zx^yiP>U(3)gIp}< zDBB-@A&1>;wIBWH4oqK*b&G*bx2)*XBZ&H8z<&bw>?;7IB6))l!%V$z2uInBX7n!xVVu?d2%PL3}PKm0D>e%+HR_Cqm#z_M=)gd^V3R)D!!Gh~k+@rfO(w=8PWk}iM&Fghtw)%s z4s$hRQ%Sv>km>J6d^c?6_ozH7teyUe@Y%#bgS3B6R%d`mS|W zrB|1Qpe;)`=+@@$?tM{}z)?iHjiIG<;jJE5CE>3C(LV8H8q*b%hAJMTfqG-W!;*=~j26=wTylHIcr^CK%w%G%f zWKLLd-N?{bz6( znaJa>P`hHVztGCptflcAC%5pNZ@fFX;pIPPRZxaaeZ;Y;#ExbDBvyeqw7b;+*qliN zigtRkB(V!{dnc2I(rkU;d@e5};Wf(cje#@ScqnuJHK_k{gR_sns8`XNxhmh}_nbZq zSwbG`<+Dfg#K`iLs8IL;@sVLU{(%aRy~i4u|3iZ0LEtEntv-u_DaS`xbkzMh+gEwx zFpRfsp8u9#Q^AQfBc7=Jb(}K)b=Bdvy1A{nVDJPrzN~HR8W6bt`7WF^AVrcNJx~Y& zS!Z&L?*J|DQ@%IX9y0o|-&&tG*5dv4os$!gfk~{{=_lm0$w6;~!f8>Ek`5M%!y2>Kfqon51+$^b{e50+3v0 zJM9pPC`?Glr@RS(@2{14@N>+ZjbHy&7g_me8{g8D z_ZX_<{D`I=9I(NQO-vrN>+}Kxf$$l)RTPVeO#{DX3cW2ZtIHx2>M}4RPDX4ByvA&7 zh`OzLVfC*M9FOOrD_JBQ6Zj_quL!1#yvYYtb|aW)cx_&m8jPDc#w!mG58o>FHElXc zIfI{3rCIrb;LZD41!=)rL*Y--G}ghISg1J4-|PIT>2#&Y(`1mtOIG^7LE+*4FA1|s zO-`{YF+L_M*}+uX-9#;1&@mx;5yde7^?ys4o}3=@|0`|h(KpNbpwlM!wupXGQfleM z(-{6k%YW|>@b?4y?*Zf=uk)FB`|mvj+L+?nmfM&FZFy#A1pj^1gZl2Akdcm#F2fCD z_GTz0Cvj}*w`@)h;>tNPFs;gFlCrEWC&I`7P{Y^ocuNgUVwmSc2_wGVeeOFxyMt}0 zuai*&l9H2*$EwpG-E=9hDrNC+U6beEln{~qQYNJ9`+opwLyo@y literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player.png b/examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player.png new file mode 100644 index 0000000000000000000000000000000000000000..857e70abdd1e99d61926ed1ac46a4c2492ffb82b GIT binary patch literal 49506 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%0A9ig}iCB3D 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 V$X1^B9pK-gD5ol0E^QX{zX0PpC3pY; literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/mediaplayer/doc/src/mediaplayer.qdoc b/examples/multimedia/video/mediaplayer/doc/src/mediaplayer.qdoc new file mode 100644 index 0000000..80c5c5f --- /dev/null +++ b/examples/multimedia/video/mediaplayer/doc/src/mediaplayer.qdoc @@ -0,0 +1,153 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example video/mediaplayer + \title QML Media Player Example + \ingroup multimedia_examples + \ingroup video_examples_qml + \examplecategory {Multimedia} + \brief Playing audio and video using the QML \c MediaPlayer type. + \meta {tag} {quick} + \meta {tag} {player} + \image qtmultimedia-examples-qml-media-player.png + {Video player showing playback controls and video preview area} + + This example demonstrates a simple multimedia player that can play + audio and video files using various codecs. + + \include examples-run.qdocinc + + \section1 Instantiating the MediaPlayer + The entry point for the QML code in this example is \c Main.qml. Here + an \c ApplicationWindow is created and properties such as the \c id, \c title, + \c width and \c height are set. + + \snippet video/mediaplayer/Main.qml 0 + + Next the \c MediaPlayer is created and the two properties that are responsible for the video and + audio output are defined. + Firstly, \c videoOutput which renders the video viewfinder and secondly \c audioOutput which provides + the audio output for the player. + + \snippet video/mediaplayer/Main.qml 1 + \dots + \snippet video/mediaplayer/Main.qml 2 + \dots + \snippet video/mediaplayer/Main.qml 3 + + The \c visible property of the \c VideoOutput type is set to \c true when the \c mediaStatus + property of the \c MediaPlayer is greater than 0. \c mediaStatus is of enumeration type + and is equal to 0 when \e {No media has been set}, and greater than 0 otherwise. Therefore, + the \c VideoOutput is visible when media has been set. + + The \c MediaPlayer type has a signal property called \c onErrorOccurred that can be + overridden specifically to handle errors. In this case the signal opens a \c MessageDialog using + the method \c {open()} and sets its \c text property to a \c MediaPlayer property called + \c errorString. + + \snippet video/mediaplayer/Main.qml 4 + + \section1 Playback Controls + + In order to have a useable media player, there needs to be an interface to control the playback. + This is created in its own component file, \c PlaybackControl.qml, and instantiated in + \c Main.qml. + + \snippet video/mediaplayer/Main.qml 5 + \dots + \snippet video/mediaplayer/Main.qml 6 + + When created, objects are forwarded to this type such as track information, + metadata information and the \c MediaPlayer object itself. In \c PlaybackControl.qml, + each one of these objects have a \c {required property}, meaning that these properties must + be set when the \c PlaybackControl object is created. + + \snippet video/mediaplayer/controls/PlaybackControl.qml 0 + + These playback controls can be broken down into sections. In the top left of the panel lies + a collection of buttons used to open a file, either by selecting a file from a file explorer or + entering a URL. The file is loaded into the \c MediaPlayer by setting the \c source property. + Both buttons are instantiated using a \c CustomButton \c {custom component}. + + \snippet video/mediaplayer/controls/PlaybackControl.qml 1 + + Three buttons are created and centered on this panel, handling play, pause and seeking ten + seconds backwards or forwards. The media is played and paused using the methods \c {play()} + and \c {pause()}, respectively. To know when to draw a play or pause button, the \c playbackState + property is queried. For example, when it is equal to the enum value \c MediaPlayer.PlayingState + then the pause button is drawn. + + \snippet video/mediaplayer/controls/PlaybackControl.qml 2 + + To navigate ten seconds forward or backwards, the \c position of the \c MediaPlayer type is + incremented by 10,000 milliseconds and set using the method \c {setPosition()}. + + \snippet video/mediaplayer/controls/PlaybackControl.qml 3 + + \section1 Playback Seeking and Audio + + In \c {PlaybackControl.qml}, an \c AudioControl and a \c PlaybackSeekControl type are instantiated. + These are both defined in their own component file and are responsible for volume control and + playback seeking, respectively. The \c AudioControl type defines a button to mute and a \c Slider, + from \c {QtQuick Controls}, to set the volume of the player. Both of these attributes are exposed by + defining a \c mute and \c volume property and are accessed from the \c AudioOutput definition in + \c {Main.qml}. + + \snippet video/mediaplayer/controls/AudioControl.qml 0 + + The \c PlaybackSeekControl uses a \c RowLayout containing a \c Slider with a \c Text item either side. + The two \c Text items display the current time and the remaining time of the media being played. These + are both calculated using two properties of the \c MediaPlayer type, \c {position}, which gives the + current playback position in milliseconds, and \c {duration}, which gives the duration of the media + in milliseconds. + + \snippet video/mediaplayer/controls/PlaybackSeekControl.qml 0 + \dots + \snippet video/mediaplayer/controls/PlaybackSeekControl.qml 1 + + The \c Slider is only enabled when the media player is seekable and not, for example, live media. + The \c MediaPlayer type has a property for this called \c seekable. The \c value of the \c Slider + is calculated using the \c position and \c duration properties of the \c MediaPlayer. + + \snippet video/mediaplayer/controls/PlaybackSeekControl.qml 2 + + \section1 Metadata and Track Information + + The \c PlaybackControl type instantiates a \c SettingsPopup, which contains information about the + metadata of the currently loaded media and track selection, as well as the ability to update the + playback rate. This \c Popup is defined in \c SettingsPopup.qml. + + \image qtmultimedia-examples-qml-media-player-settings.png + {User-selectable playback settings and metadata information} + + The metadata is contained in its own component file, \c MetadataInfo.qml. It contains a \c ListModel, + a function to clear it, \c {clear()}, and a function to populate it, \c {read(MediaMetadata metadata)}. + The \c {read(MediaMetadata metadata)} function takes as a parameter an object of type \c MediaMetaData, + and navigates its key-value structure to extract its data into the \c model of the \c {ListView}. The + methods used to do this are \c {keys()}, which returns all the keys of the \c MediaMetaData, and + {stringValue(Key key)}, which returns the \c value for a given \c key. + + \snippet video/mediaplayer/controls/MetadataInfo.qml 0 + + The data is then displayed in \c {SettingsPopup.qml} in a \c ListView type. The \c delegate of this + \c ListView is a row of two \c Text items, corresponding to the key-value pairs abstracted from the + \c MediaMetaData item. + + On the other side of the \c Popup there is playback rate controls and track selection for audio, video and + subtitles. The playback rate is chosen from a \c ComboBox and set using the property \c playbackRate. + + \snippet video/mediaplayer/controls/SettingsPopup.qml 0 + + The type called \c TracksInfo, defined in \c {TracksInfo.qml}, contains the data about the tracks. + More specifically, a \c ListModel containing the titles of the tracks, or for subtitles specifically, the + langauges. This information is populated in \c Main.qml by calling the \c {read(MediaMetadata mediaMetadata)} + function defined in the \c TracksInfo type. + + \snippet video/mediaplayer/Main.qml 6 + + The \c model defined in \c TracksInfo is then queried in the \c {ComboBox}es in the + \c SettingsPopup to select the current track. + + \snippet video/mediaplayer/controls/SettingsPopup.qml 1 +*/ diff --git a/examples/multimedia/video/mediaplayer/images/backward10.svg b/examples/multimedia/video/mediaplayer/images/backward10.svg new file mode 100644 index 0000000..9166343 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/backward10.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/ff.svg b/examples/multimedia/video/mediaplayer/images/ff.svg new file mode 100644 index 0000000..7c907c4 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/ff.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/forward10.svg b/examples/multimedia/video/mediaplayer/images/forward10.svg new file mode 100644 index 0000000..190a5aa --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/forward10.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/link.svg b/examples/multimedia/video/mediaplayer/images/link.svg new file mode 100644 index 0000000..6ce1b98 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/link.svg @@ -0,0 +1,3 @@ + + + diff --git a/examples/multimedia/video/mediaplayer/images/loop.svg b/examples/multimedia/video/mediaplayer/images/loop.svg new file mode 100644 index 0000000..8161ca8 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/loop.svg @@ -0,0 +1,3 @@ + + + diff --git a/examples/multimedia/video/mediaplayer/images/more.svg b/examples/multimedia/video/mediaplayer/images/more.svg new file mode 100644 index 0000000..fa8bdde --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/more.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/mute.svg b/examples/multimedia/video/mediaplayer/images/mute.svg new file mode 100644 index 0000000..b66b6d3 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/mute.svg @@ -0,0 +1,6 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/open_new.svg b/examples/multimedia/video/mediaplayer/images/open_new.svg new file mode 100644 index 0000000..6c62237 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/open_new.svg @@ -0,0 +1,6 @@ + + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/pause_symbol.svg b/examples/multimedia/video/mediaplayer/images/pause_symbol.svg new file mode 100644 index 0000000..bdf6a90 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/pause_symbol.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/play_symbol.svg b/examples/multimedia/video/mediaplayer/images/play_symbol.svg new file mode 100644 index 0000000..edb5672 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/play_symbol.svg @@ -0,0 +1,3 @@ + + + diff --git a/examples/multimedia/video/mediaplayer/images/rewind.svg b/examples/multimedia/video/mediaplayer/images/rewind.svg new file mode 100644 index 0000000..e9b3412 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/rewind.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/settings.svg b/examples/multimedia/video/mediaplayer/images/settings.svg new file mode 100644 index 0000000..3a13cca --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/settings.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/speaker.svg b/examples/multimedia/video/mediaplayer/images/speaker.svg new file mode 100644 index 0000000..723e48b --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/speaker.svg @@ -0,0 +1,7 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/stop_symbol.svg b/examples/multimedia/video/mediaplayer/images/stop_symbol.svg new file mode 100644 index 0000000..99f0016 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/stop_symbol.svg @@ -0,0 +1,3 @@ + + + diff --git a/examples/multimedia/video/mediaplayer/images/url.svg b/examples/multimedia/video/mediaplayer/images/url.svg new file mode 100644 index 0000000..4494291 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/url.svg @@ -0,0 +1,6 @@ + + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/volume.svg b/examples/multimedia/video/mediaplayer/images/volume.svg new file mode 100644 index 0000000..2cdc4df --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/volume.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/volume_mute.svg b/examples/multimedia/video/mediaplayer/images/volume_mute.svg new file mode 100644 index 0000000..635c308 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/volume_mute.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/zoom_maximize.svg b/examples/multimedia/video/mediaplayer/images/zoom_maximize.svg new file mode 100644 index 0000000..9c7fb8e --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/zoom_maximize.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/zoom_minimize.svg b/examples/multimedia/video/mediaplayer/images/zoom_minimize.svg new file mode 100644 index 0000000..3d6ae65 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/zoom_minimize.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/main.cpp b/examples/multimedia/video/mediaplayer/main.cpp new file mode 100644 index 0000000..3df4d60 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/main.cpp @@ -0,0 +1,38 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include +#include +#include +#include + +int main(int argc, char *argv[]) +{ + QGuiApplication app(argc, argv); + + QCoreApplication::setApplicationName("MediaPlayer Example"); + QCoreApplication::setOrganizationName("QtProject"); + QCoreApplication::setApplicationVersion(QT_VERSION_STR); + QCommandLineParser parser; + parser.setApplicationDescription("Qt Quick MediaPlayer Example"); + parser.addHelpOption(); + parser.addVersionOption(); + parser.addPositionalArgument("url", "The URL(s) to open."); + parser.process(app); + + QQmlApplicationEngine engine; + const QUrl url(QStringLiteral("qrc:/Main.qml")); + + if (!parser.positionalArguments().isEmpty()) { + QUrl source = QUrl::fromUserInput(parser.positionalArguments().at(0), QDir::currentPath()); + QObject::connect(&engine, &QQmlApplicationEngine::objectCreated, + &engine, [source](QObject *object, const QUrl &) { + qDebug() << "setting source"; + object->setProperty("source", source); + }); + } + + engine.loadFromModule("mediaplayer", "Main"); + + return app.exec(); +} diff --git a/examples/multimedia/video/qmlvideo/CMakeLists.txt b/examples/multimedia/video/qmlvideo/CMakeLists.txt new file mode 100644 index 0000000..22ec234 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/CMakeLists.txt @@ -0,0 +1,64 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(qmlvideoexample LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/qmlvideo") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Qml Quick) + +qt_standard_project_setup(REQUIRES 6.8) + +qt_add_executable(qmlvideoexample + main.cpp + trace.h +) + +qt_add_ios_ffmpeg_libraries(qmlvideoexample) + +set_target_properties(qmlvideoexample PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in + MACOSX_BUNDLE_GUI_IDENTIFIER "io.qt.examples.qmlvideo" +) + +add_subdirectory(qmlvideo) +add_subdirectory(frequencymonitor) + +target_link_libraries(qmlvideoexample PRIVATE + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Qml + Qt::Quick + qmlvideo + frequencymonitor +) + +# Temporary workaround for QML module linker issues on static builds +# (Includes official iOS binaries) +# See QTBUG-141857 +target_link_libraries(qmlvideoexample PRIVATE qmlvideoplugin frequencymonitorplugin) + +install(TARGETS qmlvideoexample + BUNDLE DESTINATION . + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) + +qt_generate_deploy_qml_app_script( + TARGET qmlvideoexample + OUTPUT_SCRIPT deploy_script + MACOS_BUNDLE_POST_BUILD + NO_UNSUPPORTED_PLATFORM_ERROR +) + +install(SCRIPT ${deploy_script}) diff --git a/examples/multimedia/video/qmlvideo/Info.plist.in b/examples/multimedia/video/qmlvideo/Info.plist.in new file mode 100644 index 0000000..ec216fd --- /dev/null +++ b/examples/multimedia/video/qmlvideo/Info.plist.in @@ -0,0 +1,45 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/video/qmlvideo/doc/images/qmlvideo-menu.jpg b/examples/multimedia/video/qmlvideo/doc/images/qmlvideo-menu.jpg new file mode 100644 index 0000000000000000000000000000000000000000..54ab877a1881611b3331868d42864111b4b35087 GIT binary patch literal 21959 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/qmlvideo/doc/images/qmlvideo-overlay.jpg b/examples/multimedia/video/qmlvideo/doc/images/qmlvideo-overlay.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6a0d48ae640bd2b59a1f28b09e537b145bfe4ea5 GIT binary patch literal 23787 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/qmlvideo/doc/src/qmlvideo.qdoc b/examples/multimedia/video/qmlvideo/doc/src/qmlvideo.qdoc new file mode 100644 index 0000000..b6f1d28 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/doc/src/qmlvideo.qdoc @@ -0,0 +1,150 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! +\example video/qmlvideo +\title QML Video Example +\ingroup multimedia_examples +\examplecategory {Multimedia} +\brief Transforming video and camera viewfinder content. + +\e{QML Video} demonstrates the various transformations (move; resize; rotate; +change aspect ratio) that can be applied to QML \l VideoOutput and \l Camera +types. + +It also shows how native code can be combined with QML to implement more +advanced functionality - in this case, C++ code is used to calculate the QML +frame rate. This value is rendered in QML in a semi-transparent item +overlaid on the video content. + +The following image shows the application executing the video-overlay scene, +which creates a dummy overlay item (just a semi-transparent \l{Rectangle}), +which moves across the \l{VideoOutput} item. + +\image qmlvideo-overlay.jpg + {Video player with semi-transparent overlay} + +\include examples-run.qdocinc + +\section1 Application Structure + +The \c Main.qml file creates a UI which includes the following items: + +\list + \li Two \c Button instances, each of which displays a filename, and can be + used to launch a \c FileDialog. + \li An exit \c Button. + \li A \c SceneSelectionPanel, which is a flickable list displaying the + available scenes. + \li At the lower left, an item which displays the QML repainting rate - the + upper number is the instantaneous frame rate and the lower number is the + average over the past second. +\endlist + +\image qmlvideo-menu.jpg + {Scene selection panel showing list of video and camera mode scenes} + +Each scene in the flickable list is implemented in its own QML file - for +example the video-basic scene (which just displays a static \l{VideoOutput} +in the center of the screen) is implemented in the \c VideoBasic.qml file. As +you can see from the code, this makes use of a type of inheritance; a +\c VideoBasic item ... + +\quotefromfile video/qmlvideo/qmlvideo/VideoBasic.qml +\skipto SceneBasic +\printuntil /^\}/ + +... is of type \c SceneBasic ... + +\quotefromfile video/qmlvideo/qmlvideo/SceneBasic.qml +\skipto import +\printuntil contentType +\dots +\skipto Content +\printuntil content +\dots +\skipto } +\printuntil /^\}/ + +... which itself is a \c Scene: + +\quotefromfile video/qmlvideo/qmlvideo/Scene.qml +\skipto import +\printuntil root +\dots +\skipto property QtObject content +\printuntil content +\dots +\skipto Button +\printuntil /^\}/ + +\c SceneBasic describes the structure and behavior of the scene, but is +agnostic of the type of content which will be displayed - this is abstracted +by \c Content. + +This pattern allows us to define a particular use case (in this case, simply +display a static piece of content), and then instantiate that use case for +both video content (\c {VideoBasic}) and camera content \c ({CameraBasic}). +This approach is used to implement many of the other scenes - for example, +\e {"repeatedly slide the content from left to right and back again"} is +implemented by \c SceneMove, on which \c VideoMove and \c CameraMove are based. + +Depending on the value of the contentType property in the top-level scene +instance, the embedded \c Content item creates either a +\l[QML]{MediaPlayer} or a \l[QML]{Camera} item. + +\section1 Calculating and Displaying QML Painting Rate + +The QML painting rate is calculated by the FrequencyMonitor class, which +turns a stream of events (received via the notify() slot), into an +instantaneous and an averaged frequency: + +\quotefromfile video/qmlvideo/frequencymonitor/frequencymonitor.h +\skipto class FrequencyMonitor : public QObject +\printuntil QML_ELEMENT +\skipto Q_PROPERTY(qreal instantaneousFrequency +\printuntil averageFrequencyChanged) +\dots +\skipto public slots +\printuntil notify(); +\skipto }; +\printline }; + +The FrequencyMonitor class is exposed to QML by adding the macro QML_ELEMENT to the +class declaration as shown above, and its data is displayed by defining a QML item +called FrequencyItem, like this: + +\quotefromfile video/qmlvideo/frequencymonitor/FrequencyItem.qml +\skipto import frequencymonitor +\printuntil id: root +\dots +\skipto function notify +\printuntil id: monitor +\skipto onAverageFrequencyChanged +\printuntil { +\skipto averageFrequencyText +\printuntil /^\}/ + +The result looks like this: + +\image video-qml-paint-rate.png + {62.5 Hz instantaneous frequency and 53.15 Hz average frequency} + +All that remains is to connect the afterRendering() signal of the QQuickView +object to a JavaScript function, which will eventually call +\c frequencyItem.notify(): + +\quotefromfile video/qmlvideo/main.cpp +\skipto int main( +\printuntil ; +\dots +\skipto QQuickView +\printuntil ; +\dots +\skipto QQuickItem +\printuntil ; +\dots +\skipto QObject::connect +\printuntil SLOT(qmlFramePainted())); + +*/ diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/CMakeLists.txt b/examples/multimedia/video/qmlvideo/frequencymonitor/CMakeLists.txt new file mode 100644 index 0000000..97b54f7 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/CMakeLists.txt @@ -0,0 +1,23 @@ +# Copyright (C) 2023 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR) + message(FATAL_ERROR "This module is part of the 'qmlvideo' example, and should not be built independently.") +endif() + +qt_add_qml_module(frequencymonitor + URI frequencymonitor + STATIC + VERSION 1.0 + QML_FILES + "FrequencyItem.qml" + "PerformanceItem.qml" + SOURCES + frequencymonitor.h frequencymonitor.cpp +) + +target_link_libraries(frequencymonitor PRIVATE + Qt6::Core + Qt6::Gui + Qt6::Quick +) diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/FrequencyItem.qml b/examples/multimedia/video/qmlvideo/frequencymonitor/FrequencyItem.qml new file mode 100644 index 0000000..f1df7d5 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/FrequencyItem.qml @@ -0,0 +1,67 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import frequencymonitor + +Rectangle { + id: root + property bool logging: true + property bool displayed: true + property bool enabled: logging || displayed + property alias active: monitor.active + property int samplingInterval: 500 + property color textColor: "yellow" + property int textSize: 20 + property alias label: monitor.label + + border.width: 1 + border.color: "yellow" + width: 5.5 * root.textSize + height: 3.0 * root.textSize + color: "black" + opacity: 0.5 + radius: 10 + visible: displayed && active + + // This should ensure that the monitor is on top of all other content + z: 999 + + function notify() { + monitor.notify() + } + + FrequencyMonitor { + id: monitor + samplingInterval: root.enabled ? root.samplingInterval : 0 + onAverageFrequencyChanged: { + if (root.logging) trace() + averageFrequencyText.text = monitor.averageFrequency.toFixed(2) + } + } + + Text { + id: labelText + anchors { + left: parent.left + top: parent.top + margins: 10 + } + color: root.textColor + font.pixelSize: 0.6 * root.textSize + text: root.label + width: root.width - 2*anchors.margins + elide: Text.ElideRight + } + + Text { + id: averageFrequencyText + anchors { + right: parent.right + bottom: parent.bottom + margins: 10 + } + color: root.textColor + font.pixelSize: root.textSize + } +} diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/PerformanceItem.qml b/examples/multimedia/video/qmlvideo/frequencymonitor/PerformanceItem.qml new file mode 100644 index 0000000..5b501b1 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/PerformanceItem.qml @@ -0,0 +1,100 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Rectangle { + id: root + property bool logging: true + property bool displayed: true + property bool videoActive + property int margins: 5 + property bool enabled: true + + color: "transparent" + + // This should ensure that the monitor is on top of all other content + z: 999 + + Column { + id: column + anchors { + fill: root + margins: 10 + } + spacing: 10 + } + + QtObject { + id: d + property Item qmlFrameRateItem: null + property Item videoFrameRateItem: null + } + + Connections { + id: videoFrameRateActiveConnections + ignoreUnknownSignals: true + function onActiveChanged() { root.videoActive = videoFrameRateActiveConnections.target.active } + } + + states: [ + State { + name: "hidden" + PropertyChanges { + root.opacity: 0 + } + } + ] + + transitions: [ + Transition { + from: "*" + to: "*" + NumberAnimation { + properties: "opacity" + easing.type: Easing.OutQuart + duration: 500 + } + } + ] + + state: enabled ? "baseState" : "hidden" + + function createQmlFrameRateItem() { + let component = Qt.createComponent("frequencymonitor", "FrequencyItem") + if (component.status === Component.Ready) + d.qmlFrameRateItem = component.createObject(column, { label: qsTr("QML frame rate"), + displayed: root.displayed, + logging: root.logging + }); + } + + function createVideoFrameRateItem() { + let component = Qt.createComponent("frequencymonitor", "FrequencyItem") + if (component.status === Component.Ready) + d.videoFrameRateItem = component.createObject(column, { label: qsTr("Video frame rate"), + displayed: root.displayed, + logging: root.logging + }); + videoFrameRateActiveConnections.target = d.videoFrameRateItem + } + + + function init() { + createQmlFrameRateItem() + createVideoFrameRateItem() + } + + function videoFramePainted() { + d.videoFrameRateItem?.notify() + } + + function qmlFramePainted() { + d.qmlFrameRateItem?.notify() + } + + onVideoActiveChanged: { + if (d.videoFrameRateItem) + d.videoFrameRateItem.active = root.videoActive + } +} diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/frequencymonitor.cpp b/examples/multimedia/video/qmlvideo/frequencymonitor/frequencymonitor.cpp new file mode 100644 index 0000000..d6f1953 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/frequencymonitor.cpp @@ -0,0 +1,216 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "frequencymonitor.h" + +#include +#include +#include +#include +#include + +//#define VERBOSE_TRACE + +inline QDebug qtTrace() +{ + return qDebug() << "[frequencymonitor]"; +} +#ifdef VERBOSE_TRACE +inline QDebug qtVerboseTrace() +{ + return qtTrace(); +} +#else +inline QNoDebug qtVerboseTrace() +{ + return QNoDebug(); +} +#endif + +static const int DefaultSamplingInterval = 100; +static const int DefaultTraceInterval = 0; + +class FrequencyMonitorPrivate : public QObject +{ + Q_OBJECT + +public: + FrequencyMonitorPrivate(FrequencyMonitor *parent); + void calculateInstantaneousFrequency(); + +private slots: + void calculateAverageFrequency(); + void stalled(); + +public: + FrequencyMonitor *const q_ptr; + QString m_label; + bool m_active; + qreal m_instantaneousFrequency; + QElapsedTimer m_instantaneousElapsed; + QTimer *m_averageTimer; + QElapsedTimer m_averageElapsed; + int m_count; + qreal m_averageFrequency; + QTimer *m_traceTimer; + QTimer *m_stalledTimer; +}; + +FrequencyMonitorPrivate::FrequencyMonitorPrivate(FrequencyMonitor *parent) + : QObject(parent), + q_ptr(parent), + m_active(false), + m_instantaneousFrequency(0), + m_averageTimer(new QTimer(this)), + m_count(0), + m_averageFrequency(0), + m_traceTimer(new QTimer(this)), + m_stalledTimer(new QTimer(this)) +{ + m_instantaneousElapsed.start(); + connect(m_averageTimer, &QTimer::timeout, this, + &FrequencyMonitorPrivate::calculateAverageFrequency); + if (DefaultSamplingInterval) + m_averageTimer->start(DefaultSamplingInterval); + m_averageElapsed.start(); + connect(m_traceTimer, &QTimer::timeout, q_ptr, &FrequencyMonitor::trace); + if (DefaultTraceInterval) + m_traceTimer->start(DefaultTraceInterval); + m_stalledTimer->setSingleShot(true); + connect(m_stalledTimer, &QTimer::timeout, this, &FrequencyMonitorPrivate::stalled); +} + +void FrequencyMonitorPrivate::calculateInstantaneousFrequency() +{ + const qint64 ms = m_instantaneousElapsed.restart(); + m_instantaneousFrequency = ms ? qreal(1000) / ms : 0; + m_stalledTimer->start(3 * ms); + if (m_instantaneousFrequency) + q_ptr->setActive(true); + emit q_ptr->instantaneousFrequencyChanged(m_instantaneousFrequency); + emit q_ptr->frequencyChanged(); +} + +void FrequencyMonitorPrivate::calculateAverageFrequency() +{ + const qint64 ms = m_averageElapsed.restart(); + m_averageFrequency = qreal(m_count * 1000) / ms; + emit q_ptr->averageFrequencyChanged(m_averageFrequency); + emit q_ptr->frequencyChanged(); + m_count = 0; +} + +void FrequencyMonitorPrivate::stalled() +{ + if (m_instantaneousFrequency) { + m_instantaneousFrequency = 0; + emit q_ptr->instantaneousFrequencyChanged(m_instantaneousFrequency); + emit q_ptr->frequencyChanged(); + } +} + +FrequencyMonitor::FrequencyMonitor(QObject *parent) : QObject(parent) +{ + d_ptr = new FrequencyMonitorPrivate(this); +} + +FrequencyMonitor::~FrequencyMonitor() = default; + +QString FrequencyMonitor::label() const +{ + return d_func()->m_label; +} + +bool FrequencyMonitor::active() const +{ + return d_func()->m_active; +} + +int FrequencyMonitor::samplingInterval() const +{ + return d_ptr->m_averageTimer->isActive() ? d_ptr->m_averageTimer->interval() : 0; +} + +int FrequencyMonitor::traceInterval() const +{ + return d_ptr->m_traceTimer->isActive() ? d_ptr->m_traceTimer->interval() : 0; +} + +qreal FrequencyMonitor::instantaneousFrequency() const +{ + return d_func()->m_instantaneousFrequency; +} + +qreal FrequencyMonitor::averageFrequency() const +{ + return d_func()->m_averageFrequency; +} + +void FrequencyMonitor::notify() +{ + Q_D(FrequencyMonitor); + ++(d->m_count); + d->calculateInstantaneousFrequency(); +} + +void FrequencyMonitor::trace() +{ + Q_D(FrequencyMonitor); + const QString value = QStringLiteral("instant %1 average %2") + .arg(d->m_instantaneousFrequency, 0, 'f', 2) + .arg(d->m_averageFrequency, 0, 'f', 2); + if (d->m_label.isEmpty()) + qtTrace() << "FrequencyMonitor::trace" << value; + else + qtTrace() << "FrequencyMonitor::trace" + << "label" << d->m_label << value; +} + +void FrequencyMonitor::setLabel(const QString &value) +{ + Q_D(FrequencyMonitor); + if (d->m_label != value) { + d->m_label = value; + emit labelChanged(d->m_label); + } +} + +void FrequencyMonitor::setActive(bool value) +{ + Q_D(FrequencyMonitor); + if (d->m_active != value) { + d->m_active = value; + emit activeChanged(d->m_active); + } +} + +void FrequencyMonitor::setSamplingInterval(int value) +{ + Q_D(FrequencyMonitor); + if (samplingInterval() != value) { + if (value) { + d->m_averageTimer->setInterval(value); + d->m_averageTimer->start(); + } else { + d->m_averageTimer->stop(); + } + emit samplingIntervalChanged(value); + } +} + +void FrequencyMonitor::setTraceInterval(int value) +{ + Q_D(FrequencyMonitor); + if (traceInterval() != value) { + if (value) { + d->m_traceTimer->setInterval(value); + d->m_traceTimer->start(); + } else { + d->m_traceTimer->stop(); + } + emit traceIntervalChanged(value); + } +} + +#include "frequencymonitor.moc" +#include "moc_frequencymonitor.cpp" diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/frequencymonitor.h b/examples/multimedia/video/qmlvideo/frequencymonitor/frequencymonitor.h new file mode 100644 index 0000000..0b39c85 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/frequencymonitor.h @@ -0,0 +1,67 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef FREQUENCYMONITOR_H +#define FREQUENCYMONITOR_H + +#include +#include +#include + +class FrequencyMonitorPrivate; + +/** + * Class for measuring frequency of events + * + * Occurrence of the event is notified by the client via the notify() slot. + * On a regular interval, both an instantaneous and a rolling average + * event frequency are calculated. + */ +class FrequencyMonitor : public QObject +{ + Q_OBJECT + QML_ELEMENT + Q_DECLARE_PRIVATE(FrequencyMonitor) + Q_PROPERTY(QString label READ label WRITE setLabel NOTIFY labelChanged) + Q_PROPERTY(bool active READ active WRITE setActive NOTIFY activeChanged) + Q_PROPERTY(int samplingInterval READ samplingInterval WRITE setSamplingInterval NOTIFY + samplingIntervalChanged) + Q_PROPERTY( + int traceInterval READ traceInterval WRITE setTraceInterval NOTIFY traceIntervalChanged) + Q_PROPERTY(qreal instantaneousFrequency READ instantaneousFrequency NOTIFY + instantaneousFrequencyChanged) + Q_PROPERTY(qreal averageFrequency READ averageFrequency NOTIFY averageFrequencyChanged) + +public: + FrequencyMonitor(QObject *parent = nullptr); + ~FrequencyMonitor(); + + QString label() const; + bool active() const; + int samplingInterval() const; + int traceInterval() const; + qreal instantaneousFrequency() const; + qreal averageFrequency() const; + +signals: + void labelChanged(const QString &value); + void activeChanged(bool); + void samplingIntervalChanged(int value); + void traceIntervalChanged(int value); + void frequencyChanged(); + void instantaneousFrequencyChanged(qreal value); + void averageFrequencyChanged(qreal value); + +public slots: + Q_INVOKABLE void notify(); + Q_INVOKABLE void trace(); + void setActive(bool value); + void setLabel(const QString &value); + void setSamplingInterval(int value); + void setTraceInterval(int value); + +private: + FrequencyMonitorPrivate *d_ptr; +}; + +#endif // FREQUENCYMONITOR_H diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/qmldir b/examples/multimedia/video/qmlvideo/frequencymonitor/qmldir new file mode 100644 index 0000000..367226a --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/qmldir @@ -0,0 +1,4 @@ +module frequencymonitor + +FrequencyItem 1.0 FrequencyItem.qml +PerformanceItem 1.0 PerformanceItem.qml diff --git a/examples/multimedia/video/qmlvideo/main.cpp b/examples/multimedia/video/qmlvideo/main.cpp new file mode 100644 index 0000000..8271cd6 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/main.cpp @@ -0,0 +1,92 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "trace.h" +#include "qmlvideo/videosingleton.h" + +#include +#include +#include +#include +#include +#include +#include +#include + +static const QString DefaultFileName1 = ""; +static const QString DefaultFileName2 = ""; + +int main(int argc, char *argv[]) +{ + QGuiApplication app(argc, argv); + + QString source1, source2; + qreal volume = 0.5; + QStringList args = app.arguments(); + bool sourceIsUrl = false; + bool perfMonitorsLogging = false; + bool perfMonitorsVisible = true; + for (int i = 1; i < args.size(); ++i) { + const QByteArray arg = args.at(i).toUtf8(); + if (arg.startsWith('-')) { + if ("-volume" == arg) { + if (i + 1 < args.count()) + volume = 0.01 * args.at(++i).toInt(); + else + qtTrace() << "Option \"-volume\" takes a value"; + } + else if (arg == "-log-perf") { + perfMonitorsLogging = true; + } + else if (arg == "-no-log-perf") { + perfMonitorsLogging = false; + } + else if (arg == "-show-perf") { + perfMonitorsVisible = true; + } + else if (arg == "-hide-perf") { + perfMonitorsVisible = false; + } + else if ("-url" == arg) { + sourceIsUrl = true; + } else { + qtTrace() << "Option" << arg << "ignored"; + } + } else { + if (source1.isEmpty()) + source1 = arg; + else if (source2.isEmpty()) + source2 = arg; + else + qtTrace() << "Argument" << arg << "ignored"; + } + } + + QUrl url1 = sourceIsUrl ? QUrl{source1} : QUrl::fromLocalFile(source1); + QUrl url2 = sourceIsUrl ? QUrl{source2} : QUrl::fromLocalFile(source2); + + const QStringList moviesLocation = QStandardPaths::standardLocations(QStandardPaths::MoviesLocation); + const QUrl videoPath = QUrl::fromLocalFile(moviesLocation.isEmpty() ? app.applicationDirPath() + : moviesLocation.front()); + + QQuickView viewer; + VideoSingleton* singleton = viewer.engine()->singletonInstance("qmlvideo", "VideoSingleton"); + singleton->setVideoPath(videoPath); + singleton->setSource1(url1); + singleton->setSource2(url2); + singleton->setVolume(volume); + viewer.loadFromModule("qmlvideo", "Main"); + QObject::connect(viewer.engine(), &QQmlEngine::quit, &viewer, &QQuickView::close); + + QQuickItem *rootObject = viewer.rootObject(); + rootObject->setProperty("perfMonitorsLogging", perfMonitorsLogging); + rootObject->setProperty("perfMonitorsVisible", perfMonitorsVisible); + QObject::connect(&viewer, SIGNAL(afterRendering()), rootObject, SLOT(qmlFramePainted())); + + QMetaObject::invokeMethod(rootObject, "init"); + + viewer.setMinimumSize(QSize(640, 360)); + viewer.show(); + + return app.exec(); +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo.png b/examples/multimedia/video/qmlvideo/qmlvideo.png new file mode 100644 index 0000000000000000000000000000000000000000..707d5c4e85d82959740b243a8a36d5071c277299 GIT binary patch literal 3400 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 eAW3auXJt}lVPtu6$z?nM0000 + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CMakeLists.txt b/examples/multimedia/video/qmlvideo/qmlvideo/CMakeLists.txt new file mode 100644 index 0000000..fda2093 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CMakeLists.txt @@ -0,0 +1,70 @@ +# Copyright (C) 2023 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR) + message(FATAL_ERROR "This module is part of the 'qmlvideo' example, and should not be built independently.") +endif() + +qt_add_qml_module(qmlvideo + URI qmlvideo + VERSION 1.0 + STATIC + SOURCES + videosingleton.cpp + videosingleton.h + QML_FILES + "CameraBasic.qml" + "CameraDrag.qml" + "CameraDummy.qml" + "CameraFullScreen.qml" + "CameraFullScreenInverted.qml" + "CameraItem.qml" + "CameraMove.qml" + "CameraOverlay.qml" + "CameraResize.qml" + "CameraRotate.qml" + "CameraSpin.qml" + "Content.qml" + "ErrorDialog.qml" + "Main.qml" + "Scene.qml" + "SceneBasic.qml" + "SceneDrag.qml" + "SceneFullScreen.qml" + "SceneFullScreenInverted.qml" + "SceneMove.qml" + "SceneMulti.qml" + "SceneOverlay.qml" + "SceneResize.qml" + "SceneRotate.qml" + "SceneSelectionPanel.qml" + "SceneSpin.qml" + "SeekControl.qml" + "VideoBasic.qml" + "VideoDrag.qml" + "VideoDummy.qml" + "VideoFillMode.qml" + "VideoFullScreen.qml" + "VideoFullScreenInverted.qml" + "VideoItem.qml" + "VideoMetadata.qml" + "VideoMove.qml" + "VideoOverlay.qml" + "VideoPlaybackRate.qml" + "VideoResize.qml" + "VideoRotate.qml" + "VideoSeek.qml" + "VideoSpin.qml" + RESOURCES + "images/folder.png" + "images/leaves.jpg" + "images/up.png" +) + +target_compile_definitions(qmlvideo PRIVATE QMLVIDEO_LIB) + +target_link_libraries(qmlvideo PRIVATE + Qt6::Core + Qt6::Gui + Qt6::Quick +) diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraBasic.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraBasic.qml new file mode 100644 index 0000000..77072c6 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraBasic.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneBasic { + contentType: "camera" + started: true +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraDrag.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraDrag.qml new file mode 100644 index 0000000..2ea3672 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraDrag.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneDrag { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraDummy.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraDummy.qml new file mode 100644 index 0000000..c9d14e5 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraDummy.qml @@ -0,0 +1,31 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +// Item which is loaded by CameraItem if Qt Multimedia is not available +Rectangle { + id: root + color: "grey" + height: width + + signal fatalError + signal sizeChanged + signal framePainted + + Label { + anchors.fill: parent + anchors.margins: 10 + horizontalAlignment: Text.AlignHCenter + text: qsTr("Failed to create Camera item\n\nCheck that Qt Multimedia is installed") + verticalAlignment: Text.AlignVCenter + wrapMode: Text.Wrap + } + + onWidthChanged: height = width + onHeightChanged: root.sizeChanged() + + function start() { } + function stop() { } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreen.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreen.qml new file mode 100644 index 0000000..b204e74 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreen.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneFullScreen { + contentType: "camera" +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreenInverted.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreenInverted.qml new file mode 100644 index 0000000..ff7a402 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreenInverted.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneFullScreenInverted { + contentType: "camera" +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraItem.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraItem.qml new file mode 100644 index 0000000..d6e4b85 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraItem.qml @@ -0,0 +1,47 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +Item { + id: root + height: width + + signal fatalError + signal sizeChanged + + onHeightChanged: root.sizeChanged() + + CaptureSession { + camera: Camera { + id: camera + + onErrorOccurred: function(error, errorString) { + if (Camera.NoError !== error) { + console.log("[qmlvideo] CameraItem.onError error " + error + " errorString " + errorString) + root.fatalError() + } + } + } + imageCapture: ImageCapture { + id: imageCapture + } + + recorder: MediaRecorder { + id: recorder +// resolution: "640x480" +// frameRate: 30 + } + videoOutput: videoOutput + } + + VideoOutput { + id: videoOutput + anchors.fill: parent + } + + + function start() { camera.start() } + function stop() { camera.stop() } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraMove.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraMove.qml new file mode 100644 index 0000000..c4c5da9 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraMove.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneMove { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraOverlay.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraOverlay.qml new file mode 100644 index 0000000..13136be --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraOverlay.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneOverlay { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraResize.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraResize.qml new file mode 100644 index 0000000..d89eef3 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraResize.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneResize { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraRotate.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraRotate.qml new file mode 100644 index 0000000..8394fb6 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraRotate.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneRotate { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraSpin.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraSpin.qml new file mode 100644 index 0000000..642a0ed --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraSpin.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneSpin { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/Content.qml b/examples/multimedia/video/qmlvideo/qmlvideo/Content.qml new file mode 100644 index 0000000..b08d193 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/Content.qml @@ -0,0 +1,125 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import frequencymonitor + +Rectangle { + id: root + border.color: palette.window + border.width: showBorder ? 1 : 0 + color: "transparent" + property string contentType // "camera" or "video" + property string source + property real volume + property bool dummy: false + property bool autoStart: true + property bool started: false + property bool showFrameRate: false + property bool showBorder: false + property alias contentItem: contentLoader.item + + signal initialized + signal error + signal videoFramePainted + + Loader { + id: contentLoader + } + + Connections { + id: framePaintedConnection + function onFramePainted() { + (frameRateLoader.item as FrequencyItem)?.notify() + root.videoFramePainted() + } + ignoreUnknownSignals: true + } + + Connections { + id: errorConnection + function onFatalError() { + console.log("[qmlvideo] Content.onFatalError") + root.stop() + root.error() + } + ignoreUnknownSignals: true + } + + Component { + id: frequencyItem + FrequencyItem {} + } + + Loader { + id: frameRateLoader + sourceComponent: root.showFrameRate ? frequencyItem : undefined + onLoaded: { + item.parent = root + item.anchors.top = root.top + item.anchors.right = root.right + item.anchors.margins = 10 + } + } + + onWidthChanged: { + if (root.contentItem) + root.contentItem.width = width + } + + onHeightChanged: { + if (root.contentItem) + root.contentItem.height = height + } + + function initialize() { + if ("video" == contentType) { + contentLoader.source = "VideoItem.qml" + if (Loader.Error == contentLoader.status) { + contentLoader.source = "VideoDummy.qml" + dummy = true + } + contentLoader.item.volume = volume + } else if ("camera" == contentType) { + contentLoader.source = "CameraItem.qml" + if (Loader.Error == contentLoader.status) { + contentLoader.source = "CameraDummy.qml" + dummy = true + } + } else { + console.log("[qmlvideo] Content.initialize: error: invalid contentType") + } + if (contentLoader.item) { + contentLoader.item.sizeChanged.connect(updateRootSize) + contentLoader.item.parent = root + contentLoader.item.width = root.width + framePaintedConnection.target = contentLoader.item + errorConnection.target = contentLoader.item + if (root.autoStart) + root.start() + } + root.initialized() + } + + function start() { + if (contentLoader.item) { + if (root.contentType == "video") + contentLoader.item.mediaSource = root.source + contentLoader.item.start() + root.started = true + } + } + + // qmllint disable + function stop() { + if (contentLoader.item) { + contentLoader.item.stop() + if (root.contentType == "video") + contentLoader.item.mediaSource = "" + root.started = false + } + } + // qmllint enable + + function updateRootSize() { root.height = (root.contentItem as Item).height } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/ErrorDialog.qml b/examples/multimedia/video/qmlvideo/qmlvideo/ErrorDialog.qml new file mode 100644 index 0000000..f06079a --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/ErrorDialog.qml @@ -0,0 +1,70 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Rectangle { + id: root + color: "transparent" + opacity: 0.0 + property alias enabled: mouseArea.enabled + property int dialogWidth: 300 + property int dialogHeight: 200 + state: enabled ? "on" : "baseState" + + states: [ + State { + name: "on" + PropertyChanges { + root.opacity: 1.0 + } + } + ] + + transitions: [ + Transition { + from: "*" + to: "*" + NumberAnimation { + properties: "opacity" + easing.type: Easing.OutQuart + duration: 500 + } + } + ] + + Rectangle { + anchors.fill: parent + color: "black" + opacity: 0.75 + } + + Rectangle { + anchors.centerIn: parent + width: root.dialogWidth + height: root.dialogHeight + radius: 5 + color: "white" + + Text { + id: text + anchors.fill: parent + anchors.margins: 10 + horizontalAlignment: Text.AlignHCenter + verticalAlignment: Text.AlignVCenter + color: "black" + wrapMode: Text.WordWrap + } + } + + MouseArea { + id: mouseArea + anchors.fill: parent + onClicked: root.enabled = false + } + + function show(msg) { + text.text = "Error

" + msg + root.enabled = true + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/Main.qml b/examples/multimedia/video/qmlvideo/qmlvideo/Main.qml new file mode 100644 index 0000000..3d524e0 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/Main.qml @@ -0,0 +1,188 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtQuick.Dialogs +import frequencymonitor + +Rectangle { + id: root + anchors.fill: parent + color: palette.window + + property bool perfMonitorsLogging: false + property bool perfMonitorsVisible: false + + Loader { + id: performanceLoader + + Connections { + target: columnLayout + function onVisibleChanged() { + if (performanceLoader.item) + performanceLoader.item.enabled = !columnLayout.visible + } + ignoreUnknownSignals: true + } + + Component { + id: performanceItem + PerformanceItem {} + } + + function init() { + var enabled = root.perfMonitorsLogging || root.perfMonitorsVisible + sourceComponent = enabled ? performanceItem : undefined + } + + onLoaded: { + item.parent = root + item.anchors.fill = root + item.logging = root.perfMonitorsLogging + item.displayed = root.perfMonitorsVisible + item.enabled = false + item.init() + } + } + + ColumnLayout { + id: columnLayout + anchors.fill: parent + spacing: 5 + + Button { + id: openFile1Button + text: (VideoSingleton.source1 == '') ? qsTr("Select file 1") : VideoSingleton.source1 + Component.onCompleted: console.log("source1: " + VideoSingleton.source1) + onClicked: { + fileDialog.setFirstSource = true + fileDialog.open() + } + + Layout.fillWidth: true + } + + Button { + id: openFile2Button + text: (VideoSingleton.source2 == '') ? qsTr("Select file 2") : VideoSingleton.source2 + Component.onCompleted: console.log("source2: " + VideoSingleton.source2) + onClicked: { + fileDialog.setFirstSource = false + fileDialog.open() + } + + Layout.fillWidth: true + } + + RowLayout { + Layout.fillWidth: true + + Label { + text: qsTr("Video Modes") + + horizontalAlignment: Qt.AlignHCenter + Layout.preferredWidth: 50 + Layout.fillWidth: true + } + Label { + text: qsTr("Camera Modes") + + horizontalAlignment: Qt.AlignHCenter + Layout.preferredWidth: 50 + Layout.fillWidth: true + } + } + + SceneSelectionPanel { + id: sceneSelectionPanel + itemHeight: Math.min(width / 10, height / 10) + color: palette.dark + radius: 0 + onSceneSourceChanged: { + sceneLoader.source = sceneSource + var scene = null + var innerVisible = true + if (sceneSource == "") { + if (performanceLoader.item) + performanceLoader.item.videoActive = false + } else { + scene = sceneLoader.item + if (scene) { + if (scene.contentType === "video" && VideoSingleton.source1 === "") { + errorDialog.show(qsTr("You must first select a video file")) + sceneSource = "" + } else { + scene.parent = root + scene.color = root.palette.window + scene.source1 = VideoSingleton.source1 + scene.source2 = VideoSingleton.source2 + scene.volume = VideoSingleton.volume + scene.anchors.fill = root + scene.close.connect(closeScene) + scene.content.initialize() + innerVisible = false + } + } + } + videoFramePaintedConnection.target = scene + columnLayout.visible = innerVisible + } + + Layout.fillWidth: true + Layout.fillHeight: true + } + } + + Loader { + id: sceneLoader + } + + Connections { + id: videoFramePaintedConnection + // qmllint disable + function onVideoFramePainted() { + if (performanceLoader.item) + performanceLoader.item.videoFramePainted() + } + // qmllint enable + ignoreUnknownSignals: true + } + + FileDialog { + id: fileDialog + property bool setFirstSource + onAccepted: function() { + if (setFirstSource) + VideoSingleton.source1 = selectedFile + else + VideoSingleton.source2 = selectedFile + } + } + + ErrorDialog { + id: errorDialog + anchors.fill: root + dialogWidth: Math.min(root.width, root.height) * 0.5 + dialogHeight: Math.min(root.width, root.height) * 0.3 + enabled: false + } + + // Called from main() once root properties have been set + function init() { + performanceLoader.init() + fileDialog.currentFolder = VideoSingleton.videoPath + } + + // qmllint disable + function qmlFramePainted() { + if (performanceLoader.item) + performanceLoader.item.qmlFramePainted() + } + // qmllint enable + + function closeScene() { + sceneSelectionPanel.sceneSource = "" + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/Scene.qml b/examples/multimedia/video/qmlvideo/qmlvideo/Scene.qml new file mode 100644 index 0000000..e16478d --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/Scene.qml @@ -0,0 +1,31 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Rectangle { + id: root + color: palette.window + property string source1 + property string source2 + property int contentWidth: parent.width / 2 + property real volume: 0.25 + property int margins: 5 + property QtObject content + + signal close + signal videoFramePainted + + Button { + id: closeButton + anchors { + top: parent.top + right: parent.right + margins: root.margins + } + z: 2.0 + text: qsTr("Back") + onClicked: root.close() + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneBasic.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneBasic.qml new file mode 100644 index 0000000..8ad6c99 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneBasic.qml @@ -0,0 +1,47 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property string contentType + property bool autoStart: false + property bool started: false + + Content { + id: content + autoStart: parent.autoStart + started: parent.started + anchors.fill: parent + width: parent.contentWidth + contentType: parent.contentType + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Label { + anchors { + horizontalCenter: parent.horizontalCenter + bottom: parent.bottom + margins: 20 + } + text: content.started ? qsTr("Tap the screen to stop content") + : qsTr("Tap the screen to start content") + z: 2.0 + } + + MouseArea { + anchors.fill: parent + onClicked: { + if (content.started) + content.stop() + else + content.start() + } + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneDrag.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneDrag.qml new file mode 100644 index 0000000..99a7cb7 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneDrag.qml @@ -0,0 +1,34 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property int margin: 20 + property string contentType + + Image { + id: background + source: "images/leaves.jpg" + x: (parent.width - width) / 2 + y: (parent.height - height) / 2 + + Content { + id: content + anchors.centerIn: parent + width: root.contentWidth + contentType: root.contentType + source: root.source1 + volume: root.volume + onVideoFramePainted: root.videoFramePainted() + } + } + + MouseArea { + anchors.fill: parent + drag.target: background + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreen.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreen.qml new file mode 100644 index 0000000..660ba9f --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreen.qml @@ -0,0 +1,67 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + state: "left" + + states: [ + State { + name: "fullScreen" + PropertyChanges { + content.width: content.parent.width + content.height: content.parent.height + } + } + ] + + transitions: [ + Transition { + ParallelAnimation { + PropertyAnimation { + property: "width" + easing.type: Easing.Linear + duration: 250 + } + PropertyAnimation { + property: "height" + easing.type: Easing.Linear + duration: 250 + } + } + } + ] + + MouseArea { + anchors.fill: parent + onClicked: content.state = (content.state === "fullScreen") ? "baseState" : "fullScreen" + } + + onVideoFramePainted: root.videoFramePainted() + } + + Label { + anchors { + horizontalCenter: parent.horizontalCenter + bottom: parent.bottom + margins: 20 + } + text: qsTr("Tap on the content to toggle full-screen mode") + z: 2.0 + } + + Component.onCompleted: root.content = content +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreenInverted.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreenInverted.qml new file mode 100644 index 0000000..cb96ac1 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreenInverted.qml @@ -0,0 +1,70 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.width + height: parent.height + contentType: root.contentType + source: parent.source1 + volume: parent.volume + state: "left" + + states: [ + State { + name: "nonFullScreen" + PropertyChanges { content.width: root.contentWidth } + } + ] + + transitions: [ + Transition { + ParallelAnimation { + PropertyAnimation { + property: "width" + easing.type: Easing.Linear + duration: 250 + } + PropertyAnimation { + property: "height" + easing.type: Easing.Linear + duration: 250 + } + } + } + ] + + MouseArea { + anchors.fill: parent + onClicked: content.state = (content.state === "nonFullScreen") ? "baseState" : "nonFullScreen" + } + + onVideoFramePainted: root.videoFramePainted() + + onInitialized: { + width = parent.width + height = parent.height + } + } + + Label { + anchors { + horizontalCenter: parent.horizontalCenter + bottom: parent.bottom + margins: 20 + } + text: qsTr("Tap on the content to toggle full-screen mode") + z: 2.0 + } + + Component.onCompleted: root.content = content +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneMove.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneMove.qml new file mode 100644 index 0000000..d151283 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneMove.qml @@ -0,0 +1,49 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property int margin: 20 + property string contentType + + Content { + id: content + anchors.verticalCenter: parent.verticalCenter + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + + SequentialAnimation on x { + id: animation + loops: Animation.Infinite + property int from: root.margin + property int to: 100 + property int duration: 1500 + running: false + PropertyAnimation { + from: animation.from + to: animation.to + duration: animation.duration + easing.type: Easing.InOutCubic + } + PropertyAnimation { + from: animation.to + to: animation.from + duration: animation.duration + easing.type: Easing.InOutCubic + } + } + + onVideoFramePainted: root.videoFramePainted() + } + + onWidthChanged: { + animation.to = root.width - content.width - margin + animation.start() + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneMulti.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneMulti.qml new file mode 100644 index 0000000..3b1f57b --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneMulti.qml @@ -0,0 +1,185 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + + property real itemWidth: (width / 3) - 40 + property real itemTopMargin: 50 + + QtObject { + id: contentProxy + function initialize() { + video1.initialize() + video2.initialize() + } + } + + Component { + id: startStopComponent + + Rectangle { + id: root + color: "transparent" + + signal start + signal stop + + Label { + anchors { + horizontalCenter: parent.horizontalCenter + bottom: parent.bottom + margins: 20 + } + // qmllint disable + text: root.started ? qsTr("Tap to stop") : qsTr("Tap to start") + // qmllint enable + } + + MouseArea { + anchors.fill: parent + // qmllint disable + onClicked: { + if (root.started) + root.stop() + else + root.start() + } + // qmllint enable + } + } + } + + Content { + id: video1 + anchors { + left: parent.left + leftMargin: 10 + top: parent.top + topMargin: root.itemTopMargin + } + autoStart: false + contentType: "video" + showBorder: true + showFrameRate: started + source: parent.source1 + width: root.itemWidth + volume: parent.volume + + Loader { + id: video1StartStopLoader + + property bool started: parent.started + + onLoaded: { + item.parent = video1 + item.anchors.fill = video1 + item.start.connect(video1.start) + item.stop.connect(video1.stop) + } + } + + onInitialized: video1StartStopLoader.sourceComponent = startStopComponent + } + + Rectangle { + id: cameraHolder + + property bool started: false + + anchors { + horizontalCenter: parent.horizontalCenter + top: parent.top + topMargin: root.itemTopMargin + } + border.width: 1 + border.color: palette.base + color: "transparent" + width: root.itemWidth + height: width + + Loader { + id: cameraLoader + onLoaded: { + item.parent = cameraHolder + item.anchors.fill = cameraHolder + item.contentType = "camera" + item.showFrameRate = true + item.z = 1.0 + cameraErrorConnection.target = item + item.initialize() + } + } + + Loader { + id: cameraStartStopLoader + + property bool started: parent.started + + sourceComponent: startStopComponent + onLoaded: { + item.parent = cameraHolder + item.anchors.fill = cameraHolder + item.z = 2.0 + item.start.connect(cameraHolder.start) + item.stop.connect(cameraHolder.stop) + } + } + + Connections { + id: cameraErrorConnection + function onError() { + console.log("[qmlvideo] SceneMulti.camera.onError") + cameraHolder.stop() + } + ignoreUnknownSignals: true + } + + function start() { + cameraLoader.source = "Content.qml" + cameraHolder.started = true + } + + function stop() { + cameraLoader.source = "" + cameraHolder.started = false + } + } + + Content { + id: video2 + anchors { + right: parent.right + rightMargin: 10 + top: parent.top + topMargin: root.itemTopMargin + } + autoStart: false + contentType: "video" + showBorder: true + showFrameRate: started + source: parent.source2 + width: root.itemWidth + volume: parent.volume + + Loader { + id: video2StartStopLoader + + property bool started: parent.started + + onLoaded: { + item.parent = video2 + item.anchors.fill = video2 + item.start.connect(video2.start) + item.stop.connect(video2.stop) + } + } + + onInitialized: video2StartStopLoader.sourceComponent = startStopComponent + } + + Component.onCompleted: root.content = contentProxy +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneOverlay.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneOverlay.qml new file mode 100644 index 0000000..5863d61 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneOverlay.qml @@ -0,0 +1,83 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property int margin: 20 + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Rectangle { + id: overlay + y: 0.5 * parent.height + width: content.width + height: content.height + color: "#e0e0e0" + opacity: 0.5 + + SequentialAnimation on x { + id: xAnimation + loops: Animation.Infinite + property int from: root.margin + property int to: 100 + property int duration: 1500 + running: false + PropertyAnimation { + from: xAnimation.from + to: xAnimation.to + duration: xAnimation.duration + easing.type: Easing.InOutCubic + } + PropertyAnimation { + from: xAnimation.to + to: xAnimation.from + duration: xAnimation.duration + easing.type: Easing.InOutCubic + } + } + + SequentialAnimation on y { + id: yAnimation + loops: Animation.Infinite + property int from: root.margin + property int to: 180 + property int duration: 1500 + running: false + PropertyAnimation { + from: yAnimation.from + to: yAnimation.to + duration: yAnimation.duration + easing.type: Easing.InOutCubic + } + PropertyAnimation { + from: yAnimation.to + to: yAnimation.from + duration: yAnimation.duration + easing.type: Easing.InOutCubic + } + } + } + + onWidthChanged: { + xAnimation.to = root.width - content.width - margin + xAnimation.start() + } + + onHeightChanged: { + //yAnimation.to = root.height - content.height - margin + yAnimation.start() + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneResize.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneResize.qml new file mode 100644 index 0000000..4e2f155 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneResize.qml @@ -0,0 +1,41 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + + SequentialAnimation on scale { + id: animation + loops: Animation.Infinite + property int duration: 1500 + running: true + PropertyAnimation { + from: 1.5 + to: 0.5 + duration: animation.duration + easing.type: Easing.InOutCubic + } + PropertyAnimation { + from: 0.5 + to: 1.5 + duration: animation.duration + easing.type: Easing.InOutCubic + } + } + + onVideoFramePainted: root.videoFramePainted() + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneRotate.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneRotate.qml new file mode 100644 index 0000000..1362522 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneRotate.qml @@ -0,0 +1,57 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property int margin: 20 + property int delta: 30 + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Button { + id: rotatePositiveButton + anchors { + right: parent.right + bottom: rotateNegativeButton.top + margins: parent.margins + } + text: qsTr("Rotate +%1").arg(root.delta) + onClicked: content.rotation = content.rotation + root.delta + } + + Button { + id: rotateNegativeButton + anchors { + right: parent.right + verticalCenter: parent.verticalCenter + margins: parent.margins + } + text: qsTr("Rotate -%1").arg(root.delta) + onClicked: content.rotation = content.rotation - root.delta + } + + Button { + id: rotateValueButton + anchors { + left: parent.left + verticalCenter: parent.verticalCenter + margins: parent.margins + } + enabled: false + text: content.rotation % 360 + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneSelectionPanel.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneSelectionPanel.qml new file mode 100644 index 0000000..80b297d --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneSelectionPanel.qml @@ -0,0 +1,109 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtCore +import QtQuick +import QtQuick.Controls + +pragma ComponentBehavior: Bound + +Rectangle { + id: root + property int itemHeight: 25 + property string sceneSource: "" + + ListModel { + id: videolist + ListElement { name: qsTr("Multi"); source: "SceneMulti.qml" } + ListElement { name: qsTr("Video"); source: "VideoBasic.qml" } + ListElement { name: qsTr("Drag"); source: "VideoDrag.qml" } + ListElement { name: qsTr("Fillmode"); source: "VideoFillMode.qml" } + ListElement { name: qsTr("Fullscreen"); source: "VideoFullScreen.qml" } + ListElement { name: qsTr("Fullscreen-inverted"); source: "VideoFullScreenInverted.qml" } + ListElement { name: qsTr("Metadata"); source: "VideoMetadata.qml" } + ListElement { name: qsTr("Move"); source: "VideoMove.qml" } + ListElement { name: qsTr("Overlay"); source: "VideoOverlay.qml" } + ListElement { name: qsTr("Playback Rate"); source: "VideoPlaybackRate.qml" } + ListElement { name: qsTr("Resize"); source: "VideoResize.qml" } + ListElement { name: qsTr("Rotate"); source: "VideoRotate.qml" } + ListElement { name: qsTr("Spin"); source: "VideoSpin.qml" } + ListElement { name: qsTr("Seek"); source: "VideoSeek.qml" } + } + + ListModel { + id: cameralist + ListElement { name: qsTr("Camera"); source: "CameraBasic.qml" } + ListElement { name: qsTr("Drag"); source: "CameraDrag.qml" } + ListElement { name: qsTr("Fullscreen"); source: "CameraFullScreen.qml" } + ListElement { name: qsTr("Fullscreen-inverted"); source: "CameraFullScreenInverted.qml" } + ListElement { name: qsTr("Move"); source: "CameraMove.qml" } + ListElement { name: qsTr("Overlay"); source: "CameraOverlay.qml" } + ListElement { name: qsTr("Resize"); source: "CameraResize.qml" } + ListElement { name: qsTr("Rotate"); source: "CameraRotate.qml" } + ListElement { name: qsTr("Spin"); source: "CameraSpin.qml" } + } + + Component { + id: buttonDelegate + Button { + required property string name + required property string source + + width: root.width / 2 + height: root.itemHeight + + text: name + padding: 3 + onClicked: root.sceneSource = source + } + } + + Flickable { + anchors.fill: parent + contentHeight: (root.itemHeight * videolist.count) + 10 + clip: true + + Row { + id: layout + anchors { + fill: parent + topMargin: 5 + bottomMargin: 5 + } + + Column { + Repeater { + model: videolist + delegate: buttonDelegate + } + } + + CameraPermission { + id: cameraPermission + } + + // Using a Pane with no background gives us nice default margins + Pane { + visible: cameraPermission.status !== Qt.PermissionStatus.Granted + background: null + Column { + Label { + text: "Camera permissions not granted" + } + Button { + text: "Press to request permissions" + onClicked: cameraPermission.request() + } + } + } + + Column { + visible: cameraPermission.status === Qt.PermissionStatus.Granted + Repeater { + model: cameralist + delegate: buttonDelegate + } + } + } + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneSpin.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneSpin.qml new file mode 100644 index 0000000..3e280d3 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneSpin.qml @@ -0,0 +1,34 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property int margin: 20 + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + + PropertyAnimation on rotation { + id: animation + loops: Animation.Infinite + running: true + from: 0 + to: 360 + duration: 3000 + easing.type: Easing.Linear + } + + onVideoFramePainted: root.videoFramePainted() + } + + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SeekControl.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SeekControl.qml new file mode 100644 index 0000000..646e5e8 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SeekControl.qml @@ -0,0 +1,105 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + id: seekControl + height: Math.min(parent.width, parent.height) / 20 + property int duration: 0 + property int playPosition: 0 + property int seekPosition: 0 + property bool enabled: true + property bool seeking: false + + Rectangle { + id: background + anchors.fill: parent + color: palette.base + opacity: 0.3 + radius: parent.height / 15 + } + + Rectangle { + id: progressBar + anchors { left: parent.left; top: parent.top; bottom: parent.bottom } + width: seekControl.duration == 0 ? 0 : background.width * seekControl.playPosition / seekControl.duration + color: palette.highlight + opacity: 0.7 + } + + Text { + width: 90 + anchors { left: parent.left; top: parent.top; bottom: parent.bottom; leftMargin: 10 } + horizontalAlignment: Text.AlignLeft + verticalAlignment: Text.AlignVCenter + color: palette.windowText + smooth: true + text: seekControl.formatTime(seekControl.playPosition) + } + + Text { + width: 90 + anchors { right: parent.right; top: parent.top; bottom: parent.bottom; rightMargin: 10 } + horizontalAlignment: Text.AlignRight + verticalAlignment: Text.AlignVCenter + color: palette.windowText + smooth: true + text: seekControl.formatTime(seekControl.duration) + } + + Rectangle { + id: progressHandle + height: parent.height + width: parent.height / 2 + color: palette.accent + opacity: 0.5 + anchors.verticalCenter: progressBar.verticalCenter + x: seekControl.duration == 0 ? 0 : seekControl.playPosition / seekControl.duration * background.width + + MouseArea { + id: mouseArea + anchors { horizontalCenter: parent.horizontalCenter; bottom: parent.bottom } + height: parent.height + width: parent.height * 2 + enabled: seekControl.enabled + drag { + target: progressHandle + axis: Drag.XAxis + minimumX: 0 + maximumX: background.width + } + onPressed: { + seekControl.seeking = true; + } + onCanceled: { + seekControl.seekPosition = progressHandle.x * seekControl.duration / background.width + seekControl.seeking = false + } + onReleased: (mouse) => { + seekControl.seekPosition = progressHandle.x * seekControl.duration / background.width + seekControl.seeking = false + mouse.accepted = true + } + } + } + + Timer { // Update position also while user is dragging the progress handle + id: seekTimer + repeat: true + interval: 300 + running: seekControl.seeking + onTriggered: { + seekControl.seekPosition = progressHandle.x*seekControl.duration / background.width + } + } + + function formatTime(timeInMs) { + if (!timeInMs || timeInMs <= 0) return "0:00" + let seconds = timeInMs / 1000; + let minutes = Math.floor(seconds / 60) + seconds = Math.floor(seconds % 60) + if (seconds < 10) seconds = "0" + seconds; + return minutes + ":" + seconds + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoBasic.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoBasic.qml new file mode 100644 index 0000000..15c25c9 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoBasic.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneBasic { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoDrag.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoDrag.qml new file mode 100644 index 0000000..4a5c5d4 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoDrag.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneDrag { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoDummy.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoDummy.qml new file mode 100644 index 0000000..a30b9eb --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoDummy.qml @@ -0,0 +1,37 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +// Item which is loaded by VideoItem if Qt Multimedia is not available +Rectangle { + id: root + color: "grey" + height: width + property int duration: 0 + property int position: 0 + property string source + property real volume: 1.0 + property real playbackRate: 1.0 + + signal fatalError + signal sizeChanged + signal framePainted + + Label { + anchors.fill: parent + anchors.margins: 10 + horizontalAlignment: Text.AlignHCenter + text: qsTr("Failed to create Video item\n\nCheck that Qt Multimedia is installed") + verticalAlignment: Text.AlignVCenter + wrapMode: Text.Wrap + } + + onWidthChanged: height = width + onHeightChanged: root.sizeChanged() + + function start() { } + function stop() { } + function seek() { } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoFillMode.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFillMode.qml new file mode 100644 index 0000000..af950c7 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFillMode.qml @@ -0,0 +1,49 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Scene { + id: root + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: "video" + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Button { + id: button + anchors { + right: parent.right + verticalCenter: parent.verticalCenter + margins: parent.margins + } + text: qsTr("PreserveAspectFit") + // qmllint disable + onClicked: { + if (!content.dummy) { + let video = content.contentItem + if (video.fillMode === VideoOutput.Stretch) { + video.fillMode = VideoOutput.PreserveAspectFit + text = qsTr("PreserveAspectFit") + } else if (video.fillMode === VideoOutput.PreserveAspectFit) { + video.fillMode = VideoOutput.PreserveAspectCrop + text = qsTr("PreserveAspectCrop") + } else { + video.fillMode = VideoOutput.Stretch + text = qsTr("Stretch") + } + } + } + // qmllint enable + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreen.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreen.qml new file mode 100644 index 0000000..e49faad --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreen.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneFullScreen { + contentType: "video" +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreenInverted.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreenInverted.qml new file mode 100644 index 0000000..0bf8294 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreenInverted.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneFullScreenInverted { + contentType: "video" +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoItem.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoItem.qml new file mode 100644 index 0000000..2ea796d --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoItem.qml @@ -0,0 +1,42 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +VideoOutput { + id: root + height: width + + property alias duration: mediaPlayer.duration + property alias mediaSource: mediaPlayer.source + property alias metaData: mediaPlayer.metaData + property alias playbackRate: mediaPlayer.playbackRate + property alias position: mediaPlayer.position + property alias seekable: mediaPlayer.seekable + property alias volume: audioOutput.volume + + signal sizeChanged + signal fatalError + + onHeightChanged: root.sizeChanged() + + MediaPlayer { + id: mediaPlayer + videoOutput: root; + audioOutput: AudioOutput { + id: audioOutput + } + + onErrorOccurred: function(error, errorString) { + if (MediaPlayer.NoError !== error) { + console.log("[qmlvideo] VideoItem.onError error " + error + " errorString " + errorString) + root.fatalError() + } + } + } + + function start() { mediaPlayer.play() } + function stop() { mediaPlayer.stop() } + function seek(position) { mediaPlayer.setPosition(position); } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoMetadata.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoMetadata.qml new file mode 100644 index 0000000..f83cbff --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoMetadata.qml @@ -0,0 +1,80 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +pragma ComponentBehavior: Bound + +Scene { + id: root + property string contentType: "video" + + Content { + id: videoContent + anchors.centerIn: parent + width: parent.contentWidth + contentType: "video" + source: parent.source1 + volume: parent.volume + onInitialized: { + if (!dummy) + metadata.createObject(root) + } + onVideoFramePainted: root.videoFramePainted() + } + + Component { + id: metadata + Column { + anchors.fill: parent + // qmllint disable + property var videoMetaData: videoContent.contentItem?.metaData + // qmllint enable + Label { + text: qsTr("Title: %1").arg(parent.videoMetaData?.value(MediaMetaData.Title) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Resolution: %1").arg(parent.videoMetaData?.value(MediaMetaData.Resolution) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Media type: %1").arg(parent.videoMetaData?.value(MediaMetaData.MediaType) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Video codec: %1").arg(parent.videoMetaData?.value(MediaMetaData.VideoCodec) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Video bit rate: %1").arg(parent.videoMetaData?.value(MediaMetaData.VideoBitRate) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Video frame rate: %1").arg(parent.videoMetaData?.value(MediaMetaData.VideoFrameRate) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Audio codec: %1").arg(parent.videoMetaData?.value(MediaMetaData.AudioCodec) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Audio bit rate: %1").arg(parent.videoMetaData?.value(MediaMetaData.AudioBitRate) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Date: %1").arg(parent.videoMetaData?.value(MediaMetaData.Date) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Description: %1").arg(parent.videoMetaData?.value(MediaMetaData.Description) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Copyright: %1").arg(parent.videoMetaData?.value(MediaMetaData.Copyright) ?? qsTr("Unknown")) + } + Label { + // qmllint disable + text: qsTr("Seekable: %1").arg(videoContent.contentItem?.seekable ?? qsTr("Unknown")) + // qmllint enable + } + Label { + text: qsTr("Orientation: %1").arg(parent.videoMetaData?.value(MediaMetaData.Orientation) ?? qsTr("Unknown")) + } + } + } + + Component.onCompleted: root.content = videoContent +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoMove.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoMove.qml new file mode 100644 index 0000000..2b9230f --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoMove.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneMove { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoOverlay.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoOverlay.qml new file mode 100644 index 0000000..576b33f --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoOverlay.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneOverlay { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoPlaybackRate.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoPlaybackRate.qml new file mode 100644 index 0000000..55e38ef --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoPlaybackRate.qml @@ -0,0 +1,65 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property int margin: 20 + property real delta: 0.1 + property string contentType: "video" + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: "video" + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Button { + id: increaseButton + anchors { + right: parent.right + bottom: decreaseButton.top + margins: parent.margins + } + text: qsTr("Increase") + onClicked: { + let video = (content.contentItem as VideoItem) + video.playbackRate += root.delta + } + } + + Button { + id: decreaseButton + anchors { + right: parent.right + verticalCenter: parent.verticalCenter + margins: parent.margins + } + text: qsTr("Decrease") + onClicked: { + let video = (content.contentItem as VideoItem) + video.playbackRate -= root.delta + } + } + + Button { + id: valueButton + anchors { + left: parent.left + verticalCenter: parent.verticalCenter + margins: parent.margins + } + enabled: false + // qmllint disable + text: Math.round(10 * content.contentItem?.playbackRate ?? 1) / 10 + // qmllint enable + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoResize.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoResize.qml new file mode 100644 index 0000000..88fe7a2 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoResize.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneResize { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoRotate.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoRotate.qml new file mode 100644 index 0000000..d429ec4 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoRotate.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneRotate { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoSeek.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoSeek.qml new file mode 100644 index 0000000..5e2584f --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoSeek.qml @@ -0,0 +1,36 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property string contentType: "video" + contentWidth: parent.width + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: "video" + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + SeekControl { + anchors { + left: parent.left + right: parent.right + margins: 10 + bottom: parent.bottom + } + // qmllint disable + duration: content.contentItem?.duration ?? 0 + playPosition: content.contentItem?.position ?? 0 + onSeekPositionChanged: content.contentItem?.seek(seekPosition); + // qmllint enable + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoSpin.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoSpin.qml new file mode 100644 index 0000000..7c365dd --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoSpin.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneSpin { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/images/folder.png b/examples/multimedia/video/qmlvideo/qmlvideo/images/folder.png new file mode 100644 index 0000000000000000000000000000000000000000..62d97004fb01e085c3060619ac68dbec2fa7e8aa GIT binary patch literal 1829 zcmeAS@N?(olHy`uVBq!ia0vp^YCtTv4 zq}24xJX@vryZ0+8WTx0Eg`4^s_!c;)W@LI)6{QAO`Gq7`WhYyvDB0U7*i={n4aiL` zNmQuF&B-gas<2f8n`;GRgM{^!6u?SKvTcwn`GuBNuFf>#!Gt)CP zF*P$Y)KM@pFf`IP03tJ8LlY}gGbUo-h6WQb!1OB;3-k^33_xCjDfIQluQWFouDZA+C>7yetOgf{R2HP_ z2c;J0mlh=hBQ8xDWL1Hcb5UwyNq$jCetr%t6azByOY(~|@(UE4gUu8)d=ry1^FRWc zU>&}`R-SpqC5d^-sh%#jN#+F1Fo{r=~4uH@E9JI=0Qtrd5!+PCQzUtL^g zrG&rEzjI51B%a@V^Ydow_K&}^^&g)2WmQ#O{o?!Yh~?kkzRg{;cJ0FYTK3_CQ{DemONp)#m=zXl|Lu8iaW@EDf0b47=f=iwkJHbU0CQP?US8fh70*rgUY5w!y}!Hp zdEG8EoBAZ>gHPY*D|}Ho;(q^20C&jiJL1>Z=lwP6dA~aQMl^#Y^OPqQ_U0Wm7puQ` z{E0QwTfArshm9jQ=M`tpdAGYvr_GYm?zYRad(eGI?^^BttpTqu1;u)nWnYN@dqaM2 zabdyA*)RU?N{^TDJ7aox1v|%-mzkX=^Ji6rglv%DunwEDS3@AfO^9FbXGYs9)tt(z z#g7v$KW@Ad@It7AYeM^ycNcRS4@>;yJYT=>^A)ADw!38JR6VNrEPS_TZ@__hbqPDg ze0yAE3LMzFH#)V;Y?YQe&Hd(zyVLz!y!}Rs?_V@HONp~PO8)M5DCFSf`nB`8P|w4JWj&$;tXO(Zg<38Dv|pE}eN#yAREeax8+R5OU7d95=%1V^hZGZ* zY*b{PC4WONaHiKmb57>-Q>Sn)n`EMv_I$GA$|cG>R-Lk+liHKVw{#m{;7XTMomxJg z&zE|$PCIwXEBV{A*fX37PB-QpoZ7lJ)b*NZf`H}L)W}Sqvl1`+j%Bbv*}`m;yejVm zqj8I-vR0zUAIb2#*KNm)PM@4*%G_mq>`}Q=s-%{f<6DbOhYG^i#xP8~Eb+40S;MGU z>%Hx4Ublri!foceDcl zz+g@Q1^@uS1mGbd0|*f)3L*FijD^tY2q8p50U#mtAE87-`;RV0V5+~k8iCpW+8`q^ zKjO962;Gbj0R$#S=w5^nA^+p&kB#FS)c^RIMc{Z806+t*rl~>yOjAcoQ%7D8tf}$0 zM^T8+2=FK1|5*Q5D}&Xw=mmI1c=`DN0(|`Z5`1D3{G#;y0uua!68z!-c0gv>KXG;< zCd>JYKO!(=^#A0-_7~eAyaN(}091tH6A<7>N&F|~QG`9}U%ZaMNJ;=5ap9*1v{x2Kg zzc9vMjCgE-C;#fl{1?Xl7p5;p1~4FOHU0#OXqX7OMF{&}EWpPnD)DDA2+|{d3kXXH ziy&6V|FiE;o&UuCr=cT+86kgs{aLSnw7l*!Fc_if{|_1f8Gwvf;z)n|{SiSsJ0W2! zTVY!<5m5mvD^USK5r~)#pMW@@kS)ZH&kFJM5O&D_S!+7tVhHpzxwyTPl7)~h{4}0fM)gMpDxo?l2@QbtCG zg;x>$OiD#mT1N7Z6C_M5EL=5Fq{T z2hbtnL_?fge~zxd4Y2`H(a?byPcX3%1}*rA5}=?UqoSapp(1LF6#Qp{q7tAHGVsfz z6KPuk8KJ}ip-BZ8ObQKsBsyQdGYeXKhCRU~B_pSxWMO4v=in3)77-N_mw2YA1X5N3 ztLp0M8yFfHn?P)A?d%;KoxHq#eEs|b0>dLBquxZvz~IR#scG-hGcpT{ic3n%$}1`x zo0?l%+uA!iKYr>T7#tcN8J(V)ots}+Tw31R-r3#TKlplhbbj&U^6KaHubbOHc_AT6 z{onRaV*j_i2>vWBR8$mH;GevZko^#XLV$|Kz>iKSuMM<<5-|#dVh}4N6*TlcVG`8& zPGar(1(TFnXp80iPip_k?EfsWu>Vh){qMy7C$D7yHVR^W6QB?PWC5GrcNqdz&ZIZ# zmK;04)dfvwWK#w|PU_e$Ty*GsgHZHVeG0f;Dx8hky47m7h9z;xU*E>PQxo|;x2or> z!z0}p17(QN!g30p+DyG(X`Y6l0w=AN8(Y@og~M?TCE({-)wf;KFx{K(Of z0Iu|uPC;&xE9Y*4`K?+-UirpwW8uoA9@{z~HdmS}4@SXji#CbR*DL$Nq^aV?ND${k z6gp?`-ucOIz(S=5R*h8pfvwFe8DkWDsCj+q4vr{crq1Hx`xHj5w*Tdl zIb&M}B%Z=w?0I8gFsE}3v7>M3Nv&wHGIX^p?|aq7?pmeXo*Kc(=Ig7YV(99TNqTEX zf=JQ6wGGp`*imqmsQ6hB&!P#}Y}CAMPc(r$6LoA{$I!2tc)0qfw+RA##i(Ww`d1|L z12`>F?{=3=3L}`p?~TMK1Cxy^-&SlA0k>Tf1-12wmW zAQNUbkAhQ^Q-gwM8ujh7IBV_E=y7DH zxYZI~na34s85}%74L97C%;}E$jwOoVH-H9;shj<>@K4{(egjH}jV$j&Xw%E>=UuJ1 zLnKG2AgRM_?SsyuI_IUO)651x&lU3_s6>PQXNRizRoX$7lN$j!j!M!#tmo+IOqpC! z@jUsi%*dLpPV+GV!UNHvU|P-5>dhV6!Q8eH|0s$!nePA=f0-+s))KUujh`-@1SIv} z^ zq%l&+tO>u2e#-6`1*SG-Jwa>k75x6PDI_?ig1))6<;~ct-e^ZM8z5NO=7ST)mEP4jsCKsVVWosXG}K=Fs94K-3W zy7-xi!cy^zJiP4K@Zq1;UF;^3sc~D5s{CT#dQ8?s28okWtpk|#7n0w8o{!619BgoY zYsc4I9-4hW{_5-XeHFA+yR5NU0rD{eNo;6mzVXU`+t0cYyVlRX;~S?bNl;`Q>KmJv ziFg#(#AUSJWevIYZY)>M>Lt%SiNC)`x~gUg8S>)7_l-L8@UQBOz$=SLPqmx~Ntb#Q z-!97Crm((2;R-<_-}!OxIC$)uKHWu4A7}N6x`-Am+=cTw>I;%w!wHfecIb&-Ve1>M zCWlnWY8fi~ko3{6$Zx>;Q)jPt%RK{+!CYxIdXGO!@e|BpnK>hH0!F2fC%qOOGy^PA zwYYH}yhSoLHtjf()_i=*I|I+H9II3HeVZEk9>0pA{su^tdD%O=^ZBlxKf6cC8Ir=w zuVG*Zdp1eTp15fZnD$HALT8c)>Q$QDAR?hejm?~dpF3~1ZPFQ7|Xt_KCa4%trY3*)vDGl<+9$3 z%`cQ&0m5u;QlHq9f$=AG}>$IHv#0NEUO7L5{7 z+Fey)@jBNQi3CEYV_TkbWd&7{ts_ZVSxWmib?@|HAcuqu43q$w?jF_MI!ZDPL2uGuUf@Atf}%WD<5 zVr-wUy5Wl53^U(-(I4#$i%xq-up-Z)gs#&yB7L(9J<-qI7tfoBde)U)9d{qc{T*Wq zTytZfLzNrMMd~O>7(K-T+oZjzanw=opb_T!$bYR7S!2~P9b2F<)y0y2NwNDVY(OPK zh9zcq7&7b>m-2>H9EqWx|JYRITB|ZmZ?TdOTxjd?*3B3K|d&kZ2LaOMLMgoFzAI$kZo?}GCKb5PB%&i5(&6Sot1jWra z{IfnrHGKP#{cRmrJN6FrvP_+&`#pEG09nWCPHF-KeL$9|IJ1`rE074`>m! z$u_e&{GqgQd%>1@xI}hxGLNz6cQZ>UhtgK!rOE9v##^vE%Dj=LUY30cymz*}DmMp2 z&_qU0%1xPg8~)5peu$$;>=bztyCakF^;Je~pj(N^9`kR&CSI0jWNQb>r3|!%Parmh zjTv{aY8}j6f&HBe%?_HUxNoY-3G=eBC=-t&6$}vLITe6K9-vg5TV~`X;bE<2~IdHI{Lc$FC>nh zPjv~Pxp1)M8lKm5t>MmpA7HFZNGD^qNjlWldCxw=Iu>U;ev@{j5_y&n^`&^kF3V8ayar6jk^BuRtewA6VWfrxi5y(2dpzK^?XBkJ!hv8rlbeZ1ty( zKiej-6j7{F&T}0)(_9sP1E%uEF1DEafm^p%)!BPIYz=iR#Wf2Zrc*xF+ju-)KlsHV zpaPr5Bhm#yRB?)7i+t~?8ZIRtmg$p_8}gg%q+j}3;z~0u6*4x^x=FwY;BLByxBN?= z%;d&=#9Qt@KSoKZH%?*D1YMn9;cE5aiUI&g*0?c+pG}7p^@E_HZRX0iEk?^9xy0Bu z(DnM-%ax1+0d;nx)IhHr%xGhE$>oihIIwv4^Pnt;T6&*8R{o?Z#-gU_+Oiqe_X&AV znIN7v2jsO0W(~25Z3NuV(p8nUDH_=l`TXh+&u)^!T@&?hU#>m2EL=rZcrlXDIWmt* zXcX9%DI}S#sO1bQ?C#i80|XcDo!gqT#u?Se@ynN?y|pe&Mr%inyq~z8Jja2fRP9rH zrue4KULZr?em5d9a@hmn1M5{zr`jx$*Z}?9!EDm`{jFMZU~=itk)6->`L_nN6@_ZA zU;a?u1A+Kf0v;r;%fPj7jZZ0exB!xRk>bEIVd3~H;?@xcS|eXh;@np~^Bo10mw6Iw zsV|5W@;tRlLxnKQK+DaJFTxNcWTsCU3Cq< zIcly&X3efR)Cd)P(8-geCY8Fwb<%83-!Vw~qV`>sZrG3_$nSN{a8p#YkWs%)BCy+V zw$803s5P==kzSmjfE?Hwlx(7mSw>tbZSV-fQN2Dj?&;`woK0#ZR9W4deb{3P4L^Yu zxL2st48t@)zCTu^WpU@IV%X9%*sP5enmT}}(EFZLUHS49^-7E zq}0Gz>KdOwrAyLfuP4}0j2q4(0G`QqPCps;*j>F*NM)ec=efI}MO&?S516Q+J<3-n zXPwS3lw}lyYZ_TP8O$72*xAvot{YzUffA)_R^M7BE$OTt-HQAhD4=-AD16%|M_m(>AO;yNmiM!!}Zo1 z3u*u2r@O8`k{HLVVgvG(NBm%i#0;r^zunN8`~8jr3JKT>ndmHI2fxz6@^~@dXl_rA zc01hkYwV2KO=K?{Q{<5Q$I1l8b@gfYL4W$}S19w<@};XX53P+Mrh5ib7lL7uhEA}k zHb$w&)$w-t0p3rp$ThOzZy)k3W>0AC1nERX2zlk0?Oz4iWm}u#fQ)MOi?H+gP{dr$ zfBEd^cl)f`#fCk^25fhJU>VscpA)Qy84G-&1+XhqFRdoOhCCqHl3l0U>fWX4DID38m z4D$C3=TiqtKFfL{_(p}r9Q;yE!zhGnUuy#()>&pfNwfpm-Q5vwCc26@Kc124RQe0G zk_JW=H>wlMfyxDwVsm$dyWG^P9ZA2mB-%UPBoL2{lwc&DU=dvb^Y4Q-FKcq_xdv(| zG7bEcn7*Bd4OK-9qc^%S36MDq69UJiigE)Jf$o7WZ8M9YEG85}>hRS-gSGC+ z?x9=7v`ux+u-;baP>(7PCFY^qlg`+KiJBdS$%`lSzBlLDNsmfuG%d%YZ9L?u`1h5b zBC$KM2HzSTe}-_!mm>{=A6rb+P1f1hzRa>cxAY9M{CuqO0$U^cBbTpsd$&QFSbl4& z8{Yc5+<>O^o8|nNF}T*LCpt)4R<%%7Qj=TYO{S6*|DM=4r{91#k88pk$xtEwxNz&X zb2{B$f%?KDv<_WHqxw{7osq-u9rj5*V^EhI37=)#Ku~5{ygd8&&mcpM<^!-D@}IOV z#|E7~FnLz%7!=+G+Z|bx?Ups^Qx>H-|JZER{+C5eb#+_Xk^NQ6^X9`jr8#YiymhW5 z?>VSQccfmuR&~7`BWX)7wuBDVFof+3%gx+GyvCQBwbyW78BTLFARl@77T!*~#-%rR zx*pjzD8VGLppj+T!Dj**l=GY>ibPp&yUZc|`AH|%0@X%wly>L)y>tHOo~92&+<`9s z@noDD{Oz$eche(PrmJ!F@7)Gqba@4rxAQ(#liE<&%sF3}*#hJ#!<|yoAS>S~Ic^cN z0eWSdNzh8P+jvsX`r7q}_qeGQzULFfiIORv{Hap=^|dv&F*{^4&0l4Hf@Pn!cy2-L z>((GGr7h3XTpf8C9q6eed#!OXhU(_yM5fJkd==N<#tp?HZr3m;TBm&!VPNYPRxyyg zS8RgQ@q0li&WCj5t&+U7oeG4-2L28x>t`TLF#Fmhe&$}*Wr0x*J}4HwoZjno+}^E>;>WS=Q>Zmnl7!0FLpVd4AKueG_U0yHBH?a zr3t*8&|&0CXxfX$UbG7By{e)tPHI^lR7Rnurk+>mN$cHeNK~lU4chO9X}u?VCTub} zK|`|s4uIdg8vw0iqqv6}O_t74{Iup%!}Y(fDr=h&#;Q`;WkL(xwx|?*BtJHrFTnZc zCEdNbEO?!;#w3%P^F-vvwB!AOhW3KzedcPILPPI&#t?x1-72n!gtiHnJ@>gXGk>Ik zd~OljLMGQ!M|p>70qrVRtSu9ExI;=JI)7vNYp1~%4~$IB)RuLZRcR%*D*Fk(TYc1< zk3NRxZ80YwHU#tm3k#f#Nu##H(Sqn?oY z3ySJ|(NVrh72%j%*bR2hoU1uq9ZV{=Fu3QKV%s=0Z!IWUZb^ z?CU9UbtIE4U^}gT*`On!+(V+KGuL{g)f^492nt>93^?FuPI_Ak?^;~!ajbLMX*7U~ zg>6Q<86~_hdG*eEo^)IMt=N>oK@Y{xYBg7o+S@vzH6eaDA96fii4VU@Q(@!SKA!f> zMYT9J(ksC64_<=^ew#_e?g^cf7(<+{YQ{-OATg}$an0MYK znP#DhfxD3NDjs*Jhg5noKRciclDt8Z9ON{AT5d1Er#tCSJ@>^g=!kQ6`Z~p%`|A&l zg#;fc>#obgDOMoVblSoCr%DS}hMD3h9$dC-rL4v4+`QPAUr~190GB@&`|{qo{58Hp znr*~u0S{|213)$k;%4PeiEAJLzj`~#GgxDCej=>h59^{p>QNY0&3(f70sb7?~Zpq`6NOy`ResT>C^DuaO%} z{LAKO_d%~&xy1mzNL4G=1{37l!V8l*H{Or7$E8Ys(Q=RqCum=EzFvseVHGTniphFK{AcSzaNrUtRqG9@6;m zvD>|(Bw*lMfJR~GKIna?g2|$#1{vhkjXx2n;8c@V=4B;hJu)=u`+eywH@I@XNVxl+ z$K@KAoL1kk;ISpk5!IIr?Nn+&OGfK`c(xByi?fm_@I=^l3{+DnV$+kv#tU|&KDB(0 z8HOXZHYGe>&9{<;QX0%*qbaRFFN1WGP~)i7DEW%ci66*T{u{vBVfT=E?Pu@Qv^v^2 z!y58Fc9hJYAqZbG({(->XR!6m&xeYzdZK=lW2N_c_c66b5)ji8;rlU+Psu$`87H}ktG3Ms&A%udZ56NU0wcN^cB$`y;M-YiHv%4za~OsbjD z*w5tFrI9D?O>D!mgZ18T+Y5YsRC0z!Puk%?x`XevRnO0X%g;=NY=&dnf6N9M^0E?! zyKyO4iISXN3G!+!%S}mrumG-UbX4caY}~1rcuA@fZ<1Y~gnqu8uY<9qm?GCdVQ@3< zy-D zbh=tjS~U-QvA*M_hIdDria_Rr^V(#?wwdYGhf)K*#LyN^-XJ7nt*^cx_pz!B9mcse zK6{EEFD&P9D|bz>t@jp9HJ*6BsK=2Yfqh9Qb-5oBpK39BErZ{cY6F=iU6!pe_coSF zyIYig2sC(A*e2uQFs!HfzJEc;e)8dDGUK?AUpVM4y;Lbq)Mo3MSKC+MFa57YzR^?_ zCR%cfPd4e!4`J2wKQkkHb4J!MHc_s-cITY2c7DDb?<+QBf(y>fv;=z3nz^J6vG@pG z*+tc1w9P~~GT?AwgC9OiSH5{uoHk<+V4tYcezQTH6u%KK%UQd9V2~QYZ$CDvBIQ$M zkOr4`DK`q3;Ls5q4ANKq5*||V=>(kfvNQ87S{iZ{*Z0Z|i>sj{5gkn^E4`i{)%*5< zLCJX82mO~T<8t~_rQpM3t)3k0qOlGuQM*a6t7?vAJdn2<_KElBF;@#o2Lm3^w!CLP z`V%VJRr__=*ev7RhxrNauBDD)YHibClkD!}N7?VV`X*|cpPL8=h+QJzpwLBXH^o@D zrxvC&i7(^hWwt?Pv>X|O7t=$whQH!jb4i~TPi2o$N4}0pu}9QM++n$3Z=M>uFu#?3JvT0M$zV5KVWw4M3A!NqdDBRQVJ zMv2`DxAr*Ygs9j}{TdaC#pA^`$L@t6z$ne&=#3a-d7qyT1q+KskO*+kocJsFnHOfN z^10Os2j!=e~ritjK&W!%0Sb z<~^^CI&#=aKurV>%GF7{&k^s0g6dVZpYQW>(~eN?6*3pzuUm$w z;iVo_?q>5318dFD^xAdl0zUy+@#3@>B1<~Us2s5zOysw(C~8Ohlsego)tVROV= zJ*Hh)b3Hk33{N9sdFQoo<)&Ugwzw{7Hcqc9VOEm&-JtV_&XA0lnfComc9+agc91OE zp?yP9vl2inR)qdM5uK_@r%pqvaz*w6wKm4bv3fU5%w02$*=2A?HfV+Buu~6K?|NsL zId;(`i(Y@lAMCyTS&g>evNt;oC-1Ra>o-7Urk0q4NYEzM1Bc)fhwk1!waxb0mldG~ z1&Vw-1*m<{-Kob#_M3r=g`o#$w3zg~mj02wV5RAi_Q0-Ia^bEtawa_W4pCy`@ zMUEExN8qComwCykMI+F-?>E5iLA<(p(3Tf*L;cN;-|~4HAmsI1X{h!Rvw<%2YD}Uh zmGrCBY2ISDZIs~^#_uaBuTo1?lgoG=zS--{QL2o`Kw6sOWuIaZMtHo*6`P`QmRVx$ zn$^Kl)M*%If$Vz#>!i;Yb+5Q8c8upa$g@KPvhhmvK0jU2%rtC|wDtOd9ZMY)sIOCc zV=GfU`?4;H#`KWP&A1?qi3%6v=rv}oi~L1@mSWnDONJIzS&gf_Z=MxQ14|;xc1mjA zcK2K%!4r~L)y7^mEG_sOa9nHDVbR~AsyZI#z_{9h7QbpEOo9zd?n#I9>wd1q4GR2X zQpH=Uq_*+}-{EET@Xo%=<|~poZ-vtv6ZVx~es*o{-oM-m(hThl-m>`SIqetu2BZiQ zqO1GrG^rQVRJT#kR51l?OY!19+3}lhX;yRC%j6f?hUoPAXn)hJW6bdX;0?{7$O6!6 zPS-e~*i7fMIrC~RNIP-qxn%__k*_>cG&Npa#AoDY#Qubp#(Ya>GBMqv4qBf($+V9& zgA>Oa9_D7$_^{!e+|J9iK^Y_U=~0qr4$YdGSD>fv!Z=ESqU?l3rThQ!BVPC8a%cjMg-Hghdk!kAm1+&4y4^b-W3Co)!9}pc zBra=5Qy4@_1ljfA>WVXA`}4 zn~${3cm9Onw7n?X!PPsvX4W{wRUZ4=>g@vY(UPaP1O$sm!*}$jJ>0J=VT{lo#c`B& zbLJ|>k`&YMOnmgU$?PnFR7sY@MwfW4PJo5+R?G^g7|MC=D3AWj5u-tHpK+rzhQ+SU zNJvkPgp!^v5x~?>W-icc?_(EhR6gTpd1Wuk3rMoLttL zG~blD?W?-6U}e~K{=jbdrckULHM-yEt{5W=-z^v#@3o|WdVvF2W*3UnMdZ`b^C30Rf~%UJ!04;D1L5_j268+YuEeH-kl=FJ~XumI)CzAu`F zDeK1v6vZiUs>mV3);?w}q-4n){9gM18M6xIHyVO*^e<)=f}8gb1L?oKDgc63g^Z2_ z03zr~ivO^x{_v{)^q~N-{$W)iNL6U^+C+?20#I~fg;1tH;)^}#oXXiq? zVGu8P;YSwMMuZp2za*#sJp%wi-9pet(Gg=p2!7Ll8WIXJ8iL`42nHEIfWkn?k19{Z zs4ZXxB@Sgmkej}v2{!b7*+P(;&VT=3=tcKysTtDDsBlRGWpx+iNxkbjYhyWPNxX(4 zc|kB+2`3y6N2|eVwnaOTktVUF*wX#b1$;n~piFLy9$$8Gacc_(kqg;SK2Z=*(lCk} z3gt2yt$@(h#Gzh^4fH9Y#_wwBEUQK6^F+{8q*pV&VMDntUz#-^sAU>X<1^>B;= zSG-2Uge(Xom>Yda9dddbfND6i&B6_wol9SLKGazxaCm*KkIBF_st)Q=pVio=#z=hu6@-M(KrAOkgR@Jd0+Ir;;`W^ zps3$KpLyp*jwmXH<9Uho6Qp=j!XsLqSk}nsznr4ao$84c85E!p%QPrDLsI z^~nM=I-(b&S~{5-isL5v!x;wOE&c{TH2X1hFtQA6v0Md@r~8bkH-7`1=7u_i?Zp<) z23T$)+d2bc`d%Kz-{MF0vd|Q&?8?q-Au2VQ;HSstcmP$KD7e~wQY3#}9y@KEY7%=T ztYPKOh6WM`hYVN|4v;Lfhovnsuxd@m|Q8x$uG}NGB7N>r2j9xZz#a6t7mEbC3Y< zUU(RAvNL29ezWjQ$C^{ZvUV`W>Z|d(pd_A0FDg`(yLva`XRh22qbn85Ay16Ohoi!X zFzl3iRK6S-KS!dZ&J3tG(7Aza4JKT(s)^SW910|fVbjy`r4t?nL{+AF(u}l;z>*rz zvh9jTg`6hzySn9vC1)4V_v$fF;*Ja6B+@yGs7m{x5T#O3FEmQQKM;T+^~f2fD!tQY z$@dj+)yQ>TXqV8}QF*D0>$z$0@iWr567}yGp|-E0@f05} z&Bu7b-HVs`j@9~;wLyBS^o0BjBqc3LFsF^=TQ}xnZM{%P05H>sl0T7^O^V&By})#1 zS?COaW*#JVaI#-?kZcRlr1P|0P?RTaujTu6Npti(Nk}fvvi`(8>V2yZj_gr+x5+9Q zPjT>oEUqtWdhbgv1JwOx8|I^E`{BBXXkP*taenpW`!n@r`I9R=>8eT<^c4+WG)KeYDmgeP;6`t?@J7IBe&$jdR` z1yncJ9PS87f}06n9I}SRIq}D-kxo+-vG1(+R1NJ_s8KgN3ECg6n`>D< zSyqrRoMNe~SLjE(CNPOH?bnBt16{C@(E`WGe*-8+P+USSfYkO{ThQgWz;blEAR8Yv zALy!=s&F*>vxALRjLHNGc3iNsj7GN zn9w1o;5m_vxHx2^6^m3V$gN?xaTA7f#aktUD0)kKmoK|kv?cZ|DvP0g)g|vkT6>YY zvC8?PaPqhxCAHTw4kb7!N=C%{hRdv2jj0SaA%QtWj*#Sr^%jzDUYu}$EBYFlH2GaQspM&pzU;@(g6aZd>v9;6uWyQMIU;L$FhBT2bfkS1 zS9I5)_ou6@zGO2Ub1XsI;kbTZ%*4*;<|sQM{ng68;TnH2INV&rpqm}}OP!}48 zDb2rEg80NI0K!zWC<9US=No|++j3TyiST^w-8eG=M=_d14lQMJ)I>p;)0elh5CT5* znb_FyYhnkM$;3}=;Y#W$t>Kd^I+bI@yPa@6h@NXGI*BqxW4n%L7pBR+fYzzldX7p= zTybJ*EOsP{mpt6miZ+xp!kvl!3VrPtv zUv4Gw3ONIA8x?Eyb375bxv%#@K7d!sLe;sva$po4(3c$2G9Sz$l$UwLaUTzLCVv5~ zowe3LDwN+fo)Ev&WepZN0_&y;a~9x$a0rN_pCR=#3w%(K6_zZYY%o)1dJGR!4maT8 z?k0bDj_o_aGAH4;uODk;e@EFyR6f!~yxp&D)7HVtzGuK}PqC^OU%9N!0C?j%@~b+F zYqlM`TtBtds<&*n34WxhJ+l@IHJ8+*UyI=(CDDGBK_5dxcZE`Rt6y$5`DrCY?5238 zcv#V<0HlFu%~?_{lh=^)2E`rqrC#o{ip5h|n$ST~VaYnn0OF50Mx4bzw_{w9A>Mtm zLaVAEU8d}Z<7^XI1yeV_tT;Bxdfr)PmaJg}xTYsoFc5tZYX)42A~S>oW9IHZ*xkQD$i7Y;Cs&lq3}f zl2y^}Su*TvJ2IH!LfASs^_D`0BgAJbh+;nH752TPl+__M z1X1Xexx6$e>r@8VL=AurX;aHIO?8eYDPpWPgqAles29d%Sa6*zs;tMa5Z}fMZpClC zfiY`u>n!yS%3KnW#*M$xWD-soKcL5+|01nGpIfkt>0ty%+BMikE0nZOb&NhsfPKzs zrsh?KW?mBs#^mwzB`mAZ1#+f}S^CL{mXyp01q{(m!eOTlEQ7%v8$x{vi3`xufY!pm6dmicuMW6TBktHuXw#-)l{jzXnx=&(X9x|cIFOME5M5_B7Er{j~8 zATDgI#fbhem0sAZ!cy|OBEbn#Y!X`Qs6_}O(%Q~A?B;aT+~;NFBBvd&8u^hxqHl#J zw2AG>DYf)*8DoxicVlGFROg$cK}#+}4mQzbPUTGq4%ZaSmbzF%(ht4tF+X9QC}ies z4yD$!y`~lNI{HJ9y;<$%e3p7Q#Gg@^Uy`I-6pEl4ion08FRd?_sXn^*SyFO+%fF{jg`tf2y@0McND(x zQ8UH3T7BM*xL1U_YZ}QV^b(#b3L6 zg3aHq0z?+-Doe40vbzwBFOE;A}AS(;=jPOkL{M%|%+aufe)r&X1y;^d9Gspj_Bo9tZv z#yR>=8j`tQMzI2&P56SjN)&~&`G=F5PJ5E?oE;a;oMWLx$w%F?7luVB1mM$WkDO&H z3BLi+=yJ2G0hNYY%j&L&>K{aPSLt8|#P|U1keT*M4eMXM*UXQ3Q3{_bIx=k9?PI(P zqLI9XFo4zNHH%oMu+&g`y(9KMvt4;R4^) znOGuZUlix#QCU}~F!&D>Ggb-|cuH!s>Pn4DMlX9iJ68zvalY-K|Dmt51ktMO1&E;3 zm(&%1!<09 zXxo^fcBBeP=(SY)hZKB8_D{Q+6H|IArp#Xoqb8$hrL@EP$I@^TU<6^y-l=-+KM$a* zS|PdpLk5?&@mc<_S*YPj6@y-KN76Qmd^KrO>=oDVz%-Sn9|g8NG+{~MRj9ku&|jnD zMpKfx5!NyVJ~u5Xs)pdnjpfdE$o+bnRRdD=&AHhb_;3mu82KUT16K{{t(?}YU)2{& z#37QAktSsogkA}u7F$J>QCy57&rTo-6r~3IMIYuSUuLE-YIp3a_S?og6qB0O{svqw zR08N){HyZqlh1XD>|}6SMEEz_V4Bqx&J6gI6rpS~I67}NgbAkTXEoYpr8$_wSmqL- zrCVr?0LI3)`4ZYZe3jXg0n#58Lo=?K#t8np9?f$8vxVKZB+`9)M%R|ILt(7)4fWZ; znDhhHZ*MpCf8E>r-TBb_iYn;8D)E|Q6XK}A4@-d3CS^D}68dGjF)kGpi>%RVsvRdq$ScM5$i-#@ink*B=HmK#CmgL) zju@iA8?OW~+VypfID&NSKWv;$2qKz=)I@41V4n{or`aUu6I0mGb%YIjF z1?uyyYebr&1=rDN=ERZdx;e-QhIgZN@0_g~r1G~@8;<7V2T@+@D)ws~vSsI9br4W^ z4~O=BQ*zhR&Yf+U-71>Kdrv#}J|+_AL)hnHEKs#*4?A$%&nRYxLzgRkz{LRtZ3(eX zF9S|=1LGRn_`y|vVzR`mmgtX`RMCOT+LR$YO}MkOq{l?x1$qfGKdIOx#zIi&XBt#x zpGIL0h}}^Zq=yPb=p1pNx+ny~d~Ju^VG3(uc&fJ7yxt#VyR~ySnRSGoqd@5On!9tg z4!LXyJ}47A4~GMbP`Cp74=9KUD1fZ349t6eWjuw3AKQKiUGynhD)`!`9eGpxpBSqY z7~%sf}IE?R8yYPPy*D zI4h5FK<{5gfUKeCHR1KcF`5uQk6y$#TA7d2_n7igf}b5@g0YxE#;d(X6)PDw( zCnMA&5*BQfw0{jVN}X!EM$fcnbxH1K5wa7V|KNw-B1^D1py5?>`Fd=emq#nw>=bZ| z2eXhQX_pt;9V$MBcHQd_9=RDPwTE!xIifyTaN5A%Bqrh}OqaFzH0+KH#>UN1wj{jD z{|yjlRDrlN`YeOhj{g+A z2t&)0niN3*92KV?ZWL2D;3s z#y$CRg(>toMedv(l5@Tsb`hP8#uBqTJ?42tL0dM(jybA4vue1A)5OozFcEa62tpDr zZA}Bw!f{2`>-8vCQLsfz%0ovpu^(&oD4xu;GoL?KX*8uF`ly#XF8Pv@+2Guwrwr>b z1t)20?x*Z_Iv!0rwI%(L;9vpyI}2!L5p_k7dqJ9fPShv&^^~_|ozDsVX+#ITlVOM4 z5>O?8a_A4$Q7so`&K5T>!dKMZl*3~OVpBr?fl9qIwE|?L3odDui&sR~HB{!qgP+2b zSl+i@^PyQp?9G%kJC=Fk31OvUasa3?kCOEa?LYo9fuI}0UX*Yh> zIaI(=`6{?*D9@&5ElM|;lvkRn8-h_e!|8*T8q-ex^fd?T8+VNHVfHrMYCJht;Av)SWj#VcLJRKZpj;=(HK;jW++`jIP}BQd|r zKIk34&ZS;aB&tv5S&1c)C^kBab!`A*XjI#B&hO5fX_}Vfb;7Q%P*Q&3MIFAK7jZg% zPMOitLI^N(&0RZc=}~S-iSvL1#l1{hS~SP1T#&@p%jMlUbmPSbIgGvXKt=B`=eHr> z&%jB;_Z14VI^snGRzQ`MF*oHFuQV69Q)DOOr@EKtI;Z)W0ehAjVgni-<|78K@-Nk1 zYZG2}TV4zYkE;=42kO{|ik#t(UdH9}jblFH5J zH#j$YiJQM5f==o&Egz!%AYB!gx|U8aM!w$gWiT+Xb58QDPTH$dl_IQvm{A~wO} z-BTc4%&p?vqo5H?Anb>X<%pMA=iZNvJY3?GpdZ zzj#le|M5f&5}E|Z%k=eYBP~x-h3HAd&>VIdwD}W0dlUPO{7m0uhs=<4-1;+CT8LHp z=ILCF%WhZ9wRRCs9n~D60pD{Czz+Ib%p%j_t%jti0p=+JNvTsL7E>MtTFh{uB`#3tyTWG| zfgtRk72k(r=(BF~@!YU)E zaHmkEC}G>!w86zX!9YSC`6Hy7FRJ0RtJylbrrdAz9G*E1Z@}7fv(F>?p2yvPw!qlr zDP#VTb_U+HLt$}-abT`8a4XLtZf}W|TpI6EeIL%Ri`FKvnmTia2LTnO2=1NxSpV}7 z!m>k(LVX;poA90wQPTn!$m^%*dkL`J+w9~Qs}yysgGJsEp1=fH$MmhCiADka5no5- z>{jTo?h1@f=UxB~KUcLL8L{xIIv0_`8$jHs^O+LaYN$QJT}!rWnz*&A9frs)G*{<0 z1jJYx^NBKbB*Ct=!4z`jt_jwh*#x)hCD-$~+f|E75o9%Qb?8-tpsh8R1g5;Mer1D@ub-e03UP0KQz-JxYSo(bbq3c9h|-64($)6^kGYZr$%Wl&6&w_Vl&q7|jxjJvovvEr|hz4{EDgPl+xr=;gp%iBj{e@=2XB;^esd zVH3q)KRuNdewUJNB7!20YS$eVEI{%SS&7nt^px6$@IAo{4n=g8)@K`@k)7rV~H(CEvEq)=7EM_GUTNg|Fe)te zw)ZS`Ml+4rR8FY?g&s9r4pjdDin-~Peh6OF8N@dhtqXyZ!SPN*#E--lK){K|HZ&ZK ztH4wNwkuZ=v@Wz!Zha%Ka5xlMW5NbiVn*L;ZaCGU8nQ5V z0)%~qn^s4P=7%Mv1ny0{g_y>On;$hlsmbUf#uV?l`_)tR>LlsU6pv9wY4qnImpfIM z+h7>Hib|S@M>vpf2-DiL9i-P6DI6>aCnrCqolAI=1~cNd6eHDbOrD!gs>7U}znu=^_8V3PS>jbAAeI}@DlpYXS`Cvu zyy}+rP->BNO2-JkO+Y22Vt=8nO zK{}lB0wo)FsxYwFd8M5~$PdkZ6ofYYjda`WCpA8%RYt-#4nVBL`fd_G)WDCiB7y4y zxD+Va-tAmul_1gr{$qzFG^RHwC`%3}#p(`-@ zPCoVYkCW{i_cS#Mp$n{0yD%iE+}AMD%{9Zw8)iAd0M%}#b}j7W$r)j!4>_n1%FNnV zCav+1fLcwH_3AS;=#igW(*xy2PW7n&6~@gmo?v!d{*@Kq^m|ip z(_u_wE2*>dL*xVT@7yqb#s;Av0BzojqydqRYhiT)RWn}|R3N`T2WpO{7J(=W@qjB{ zmZ6idubx%)0Sk@!p*)`aF*vQc?av-4of;`))P(Wa)^oAOFg63leDdUE?TQ#u8zkf! z&*l&l=5`0>hw3l|j^uBF-oBDW0}b@}pj@;tqRh{vFJa!j4PiZS>|@^;&h)L*%m{0B zP`qk8n#^-O&BEnGah~1HXR7rG>`*CPQa8}FU>new=AkXESZa4V*z##EvID}6oRoZ; zK{~fkSJkRK9@=QKbrqT%O$h{z%x5F{QH*Y^7|(YX5o}~pwlR+av{i?aNanp#tVWVb zp4hEPzL2|-*!HSsT%9~++kLQTZEVPdf^dFmoASVi3%BYcwPM;`XGz>1)ONsJVlXfR zD7ho;MiJ`@V;hcXhPPQg!FL{LD+KY#4tC9FAY-`>r6|ydHX5)u2A8#fT}lU_0uQLu z2u>3_=7Dh2L_Ij)+S`>IRO(K|NFW=Q3{I@LZ7RH}8x_a*t;WGf0N{9}dUeCe3q>my z)AW*e9~8-CSoOOF`6i}iAkmbi5oR+iQOmyJ#|$gnxR29ulZ}s>QXAN&c1WZSRAl4D zFeL?Z{c8weqcCCw@>4enIR5|@sp8f>!*4z*E8eFMOoP^t76gHXQ;u~27!i8q}vkpQ*xSZ+>Yq+DKVnH}0>}a;|Jdt4J1w7L#U=y~r52uAEV_3MlWpX_)Z#YxM zG_xHDv;b_t%nzsza=GG~ieyudq#pFJm1jfgu;Y&7_MxPA63Ve@-Kz@NqZ{7Da%og9 zl^bK4K!@iU$l0ot)+G@J3ET!FwPEa)T&k8Qz~ZqPK-9*e6I`FuoDOQgPKD-hhv^43 zzMayfKIV*-swo+^ZA%##p?4iblX1CimP;)+5Ui`tmgHAE)Vdl0>RG-N?i8KZ>}uTI zL-=e8FvomS@=EtmYe=^P89M{^q%KEOVr3fKjb+wuY(IrMnUzm-?*4Vu^zNf)e5GS0 zUl}O-8s+aTZYFV*QIGWVPOMJIiwD-+VviytiyAPwP@_7i-VgxR0sH2dje`v&YE#~z zi)jKRM3W*eOLk*SA-F`<9FL?96xTh82BVHE5Y2ZC_pNM*&SN-Y2NcAX(Zac40P<=r ztaB**!j}?0TO(p~MtELPu0(eyY%^xDs2T=o#rQMZyNft7T4V>tMM^ zPhkXu-DnSEL7Sr3BznpeAY_c~O-IH*Rm~!YbDO`u^^mo#pmZOoeM|dPHoAXTQDSkx zI3QK-r!9@FvB?6>jFGB0(o~N$t=zpT`4Qxh!!vAIW8D7$+y!=UuuwjxjDs%8ridq2 zxsM=Dz<3C_s ze1Lw^uZ;VO+Vu}XbTVlOGpv7_rycZbaJr;b3^I4XKQ;4yA12A;SqG^2_mQ=0rv4Xr z=ZxJ-vqHOs)8F^)OMJLUEKDvn2Yqa02H~^mlZelnl=en<$ZTomyDR>i4fU9}n;{hC zSvD$a702Nx$PnI=5BirM=7R^4m9taS3}2>6AFR+!*#mKo=B>)bAsP-g#?>hF7wP&; zmk3u-_YCbuX2~PeW29pzy$(>W+?47+80Db|KQycXWC%FHqeRMpv3;1~hACj!O(bP= z+}F~vKG@H@vF$=u!ig91E~l{1d+IVq6StJ%#sW!9lmK6 z=@-$0&kHE|rtPdQTIWo2kjDX!$9n2!>Nc^miQ*58bGf8GcEv#j$1VWk-%@Yk32&_> zmezQf+Q_AbM#$br-n%$eWl+HEaB<$G!_=(ik1@=of%KDu{Hd!aFK$e1MxI;6aeSsZ z7`YT>Skxl%20J<+7yzgzBmq!NJ&yF;$8^C;(jl06OzZ<;n~d_Mh6mgqa@_ZU+?dN!+PyizaxG z>OS_sW9<~xvF;8i*q`!(8H2yLI$F<15%_g4LVVH?ki*%#`(t^Q!0xbVMfI5kwTe* zrik;9DMmyN;?IWIhEk_y9q4l~AYrw6t+L!~F{?a~d7(_n9C%dAp4H+2jR2D~9gK2F z9i4)W^NMmNiE^WkIOdfLGAf4OZZlb8=;Ky&_{}A~AOM)>Y(uc{6cWzPnZyn*I$rvV4J4)iMgn{tdv@ybA3TGfvzPf*GO42>fc93m1JCR=)GjUVb8RM!>~b;>>}lA47s~RaGs2h+hLLvL&MI3l zEOd>}dZE*Q4aq&q+}%b}3};E$x&Hua9La-^EP^N;gwmPWS*lBJvZDvoHs5M$C{bHe z1yXi6+iII{8zSgWYUj6MPBNBL{7qvS74vR4+^_6AjRuXMblDEs-}z8(Bej%ekqc)B zZ|^~hm}XWHD+d4tAfN4C{$NI_006sjzcn>ta8$g3 zBIi$fHGT{&o%r-7WXMoXuO6y{fOT)ES1tIyF=}np zsXFpOCu548_j!Ri&3MU6~NXh&|OU;sPT^+ytFb{IX|YF8B&Gtu zCIa~bnq8vI%co*|(50AZ!luJ~(h_yeBSo^8W6QU1wO5N1dY+bLOM7VZbm+vM<9Y+h zWbl=RTpr#tQDeE1W-Tk1W8JC9mxd<u)-}=>g!75Z_ zDIA|QHh7AlI=-HMYK$lIGUWcD)0+7cKmueOpVTTU^!d%&+qyD7cgWy*uAmYbah=BI zw}f^FR!L}XxG6Z2k3*>%A<#wzOAspmgfDO3pe$;seRV}>}?B7J0Jlm08x zLMRyD92)vIEI{Y>qbE^lp3M34og;qKSd^9k58AS(IMJS8YLm(BLbAMR9nZ9?x3sQ! z`JmYrBV2`{CQ zPuJ9+E>*|e&s*u2A}>||S}t8wZV#WebBqW()wldreg+~~;`swV-lbgK&3P%7b_I`c z0It7|xl~huIa%Eutz}-56lrQC2Q25^{?$RG0I*fSJYuADsez2aoHne1=Qa8#N9fkp zQ3i0bT)OP+G8Fs@hs($@F)c2_!{Ze{Ik*a}PIJE$By?VFM@Gz(UFHV;MfsPH{vyOatDxBa$=NTu>XB-2n>miIB#d*;2K1ys_@lUk*J zO!0Xcx_{=MT=Oe^j}&OEV2J5S6d$oBo3;vltUcM|6vS44#4f`MII0dx)E-JbK?GP6 zC0vun1p@9xHt($@(nk0qn3OxY&dR;bd2k|oVvcf1?N}T3p5zay7pL3w>25*;IDhoI zkMUi-qh=5Y2matiP3b*0I2EOI%#wNRwO|b-1seh4y_+awLMgu!!dp51#<40n-#Gix z9k8{HYn%a`cr<`uhyx6VJMmd~UAyr|)tuq9pPKX?IpEgvjEbyIc06LT*7@AI1I0Jn zBx3`$4+9|T*w?NQF&Usa#=Vael$HxC0VZ2d8~*@`u;?3X66jC&W z0;y&W4%I&Iqsen{*9PHbJSq{43b8aA(|iXUA2hgEOyz)XaYn2`u{}cU$OhNbW{dM-ntUX{{UD0G&W}prG}wY17Zo(@zy0P>5>~Yoz#=(`&RO= zGUvDc;;}ITPj=WF(X3k-mDRzG(Le`RIpB)+1cZZ<7aVWRBYSxl<_Oe>5q+kng+sF(D_E7CNI3(j{p6f-4=_N}A|YjT@cL_^v>^#W1*sB*t@tRQg|B zX{GdTf~jNeaj?(L9(*j{VH@M;QS~wYr(qvahBtGhLfV`D-t`f0ZtX7`=Gsgwhv?*E zup+JXdy^MV5Fi@n*!_n!2h)8T2*!J!)wlsEN2%=KawK;y!`1D&gnpdl+sH-;2io6b z{`C%FExp414scloWyZoqqh&zkZyGEJqMQ5y{SqC`|Cx`<|DS2qhfkicrkYJNz) zRS%>#M&N8kc^m+C+Z1m>k}YYzS9)8p^%$MWBc{oDI2Ou7la0H5>#FI!JMz}?#Upx? zDEB$6^s6yv8J&OOg^&LVA6x^F}7rdbx5wXQ73JBX%9qN_D zi>PTi29axW(*oO}=NyAxOQ=kwi9#9CVgX3wl4w)jpc=8Mj@aUcup;aS^Q;?elFWAT zUg9rsLVjYG63IRbU=Q?;Dfkf<#Tkij12mf{Cmdk$T30A`VpMOW)|IhB85-1jI6+|j z&imF<2-0`a?PVN}1uor438T^o17d5@I<&-OhhvgBpeWT*eH${|W+ekBd~ZW?fQFIy z@M&mbWhLZ0oir+ezFAnY7{(5APc<&q zD}fMla^&QJ@lY`H$W99qckXMU;&@Dr&m@a3P)8J$Cv?5(iE#J~ zq(w7hxcXc783*l2A+?2w^x8v=<&G(Ci&2aMPcWs%cBQf0OdTdi%KDiqT2V>r>E4*&80jy){ zG_8U3Dt!zSkEfVyE0{Nk1>%D^$-xT1b&xg;i^G%T6s z2vp$mb6A0gb5s%B=eoyJgx!8qd3!cE6t%Ca>~IE-GEH><0R1`Ay38#%l1GMR_UbBYtGc?iTW3qc zJt8o{k3VYVx}Q(=Awg`SG?#G2cVSj|g-NyqAIw7*BU8vMBAxZU!Zc)Io-^(sRhuho zB`PgdN-rdwl74DWPw9pz!j{}}X|z?bxWau+xf$l2l$In0o(o%(B|Av5HlK0aciyDT zvP9nENImN8y*fBmrE8^8$Qazz$=)L#pL3DH0;|Ns*5dLl#UpYz-yQ3ww04>pW{Our zFc<@|``0<{{V@@rHE*HHrqWo84Qh1?-ymAtUNJ_c)Sl%TN|ZkYQJ1bXSoN(kncbpn z{{TZv2L%fgu~Yj}OL3+lozzz>;YRFAJCx$Qx4f2VElKwfNMVDYwQVHO;eg(`Yq`th zsVSuD+p(^Xrd~DQOt*2R=8$`j?r5@L;qsbxOk>tVD|x@;+vPJ!7v)ph##b$D-8o$+-Q(7 z&f)Q~rafaBLg#bB=NYZZkh5}A3bhfq7LbNjhtxg=B$o2Z-mFk*-{~Ezpy|*>DPfF~ za&u3fo~8mIAV0>{<;q5+?URY9rH4yfh=WWHR~ZLte#@r81Dz-{nqtB-kmz7T4UT)$ zDu6L;4ZHl&i6i7qjqL8{8)nQ z!{^(%&imuFcwbDV2pRdMh0^-kNjMu~u{6h8g2dqFgNY_l#QTJvHpx3F=M*SZ#HL`&qxfb^IGNsSeNz*JVloAFGAc;O9mqOz2WsXm zEm-IfA=0F8=DLepN7L#^G_s9>9jlk;ap%tESkjkpo`UL48>#0U(BrgmF#+&5BQ)BP z7r5ypjOU6C)x*Vt26dimni+|qFx>F0QG^m;ljDjMw?30QXF2+G@C9c1Si+jdH|<|o z+sAVo2>}EjtKygd3&_E!%vQgdg;`ezoy`?2fYBhwsH=nWXpqJ&RDgHv3Ff|%a{yPv z07l^Uq!wamK{q^-;n0=A+qv)ZE9Fa%%ZFqQjn^jzu+y`KStI>99~9U)w+h|YpEZZ; z>St4t{8KFL(&kHYS4q_1AFX@WC1ZZhhABB4DXz--?bh+_L#vVwW6t~6AbMKB*FK|| z+Bg0dd-$)U@L5JaC;5o-5Rw>Auljn%1;?gv+mO3d!Xnk}4fZv1&fwi4hCnqa+!~vA z3c)MJROFng9xJA#^kigQQOG0>Bx1K3NW_#mQRcJ?p-@vK_i8jyO?NU!3hHKHpb9&K zS2t}Gml6}HRyf99M&U&{EyFFRr)ruYeo5J+`~Lv73#qc(>9MyVt>QR$AN|MfPxzwS z%(L6ZG-O6_tC~ZSKt7|9MUZ6Hh~$kW2;66C6w2jt=i<6+`xx#mK-2__%9@XN1-u|{ zq>trUkH}Z-Zh7!B^mPr;zY*Saf8en7?Mcau^1mv3S9{XBwU1SZwXC^i-H?nj{l$K0 zVq*v90QM845!})GZJ$(G#nr1lzLSqsogja`Bg*k{r0z z?{c$@xx1)4cDlH?I_~6H+sWdw2viu`ZH0R*s)%CKrCYE)t2kJ~BQ`QUr2hbFGCvZG zYysk9BHh(V16J7|G*vFB31SX-tXoQQ1Cmq>eW>!HIT+u^%^6U>xo?tN@|7ivYyugV?$D>E|8mF~y$xaps=B zO$rDaw*FL^Z%}FsHDl@XPDd=a3{+(!_L#{9PW0WRVG~M>5lh?0>8i*{Z1y9yH>HcC zCICOyq{w|kCsCru(j}Xo-RVi8EV&~edLz4xdvY~nngz?3bG`^1W|WFSn5R-@)P%9$ z80}ev5~Z}{;<0i605~gWCwgUKF~kl@&0nA)aTR8KkrrTak%5{l5r&YRIOevo5TG98 zkwlbeMF1T4_@p!XgmfS-BZ1T;i>N8c&ze|)sfYn`azzw}k-g2G`Kf(ZtlL`?1V_}D zh9iZhVpe0sZZ9h?HMWa&PN6J|`Fm6$bMIsNz6ZrdmKl9QN*b{PB+Hy+8q|?Qt+sx~ zx>(pJ)CtJQry=A_=UEsX!5@0gD&d4T)y8|$liH!l3y&D8S0FNG#zaop{W+C~n(VAP z{IR5GI+P!!w=4FpEu%5Fnymwsk6Q1x!ja_ST!37EjKo-q1_13vjZ3iH4E%3Klcr3N zm&nhK_2rF=%=(;_0*{i_g9TKEq9sTzpF)>7QNX7oCNc&9HHejm*m?R(g1E@y=1|Sf7P#*nSUsVA+ zVOEj32wk@;k&*YM;S#KYi{K8`E^E%p>)CY&C|rTWk6ge$i@_NSB+5hH!`jMD2{f>s>3Wej%x>35Bk zod=rxIXK3{dMR~fC&eAq%BZTdpQsfgv>O8&tLYVq%JJTU<4g0LcCTtQLz!88pS^wS zEA8TeBY>mD1J=^`JP!5XE)_1n_N=_P86Ep#f$Iag$j6GrhC=>FdLX-*QIJ7g zcRSGLP(e7~6eW-bDoD?Y%Su}yjEvENJp__O$jablwj<)E+}p_$228qslm7J0aTKpo3JpRGt%RrxG(AMZ1L?o?LYci(A4ZgZO0NXJcBtyk<;*Ks@H7 z`m$Z!D>*xmH>*8H6;7D04*A7g$QOWdFiib+@aWa)gK$7<+;!xpSC&V8+#hcbL-s#T4{je3Y(#V@C+ z2E1-Ycd1cFBgz7T%uf|{vx3F9Irf9Opuo!=t4dJ%%yK{*fGN0`sN5WsPN07&q%+9) zIO3-TNiG0~Cnt<>YukzLE~P4fsP9g6t1}hS%G>&2yA$v!#PJqP3}CYl#Ag0~sB4eU z;czlDUJ0U#GnUI^flDOh-K>QUfG|ZUDK|8{xg3kK;GeMCt6AB@a=B;KqlE(>&bc_J zm|Uz72KO)neXF>zi}L8o?4`-ZKFNl6pEQBQX+&QmcMo@e1)gFL zu1<6vg8bCk9NjA{nPA|I)XT25Z~4YES}d>5reXm8R5tuac2`6z1WGsy9!MW^nx#B; z0>In`%&d1BvivIY;jS(MAlnKuO>|bB9@fb~h5@VnZMikZ#rTV} z_{KYjjvI?+jz%~I4y7mikLy9?WAab#KWT{g$LW_I-B@6#&z}@q3kyqIm6ThjtDW3| znk}`Qmv<`6NQ?}zr`FY0Z)hbzt}a}>ezz*+s+7`I3Om+`&Q2*%;A!oOD4SLXV_f?( zVzcI$a7BBCWzK5^C_-~eNhyX*{+8$OSOv}F_<@2oPNjJkcFMRPaZa(0IQ`4Da@Rdl zOJBq?&iN2DK@R>q(~$KK%qVq~mCgr>vnP(`o7D;HB!Md`+vgg&qB2DqWpVd49`@ma zE60GqaYRW>@u_K9MmRJd5v#cV79;S;cVWS#x|PIsv&D4ZLjx4U%AWrKv87sL8<^Tw zW*h7=wM^<4k1P#q7z0+>JLGq&aQNi7KBg4|alqh|a!+Xu*ecN+f&tGoX;(l+yH{`*Z6vngis?{3oPS!E9Iq1@88W&4V!A2g zNi0mNz~EydrAZh7#z-KFdN2a231VVWUkN0`#f2O;cc!gChFIiA_CDFEb0?!Fl1@8S zdlg9RJ!{}2xBmd`jv7Pp@$*i|pe~~E@@Atf!WwI725<+rQK?;1slf;T03H*aI}=NF z4!I=D=-aM_JY$6)?@}5z3zr!_Nu^=&_sRbN(r#ZMFV`RX!@D)m-fSotz^4BI4qVF} z;I}gv<72V#X$TQj2qWBSfoCiVF_6-KK~*qbC1k6}kkj-FX=F%DZT05_=OobX=Q{l{ zwocipy)N~xEdV;dGZ4cO`j@e)kXkIv9h{v@u{FTRp&XW-ygVzM`67biB~UQPK|50x zR@RZ+nKe1k2mto1g)p2h0LBQ$^hJ!A2n1pGsolv01EUGZF^i}@NOG(;+#FOESneFi zhfAm{gXhg(vn%<3Or8b>0(%R23#NjF!5YV7*wEp~F_H{T(Wr+`xfZf|Y{2R`)$>+t z-TikY_tX zqFgLjl#-NKJTmucO z=w+7O#F05h@+qJH06l*<40((_Ptc?4={(8;6xFx51Dbi5=TmcB&*ACcs9cwkSNKbo z#@p9O&PWPZa&{uQenv5k_=(l=@*IoE%r*3jYWodC$8lP)nTj!XC%CN18E`1K5DX5fPWAeQ&nm=V`!*$4Zi;X2E4nzyN>2IL5Rr13Rqs;z@tp3?aej$yLPu@ zaB%6k0DW`}4=zkDVb`eiQT}2w&PxpCcH*`|#1JqU9&3-e{8`i`a}B6lWCu^QWxt&v z)-7cgk;v1_HO#CO0>_i$n4k3bWA`<3XU*LS-L<;SE~W$zov}w-SmTdOV4nC>xvBjY z%1cWaZKjmU(XY9Q&i%zyK#@2|)N3PY$ zrZQCa-x(BZiQ^E-Bg#NTJROZTwg8$$;6D(;fBKP`c=XpSJksd0UfmB-+eq1U9Oj)9 z8C|5gQSQkY+gHUl%M5WU#-XPNBW;C!BDqBhM!=~##tD<}tvv@@h!;b|JQTwmq>?4m3+w^&RAFXq5!9O~193+hi8%UpHCv>+ zS@i3kqm9S#VEJ-4Kd_|ltz9uH4V?DxP4!nu8sDcW%vOjsGB0I7>+W6or8*jI3Ev_T!DClM&d0OVAe9Wc-x z%JHjYB)3v>+JsW8Y@#U0X#3!SM*NJIJw9t^e@&(vw`|j~Bo?qRkaAAM>}h|^C}&Jz z#xQvpsZK^?YbqcCLQd%2Ev(>{8Q)f4BOFtcj3L6SF#16L^hQ~Zr`RSwp~ZO+ia*jz z5rR8bu`Jw-1yG`di*;oyT>8<<4t6MZt=?NSmcElP2hMn^vi@ELS#BJlKc^I&7gpD| zOj0}`+Xs{4njY(2LgIt_#cke1iDPCgQ@@&W2^pj(J08Y^BY@0VbdcB}P~&#X<2#H{ zWM6WXHY!$Ntl=FB_7r7>*&|DM!C=4w4R51dwaObykg_~WnAnZT?kd_vZjyo_3P&6N z09xhc%5k0~K!3#N?#U_Xu+qW3z>WK zc3`}R4TJ3Onnx~VfxW`LS%SNr_Rv7ygClxyv&p_j!n|iKmJ#U~*d76;1e@JQJH^xr~%{{YHcTRd8#l1&T;I6G7FARxGtBQpI=Y0jWe?@G%a z!~%2Tn!87`y=zI(s8f*rn0cjVzJWJPVC*3c{Tb4 zkKy|sn+RB=5=evVVUkbyq`wDU*`Ayl-XO9&X_d~zkyqM4B>)_jI}bI;^Sqpl+&Tg? z5`nSqa2Ya;V48Z$+(rwy%JvkjcMvclHr}=Q@*~m)amSkI5X4XuDmL;4JOI6gV6l86 zt~1`1S#^zM43Q>Ii(AXqGz`` zl{4H7idr{j7$b4swv5sY6)X4NwAjI9$iV(|Lqeb(9n6_XQVRa{OQv1P5%=Yz#=(t6 z7fNt&S3YRTd+G0-kD3=t6;SS9m#si0SmXCM>K(;U0VafJlUyqGF$Y_>xY)+I5B5CQ zSe;7NWhUBXe)v9asKhC^Ewh7;ynjGYf#`WlBC=Yre)bNKR zEEr=r-jujJ9!CdH4%a4re1Z|ieqnY7+^Ve zAKIhC_=@nj{K71QJFplu;&qtj#FsrjDRdlVGMj&D!Q++vLgxIzx{J)uE6F^~mLorE zl{AJ}%fIP64~nrW*hR35lybUD8nOSlZ#cozr z*_n+=73x7q&Iurj%13i`A&S-~k$@)%GI3o$Lb6urvQKdu>Sow~qzbiaVX?SLJkE_onUg_lec z5B_Y5$AIyFwLJE=EUGQnzo~vlnbj>RR3@|v;f+|cftVj5ab?`I5tPja=qdoDEYPCHUVl@&- zq=T>(@}a{dd!H0shS)x!zuvqEQQrp{0<)3#G^ia%dMd{KLLk9OP*@Z3T{=gpv--i< zS2NJcN7c|U!pI02^NQ<|AV?!1ii64j0JuMhN@zl`#8_>K-jow&T?@CxGIhzZ8M~fI8e-$PRX(_!wtEUqq-HqZ74zH{C0Rl7K~{O& zL~23C=fzU1P_Bg2t}qiU>~U23b)&#qN8P{&CYQE}S4th&Hq~V#bKo+8OUQjimL^ZV zn3>S((~v>vP_&M!M-Am>#4= zYsY`pQW_GDRhJA7E37cE1%FbSmwh$2P`O)pBP}-?xF5Nz@nvq0Q8^KNi9^#K;>ufy z#!M_VFOX}g{5{bjv&6HYYl1Vs==l5By(6ZcpJL`&V{%(LM#vu-t9A&*OSidr9rvib zza*6^r&5e~)NVf<(_vOHfk(v~)@aEux7x82#k^twis!{1gU9pcH>6rqB0CzBrMy3QNl^l(#OvXux zK%|`bsuIg2M^a?3gI+~4$-IgIJ77{!l^0XX^%ps-&Yq4#Ot@pnCz>s^5h8?G$EVvI zRSUaGW)c(ts5^J5mg{i=Xj(C#eyrC;T)I`yJq?LP5+lw4#=@oFPd%)jgeo#dtzcCZ zkw6H%orgV~1?NgE@suuE_b-y)x51gd6@ zNz^le*!L8q3ehjCBkjrGwH`QsEBr*0P?fS&{MIoQJyd6kSt4x`GAiWg8-rPnR$_o? zZs!{u)`SkS$?pCb+yFe#WVT{g(PE>Vj8}&f2>!xF>Q@&RcQZvH!UKRY%_c1^vG1NV zKMlP#*JbotIBm;`2+K0}{pxHM%oo&usGaj&9AoGRG$ah)el>B}I-^6T#ygWNY{PQD z(x^KUbRDzBM@vF)BW!04oQkys4Rds%P6F~zVdjG%QA9(+7@D5i+Q#LtEuWNZ#1o;Nq9PctI4vYh1cnhd>Y{%P1k90P!J+Nks?V!F7R*u*4Inu#ZD=C8wNW*1N8 zAp3~M)tPfHHax}6$APjfp{dUFzr+^S_gmhn=6bGHmSEih|13KK?ssG*phjq zulka-&21Sfpx~c1Jg6BX5!*)Nll>@`alvtNiz9ktIVAY66GG;JW~WuqZPLT1 zA;B_B?{ocyP&c9&nozmN3VhVK?qO#u6pFz|3V5wuKDJP!Y;Rm9Lz5-9x%3DXF@Uq! zI?ckitEj`Kt(XiIs}_j23MN+$y^eMj&$@<-PX7RE@(YRWQ2Jo$9IYNq2*c^4Fgpzy z(MvPwV21#m$vDj|3l~11jGo$yAMI16>XY3>27rSYVg*#OZ~hcmIollZQ?@gWHyQ|S zRC)(xLe8LR7~`4?Na9Qt%8`uXi~$PKs}k7XAnp6m*;`gvYWeX}int<)lX{CSq&}k$ zaX!(UW|NPrS64h1 zfoz4?d{8)Gm3t6{GhgO)mJcHm8w0oAnUZ8i8cwD`-lf4h{#+I$H^JVEBZ7sP={)`G zhS=@5C?XzNf~&lmW5(sl;<=uw)^6?}MX@o$z45zI?`|IUF&gJ%zls6~lofd7&O8dg z1^}OC7G^YKrFAB_A!Ppmn41thQ+-6UT9DF&gzq68hk^2H6}rlo5?w}w2!{Lf@l~zi zZlYr$y{OuOJA?aCzBNbZ>R{?}{aWT(K#~*@!lwzIO?d}iMF;Z`vyeTZTO0h>Mc1KQ zn^&}m#DYI?U^fI*J06o^EQpfM(o9a#mD8H&Vatv2+X)UuaNkoV-(Anu875`-BI(k- zfTc7tk(`WnuJiIR#TW@|6ify^t5L5Yf;KrpskYPxKs40y7xaOsw!y2oE}M9l5UdW^ zbmJnY-dbG8Gr2nTF(-a=Ri?FyD+s+HHKEBM{YJ5CGEXRHO?XCDU%15>$N(%L{AR+) zOhkAtz_9Eo{+ZEk`kR8M(Stu(9Q}uSp<(!S75z)19Y*0lwrikLqCerNO*<};u>Gl7 ze2@hvaoGG~cJd!hww})FRD^~fOEDNNin``Skrp`Imy&Yum>H!YuK5CdM_#U z2f8;rF!A@O-MO10QWK9*?;*mwD=v|~SNzr#BNcbki8l70KYGR7vPTYEZTCIT#bs|7 z(Pu5C@r6;atN_-dSxrMqz{jNsAOol?c0KFROc4X6Nh2fu={WCMi6sLmImuj8Af!wi zV}ZdGOr&VVf=u@A+w)4kt^iS-e9&6jI8!Sgk5AkcN7Y0gp0;C?>fm6WE9o3%M1_># zj1M({k)a3^+@B(P=hQnBpJ+SL+@e^5(E#Xh2s@v>0^!|f1%9>MA2d68%Bu-fvyyY3 z)W#oJO2*^e8e~0ECyL5;lDnhRqnGh4>egY}WU4jD28Oh6o|qDv@gQRGYkvtz|`Y=fvQ zyPCP%NDMjtbt3xBaV5||#kOF3A2n$bIY+36ARLfu>C!0V&^HbB4-{D6fzl;#|&^n=K{KD;0Vry@Y}E;vDh4p zccK?e9H}aJ7_7?bMv?R?yOp-ML;P;?5d!GGW#hmH^aio5c=Dmg;V5hERmeBZ-4C%9R;t%gknLK zTn3>^xFCwqoDdGjBV%6zA7V3I71wi6-1$J$UqZnpAd&l4Jt;j#Il`*s(u*(`2Mv%r z))99+$6J)lo|AL!G(#|D#ztxl<@3x8aU6lkrLCu#BnpJKdsYt|k#Qq14LXG^4goa7 zfMeqrrEPTuM`6Eua^z}^I`TRBsNYRft@ULLL{j1~fOxDy)om}W*jxaO*e+|B8rDrs z?;!1yT?Lv&JYmXdYz@a_L6Z_9%*IO-aocO?+c2wcMiquf^r!lKg&3@a?s2)PAtG7u z&bd4gDUZz%!M6VZ%|_sVmR6$1eWVm75GM+7!iR;dDr?UaB|G{(vZf)b3+Ot4E>oJc)GCdB-BsnB#g>mH)gTRBLhIHzHuC zZ1)uJj1WWuXvccjQF-G;k2peDo}nJ*I)Tp>sMN;UeZf5Dob;IEOKDO&^Im90OrA%c z^dBY16|SI_izAS~Vtdz$jUp5+zIHW(GU-0*J+7ddun9ZwUh8wpEWyKZcWNFc)>Veg z3E24tw%2#as^(u&Sm22OU_YHOBPKDWwJQ>HS{Ban$q)c!Y;)eTnC_u*U^HeUxq*$6;KbN3)VyeU4OuN5yq<18HufQy(DjQF#<eegEN zYHE8n^#L0W`K869mSWh_IQgb2N}33O)2cjR5Ion?DQNM>nlV6ILhMC-Dj#ln@k|UM zi8ZYmiPSNX%@)~Xw~Z92Q@)~i$)=^!008sf6bYM0vrhg<+O(2-o-{<0d({U{x)K1g zjawi%HD<%Cr%@tne_+m*R^(JGzMBM&WMw+ZshN!SN-@7UC*qNV+RqWr3CKPwFld-SYGEN|nVj$l z-lX-v!_%)&ON&&>PxWJf-hS24#Tl41BW7LlYQw}CQ@<4C%u`}5sP`p9X&tqcR>T6K zKp^Z7nr_nm#6%&6P{|%w1AWC4sK+E-K1pDVODb-NdzyvQAvX3=8-OEs%f5C1lbVwv ze2Q3~arn<8QrlmugXtl1IL^X}9p9;I8(hckV}ew1^HC?gGPsJzZpK6YDxI8um9n8? z#YX=CdX@17TR;BC6^<)J(t2wkz!b=MnnlJo6*$6zMUirhMi0$1Zh_Z**l=oRQCDyb zVr!8h^w}^+>IRfIDj%F;g(Oo=K5$|Yo-@0D;)in-bIA%2KtYxtG--`Sp`a3_rOaM| z%V3O>4M@3>E=+(Dy4!4a6r{KDbndAgkZp0yFxmeA?UTh&w?PzazDey&_`V~{^VIhh zH&P69O>Zee#h4#yCy`9ca{h@evBvc9u!*EH6P%rgidU?9FmVJsZHbo}8p<#+-MlaAe#aOxk-c+tU#rQt#E5+oWJCcl!#$nuNqgjliDSpdpcn z#-XvLF7J{UJs5Xjpl`_eqFh_MTeCwcSwYy2!lgZx#0X2NW^=m@_N_!y?g6+DS(;69 z9Ypu7G(R{{Rx((qH+qjIr=M zQ2I8jv|!9VC|s4#>OF-3-TKqW82gFadL5P^%tloOhjB@Um&b8T*kN+Rdd=KKd%)O= z`qDtKIvjj_8aCR&UgZl}6&^s~6qB_t)ip_AR^3}%jp?oi$ItQ=;>bV*VYHm@M3<&Td75OKeH@Aja`FJu_j z2CRZ~p4F2n4pmU%w5MRb`x@AFKuH^cLjj;-B+N#fW{n(c>N#L}??SYiGa(W-l1acl z>C(&Tk^GH$hUOvER!l6LfCU8HDol!7KxP0AYZq71$CYvmfv_FwUYV|E^#J#0BYI+E zy`4>Lv?y%C$Y6@$;x=X3SdXlZ4SFtZ)qqqqGo`6O&B-k#Wm#@Hoy6+%eaI!TQ{E^(30YGhcLSv1X#!htV;+TTTt698eck zKeT8Xfk{`^5J!ZC&+@9)eK>T;2ld$pjskU~eNlvBqE(qGI+ys^nNo2ucf-}IW z^S;7^uX7CL`iNJaKz1dz!TPFGbdI6xdXkin2V!2Sn`tGz(t&V|^_{_{UNH&Q?h7|6 zc>SxSnLaQ8ihN=Fn~kNnjTPLxHrt&3^gFmj$W_2x_Y`|{cYRZqT#bO-fm)UYLUbW) z4fC<3gT&d3WgQ7AQCnPIqZxY>`iIR9+`|N>I7g`=-PwCrx7xI}gM!--D?JJ$Y%W}> zF2o?uVacjL$W6>&)Bq9EZe_@foh0L)Dd_z~g-bTP59dl+#2W2{l4OICiem0j6l5~# z8TOp>NPW_YSr;_1t;@DGWDXSk_piA=oUwv8%c;f>Y8`<_h_qzmR`{i6ks^5uN_A`8 zV`KAP3P~$4@g2$z@iHo0w%n_EJ`E>&+SOxNKZx6T1MN%0cp7C!8slS)CZ0u>IkqE4 zoGTNYed&Qp9m&gIQCR&ziXQ+k)%#IDF}AjHPH})a6vM+A8ue<`?Ks-L{IEqb>)?_6}xEv08=-*tMoftj-x1=(kD=aW#kwD{rlHF(66qn?$`46 zFy3VU0LzvwU&!(+^*al(eQYxasm#&FybSyx>}17x3_#VnF$vl1gI7o@Ek;0ECQ)-U}y zt(J4i*yFt#Cd!2)abH}(w-D%j<2)@2pSI$a>47tvxMY^=T90#$^Th@^BolgJ4m9q6 z)G6+zWVX`kk5OGgerRcN3bP&d!03#_EIsyJU_j zmUNMoMgTkQLIqb^j{WgL%$e&ZcyufT@^eFI)GkqpCv2Y8xRnB!)NP(?+-Yp@jfN}N zxK$PaNbRRkJRhH$PpfrHZj}l~*m<9Y2YSjGT;b zn#^|MAQ`ahoRvN(m3W;)00BQZ2t#Bz6vR_8U;_h>6*1>NppAJuRnC)aqA?_(61)oP z-#dNpwX4+$(Mk*XVB73=s)1^Puc%Z<*0?juv zGaf1;HqE5*Rk~HED$@_EJ7jTGExIkN1Ktdc^R+NhVA3K1djVOK%2TC;o+Bu>GZB`F zjz-43YpB$Ok-#U6_oEgJO1269RU+r7yUf!GHDKpYik(zDeYGjGjX0>eQZax49q5~Y zbqZSEZE6WV;mD?vNVJt8jP{{>jvYmA>`l;8vJeMhOk2WZw^(I;V;DPDuv8x%sCt_} z6`y7m1ftm@NQw!TTZNM)W6qL%_Nk36!~ITkU1}$&q%!8YnWAXtl}_486>c1yiMh_t zhkz9a4a~8))rR}k>oIe7ftGlqi}fT;m;V68b1S@_X}B&uDFZI0VZjv4xcLot6^ZM< zr%EDKB~HuRHRO(wf$sRB2)KZ-cSHay#u*Zt^5DtBqjs z+JNzih<&m*sxdMC({I%FuaVKDI>}b~8KKDnhQkk)HK7>{3CN@sUgZi%hjzCk3vimeW|Fv(LIn;E zHaIlT<+Zpt8}e4YHqngwz%t{o+)$1y?h)o5lX%S)7-IY7w?|;*IMps?4g| z^n$=155)x;>ys~FXS^j2(r!TPY3mM@G>t_1kG9>bA%x^%aguTfs&=xissh`yZC=Zf zf`t>vg6>eawibyRso6iRP-#H`HwSFg_+<4!JmQuYGK;Cf&XE4m@lnw`Fv^zdKPh;e zdPrYA=!R0hGmZ@k%4KvQpOK$6q7iWH4qJR0@jHtn^9dE(fux4{-)b+Zt%j{Q9tJZ? zM&DZ#mEc#g7Dv~d>fn4Lo3jc$ZL= z1Eih^u9D8~E30uTdr10}@++U83C2jRMsl@^O@Ae}e>tScGFKhNM2o0iEyR+Y{a-u} zwNtzT{zB}ag*aT+Be(t;8Ue*O9|c{F&nNFWZmV-8w7#_2l*ruY2A;S4S0&U55`eOg zsGeG}_@2>!Edzne5sKz?>1+YGuD&c-^I`;z$?`L!*y?oa*ZQPP4z+a$>1C~5^(n8T zMk%GUz}}(Q-aFi+GrmxsO?0s&Ix;=D`Ui>!#F)+T+|(tXt*0oZrNbJo35 zLvR-1!lBzxA5Bz@-O8O7t5gjUGoZH;W% zY9JOE0-PKJaR(71B^~6-o}1;@fu7XOkZE(Bhs}BUW2pOSs~Frl47eH24Fj^#sLW`< z?lt*Bv1=!aIJSydRb)WQy}Ra#GM`Kwe%>f?GL^}xIT9{XY7Jsbbv}x7|FNix|6Igu4I*B4V7%ePX@ZVl?-998L^C4FMAWiGfKGU+y`oJkCT`xWV!K>c~o#YI!c3#^NuSM z9D|{Q9_vdb(@FpU3~~Xcpov2k&Pnf1IUniqa#XkADri!FHC@XnRVb-Ph%Vp6Iorv9yZ6O z*!O3^G%30uwVTv|wIMqzaw;?A*x_-@jYC-#6^_{YEQkoz!N(Pu?fodSae?E_P>Kna zm`NGZI5o3wS{BMERyi3M#ZAnH+;RP+E~R9K-6T>@MoI8#0Su6?LJ|h~0=j0jW`v`t zUALv-Urp5$4ha53y+0q2RcpAW#2nm_Z3&Wiml&F3?a%05?M=yQ@LnB0? zPoXd}cU*B)LM!`QC2_X=*FQ1)0%HusrQ<*sFCz^6SCd-X2-ouq?@&o2Z1|=mA~_XC z4tBe3<+mdkK_RF73t zOD_9yPeNHBG_e|;dDW#x;2!n!&FT<@WRAmXP6CZF-|aK8dw@JQn94_^*P)5IQ(vgPqL}RuIHj*am2LsTEV#Qp%A%zO|2H zcFE0V-(uKq4&${*>Dh+p$gb%EDPo6k$F@IucGl`!r6}=wWA!(ho$(dA>OFqYw|5%R zmf8Ks+DPr@w#Z{5HNwWAWsWmKdr3=y8xDesilFlPDqUQsOhtfmb+_lxq6N9#RT5dnZ);8d+q!PKo#;gD-E3d?H+^)HFdZ&>Z z;8nPB0p|e;1SI((U>}NsL!a*S&#ImCq@{Po$wU)74s4-V;}-tYz<&) zp&yJ{xC;l0J7;+t40Z>-4td$~0|rsJ&0^)3XqOmO{wJQvO+ykhD0|(}qSlxZ3>Oq`jcBS;!a2!K zt-w}Q3GHE!N!ZXFM94tWhdUa;kg}b7kajuZn%`;eB2zK8g28mIoapAT&5?q|lx>1= zMGiZJX!RWGRmjQWzF9<=bQqDhA2hHJxUws#w4&*CVM7DB#Z0^D&v7b96bUvAtadeb z7}TY-l^;OoG@}-XF(fv2%}|a()E7|VjLP*JzMW{XN9e#*VES=^pSh&d@gGx37EjCo zRkNKVYQ_D_v^rfu@YOZH>^WD^^yEsUIF&2b2>jB_r#j6$*_9JZ{S zf+@(GQi8w(+)|PHy7mAJf-&FC8booHh=Ba>#V_2Qr2fAoami~F95G_p8*#V!sSX-x z8`?0(13jv5;@+LqMf^9HJx(N*#vubL7aWRJFS^%FReRe%ULMlLxc*~m?PBpy#tINj zZZ`@jiP0*Um=H2|0MeJ2X4V-lLbK@^Dm&2a`rVD(c@pSiK8M=|nKHxeB501Shzt!c zfmZv7{y>cxI>)U`c!EJ{Vp4Fr+nT2tx|Hi?MFVXhQW9H3Wh+e#(Fh-QiR1%8^1mMx zTPx7Boo|pww;WYLaUH73*_>#Y;)|o7cHT78DusfHS6&Xs98qGqR0U+*j!r4mD9RWC zgWj=%gP|A9$;D$i-$@3y9kMuV44i*DYI|iXuo)DnmRL6Ql#d|dm^LgyxwW$O0XlF9 z+On2@%(gN%!8F8oZo>itkT=1m7FTS4@z2Ih7{6i(CM+S923Tt!JkocoED@O$5Ij|| zu0~ve@GH|A70W0f9`pomXnFXAk)K@~6;{@FLb&>S(svSwq}T?}9~HQ!I0UckE2RGb zVY#^JNdj1m2?^8#2JC6n3KJU-iklnb7(7df541}>6$Qh-a0-lzGjORSi44k2Xs2H3Ku{we6nj*wW5-Ii` z3GYG)p@`F@k=)ZTqk=*(E7)g>GHY|h%!g9Uahz8()#W3oNs)lS917|J`x{TzIR>D0 zYh{x7I0pqqKgS?FnID!pV-+N;F*rrv;8hDgpEDm)Mf(HZk7$4$F`|R!m}#UABPsw> z+Npe}rI9W$HcUoly^V;;L>p*MC}_@@a7bans#CLt^#p3zpe4e{a3M|k7&I#S>K6fj zs%q9D)Fu(M2U~u)_CL7b)8G9+4V}>t30L4GG#zG&f&20p5mck4kJ}cZnp173gip?@BB&;!&-y)>VBy&jQ{ay`N zxzll#LQcSBZHj?)Z!8iJSHGI85C$!cMJ6XW(~t8+vS*7RbDijJvN;5dW5K7ik4N)? z8!%u>7q~n(_%&00nu`bRbJvs-4oUJc#Sl9XI6q^}eHTzSu2w51W*j+S0H94gkllr7 zmq9z}q*3UI^?Lpz$r%gkM!HWVeAc7DCFBJew!?8*S#zYQBx9P}NU|=6O!>&-lx{qY zSTj)laz-2u;8(NA2obXCJdi6I9u_Q%sd0_|p+(k@r%oA<9~39Mf(as^W|5&)5D>WK zF|ia&Eitr)OayJgtz1B|!MdGs`-VTYD#2LB!L~z&4Z#M8Q57)QHyKz$pW%Unz$U!9 zlhchdc_VuEM|cR(Q0D`BM*d?rQns}Zs2Kwg2NC#3pSQwK^PSaIRwy?o(&;* zi3)1Y7<^L6a?&z|2MfOSfEFBt*74QFtfV6Jy|@8afHe-XO))ZMdm& z-g=FIGlPI>s7Vqrjhf{MZj{E##dn<0?+a#Uncv!vlozUWX7;PtBz|uMm-@kpiGRMP^lNjRgFN=h`ShM*yS5> zUOmbt@|^&VO?qEJ+xE>#>rCx^9;P~dF@f8YRU%tdMqlv7#xHMea5OM!F}4QB??aAs zRoARS z08w9+MI(s@Br&NwpB4Hq;c5MTfT$!6Vv&&Wj8+J!| zCPG0QY3-We8#&3`n&>|gUPW=~#ig1^kJfx1)fy;_&44%?{8wYfP?+!YCCzO0IzPf! zex!|L*!KeIpCgf76xX)hH)-xt63dJe&2vA8?OXFHJbNrG2q*PM(TMZ8u#a@?TR| z(Sxw~HCLnlE_vlkUZ4>P*=7R(pAG)>tezp`&mPC`qcwAY+*&*MnUU7oFfhxOHOIP)_+dBC#2x7Ma z5gx{*LuNff5m-h^#=jIRm04=2M)4%v6}XaC0TA!;Oh!H4?%k@Lyk3+-BHVHJrSEOs zA6qU}kJczYP|Z=7#BOC{48s&qi5S+$PLs){<8MuZWHF{AwV2?r4m=w3itNt}fW`z& z=uWjEymzDk(Qsoq!8>A~^h*FWY3;QJ^4mfy43{KtOHS%*5$Xo{kY0pbjVb{@HS7=T zjWVckrywu~`_OJ-c;zQL@N-4BZE}_aW53i9kR-wpy9FD z8r7_X$GOx-#Mh=oVq<)1ZI8`!YMNKZB^-s6JCdUtii6be5w2NaK;4G*C;gA4}82Ty9``8jequqa2aE+Rzg9X{p@wVo+tkSWUQIU=e-clp&-ka}(g zD0de#B+{u1q%I>M9nZ}vW$H^Vqn%hJpC1)~vnSis@lz}zE2|^^-cgE&w&YeV zvOq^3&@+-bqgz9fkV7flZ_Oy!+#N-lGOP-XVTQ()5IjM2sC?{yol$to>5PMs+OqJb zfMZkRBh3}q)X-wmByk^Dt~S!x?@OdIM;f3yW0aBygUF`=E2<{k_&?&ab!{Z}CIxIV zoP%CKdN8h_ArO})RSPPN90CFPsurqr4MToM+M}!{+Rj9pQK;h&pYK$aQ`3C9@SL>R>xkklVUR zBO%CT8d$G6reUBtpX?xuxP&lYPk9({+Ene4u*aIOJ2DL@m?x83hC>u;&+hG>^o_*i zr?lX)$24Wjny5s`eOhFWPz#3gpw?`y-dr?`p?Ov0ns@#c46^H#1%3A?JN#B+eE{I( zgMfV1%HxGEaYpXUas&tfY;Da7NAH`lAjV z!M(hJq9A4=h0?#~tlK0AzLF5k20%Uj_4F|+s3*qwrLJz4*D?SWOkg%Mikz{@sNet; zC)3`f4hy&nztGnm_=fp-Oasb{l|&byqxew7*iwUWxp9UE7X;+AVcgWo(? z))37F>}A*#bEJ=hRq#;`3l})sl56zdpVMRM9X{U8 zKvqQ_p&i?~sC?fi;m5^$Fqa=9Ay_l-qjfu)(p!l=DP4#l=bAZvF)>~I)-9OGK_q)d zMSRVgm6B>5S#@mr1F#fjaNrO|DF%!*lCn0$?geII(aO46w6NS)f(WiRBz`pl>!qV< z_d_-}?hZ%$S0!Ng7SH?(iD7TmrLYhC*ID?A;XmM)2tn7C=beb&xSM;E`G<}1kAq)B z;Mv1ph%ZY~-}tN&dY|zN80OMQ^&%dd{{T&o@}(Nbre0v#^%HFDc8c+I{=vrI&lOGu zLcj!5k+|lO{7LAnF~oo@fwPZ_wHxikY9}Stn1$CxzPA~cCNcj2`o%hwkGQKAca~{y z8k?U@lmHa={pvM^_2qEz)IVjn^0(io0bi2tvq15%XW2Ui29xkMkWC>+`Y4yCQpLLGqmb<2BQM z5?iS{Ol@@R&df;EcMF^h{{SOU=EMT>2LAx_7#!VH>Dl|xh#DBlxUY!vM%9*CBurwG zrlTrm(&PYK@3t}VO(piG_NW;B%`FX*>d9lZF&s)6f{bUqG!yP)1%?uxL8SV83Y++o ztbfD$H1aEHVwh9lorOIx^q_2=fZDkK0K}6=b!wKbx}R3F_7rF>tjr5zQ-_d}z>}JG z*c~8&#V0bdF+zAdQ`RF==T<%{{F+(pC+{gC)SxaiUWV80*nHQ>>!6~p4|7Xj+6 zD?ZtzP(~CuVA_sGXy2K_l_VVeaY{Jo>TaV=Z49xgB!<(Rj}#~@%x|hW032`Ly+l5P z0(BBA4wnFWh&`Q$ioj1-1c+6Qi~4eC);S}SQM$p7IS>GQ=W4rdtj&g9`7h0Tb!!Cs zvZ=?KEO|J-;xexxQKs&9IYssj!db@qbsr<&fMe85n7(Faj12&WJ!*~v+GF{VWchFb3=~q zGT!CK^rOgNbt>Db8+=lYgSnsy;J9QN^s)}%gFw2KB}_bJPm@AbmfmazFCKCMrr0Bl z#sewmHMRkoP?06HQ7U6N8SzE6a}$vs7!@Iu@2N=K8Z&5$7oI_~?SeO=PD8sLi{mwEGx3;3CpTRRp9BCFoUqCIMJw~ChuILi$0?FY3l9p5Ox zytOfF>RV5wzC*4;or=muc@VPzy)Ur6w4Z}tQH@B0q_!U0v#Ung%j1au` zG-;*8ZymF0U)Jh3{{ZnxOOVSXY!^<)R|c_0?s=iLsYscQuoRqp_@hQFq?}#F3NxwG zoaCwb6$xzt@r{9{W5_{(jzd(6%)xP8cm#3_VzpN5_;=BVS zrk(pxWu2gkQH-k%Jn^3O(Alb#=27vQjXH;ijr`WFp+j!O@(#j+x`YwA{ajHISR*#9 zVC)ZiA60Th7PSv<$?62b2RN^Kh{VdQb&>x7xUX$VS5Sq0$8ywOvym#WU{8uw{{V^v z(0<@Z_9APh83nnZtbw`is!Fl zYreg6AyooKI!LCY{JL=`$%rLzo&CJ=bxxfW`bkNXRu0ssQItU0Si^gB_pWcHU-fR2 zq9Y>DZ<3-GZ0R0HkF_t=I)_reyB6k902$JQNXN}f{WkUzw3`K*)--( zq}tp?(=5w~@`wi&$=ti&+`O!JbDy`xb^Sx7F|(7>3?pUKR2_~t{i~UdG|t%`0i@t6 zExpFL=R?%`)-b4J@y=`6EaJ|+Ad%vX6z8$6k?qo03Nps*L*lhjOO|`bQz_KyfpUBf zDKQk*_X^QuHg?B)py9P-X~5v-wHARXnZe2ot_H=sQx%96>LHO#Jfb`^qQcs1 zX~B4#+=Cg?-|T8iqUQ&C*nk6(Sl}?DJg9r0NhH(UH16kHZcb^-exWKTS5V}4&J6}Q z8b$#}?_RVf83}H2wJm~?Mly0oi+6Wr)NNKFESW~st*02Sf7I4- z#ZtCtRy9>QKdAVrp9-nuJBFp7Q1e9EZ}NZ<-EYXlzB!f2qM4xDo@YCns<^Afgz-%4k0 z0pgyvc#=@jVFHeGOJAs{rZv>mkvs~B00cG#9?}VQmJFl9vBd^=UsGIi2W^Uyb~JU9 zE0$78-yr=ai(GbM4f>4!U2XwQmPI3;cRi~Ir#Ok$H{2bzubT0t422bn<3k=+iy4uL zC5SlSaBJTxjR6(*5f_LD+zjHfV~|Io6DUsSJBnqlVo6yVGR1rjD00q@SPZJU$vzEu zGLg8zOoP=Tp59O5z*;9@HsATtAYaRnkqwF5VyN7tmr#O?2^cNEByC8loaCH0iq~*O z2=uz#JOe`!1Chl6=Ju{PW86|!>Vz;L?(R}B70CYp zq<1I9OGxIP>1LWU8Vu=AA2fNUQE(ebc2WD%cYRdq^j86x`$6Oiw-z?9sDQ){;d+Gk z4KhJ&0VRH}!jy*IOL+=Pat?l)Wit}vRtfTXr7wDv7V0&!>j#D0)hGxY6h$!?WXdSY z(FBD+QOLO%_%oxFm5$5wK$Yf!dJTG-XOh8xfmzSmOYI0r;jM zTu5Xi*_=|U4hw;>?dF?*;#=e}LI}tLknxwP>7F>717VY#(hgeo;g%uo{aNiaDYs;BVTTTLw)QqP^Q_lKD)_8CGoR1nepJ zv5Wg^OPrdaJd8sv((8X_GPyffrQ-pzG44Eg%}a(Wg*tHHjz<_ZMh5j9M=D|X_^V$X zdy?a0dxwo9k~4$9Z?y_onm1S1u2?`pft^)cmPt?@?2TY7S~*ec~%=5CCByAgnW=2txL}! zmfKc+$_7{BlIph#ogOQ2J<`dj_`s?WTd`e1a2a>i+NE{4RyZx0k2(5yrQ)LCL(bpf z5+tMnck@S`RnQcVFOA5oTSl_JbesXfrW!K4@JAS{S*Xr_G$l!cvxLT_rH^Ji3NR}y zxNU_EuH`GCln^_L8nGuLgxT4Kp+Hh!GWf_HB|E1jFeT+CUR+@V;i>VCG-NU)Y9f_VqEVkpc=TRze=n&LVi;>j$! zbe5Nr$uU;d31gkRjQF73{wcklM0UB-h`@-D;ZMQyT;Klyotu$gU!Tlq%m|(AQlOQ# zKJV*Z-&`yRWMP1bmO1TTERZxpV5)(XI3(-_GhClo>#x+=;I}HaqnG_nQ{lkbANC!? zBoh$4>eKZnxb*-?+uO-uM2%2r=VU$nuYw2(x z$EE5?nYnB6Hf|=eSjd+%k+|?pDK?@N*y?8Fo$E2IjD1N7I*xLAG;tg*nq*?9x5ZEt zF66|M0IUhdIHDKQhX#*zECSv*qm5CsxyJiaYzYLK_1xa09XcuRI<2%;(mYa^1W1Pk zM{}C}N;Lz?W63@1jQkB_{CThBU4YRU`R`qvA(WEGBQ?$P+TMq$P9(9&##IyywRr3g zwLryVSSK}=a!Jib3}sv_Lp`f#F*9ez)s$crn4EVc()QQz-Moet)Umdc_oi}~L5IA2 zDO_f_UbP{b?ctAhC){zsuB)nbIBcz?mO?YaFOyu9G0L$u)3_2ycgW_b$Dwe5sm#xb z7vxvAPro=n-m>Rc0~9sXt?d=lt6GvH@oSa8G?0MKK*b|*bS`cSh1hHbF=ulcHklD$ zJn9+6I`%fRdzAqBO{!tX8*ECSmOwWpF8lugO0QuLsTfbB^FmIPWPLEt8{qCUf-9l1 zw1pG^4o9?RgDzFAO-fCex8?B{upA0rL`F#i_sIs`u0DuqRBCtG?Y|f+#Tx)Y@ex#`_;+-*_^_pnh*vVr`jYW z9%!*F_JHb%w(NMOm)bB07~;0K54Z$x&h@3wRj9#;4THECudeP`LVzJBmFBuzCG-Nc zj7i4io$5uJM-%$k8SzcE*=*rP^o)Qultw7xHf+j=t0ZG`0OJ+S^$w$TcO#Yr!gg56 z+a6EN9IC!c?m^;^>Tpbv2_bK2oZul!`|Lj#mFRq$2FU#*>}b$kQJ4Q$G5&|cezH5olZ_R6nAENwNR16aPct+ zSaxhy+9_j9>2rJsafSqEAna;I{7c$1D&9Y~9ln2S(F&K&M+!~!_*~O6Dd9&&<+ptsx#PrZXnz01NRjOKkY{|kOo*Q>={1V!eJVt5C(rpr-i(y5vBxq_jzOU@lQH}`XP}XPT-!^^w9wN zgX24G#Y%ItcNmH~iv>$%*#T(=82nV5>wibvs|z9au&XQyU2Jjz+?q;giz~ozRsGAJ z#*Z6Oxk1FGb=>E=lHkH2Ts})=b6-ajN;4{YZhu}d58kP~FCYBa$T-`EAe07zRM5@TI2sGrRKMpV@z$CZ=dcB?Ri^v0eEu2b;blF8JQjdK1aDErvbFrNul%qnSM z;m9nL9v_%sW+y`fM{mFI)kgkty?La_z^`M)HF(BpnUpE{&w5QsLP+gSL&#htP*SCP zTWwRMfk9EZ&10*xerS=AfsQEsAd-E|0mjSTgVuxkis60<6)KbSQHWprv}C~uX40%r zkwv{@V`ya4sfHCBwHn4D8nn&z07{QFKdxRc+c;#>a!MKTo^+{b~pHBra|aVB$$ z>cE5&fdHH~_{3-A_x@ErNdh{Rh?mIRcc#NMlLXQh7?(-|&)%6!2_v_Al7I~1bIB*g z2QY_lir9%=-TqaQ6t~qo_C1H1hj(~ZMvfv~<@(%m-vi>CzmwCNNRm%dc@Oac(~s4h4^f97=@ouBbqyy3YRBzawg?J< z2+n_cV;UW_jGS%SpvdK#%zA(YLL^9Rz{j^3W#<*bbsI(Ly+%j@%D1{Qdy4LD<|?eN zx>)aw=LVpDB!<%HMr4>nC?um1o%_*YYI;8Bx7eKcA+Sa^IIV!p`BT3b$20|Uj8`D} z)83A=Ixs49o1{v;&Q0pqL3KQfV$37{Ukfp?mPT=oD-H9Li zXo20v0b(j)LUvt`ityUTU)n}KYf=pu(sNo#brGBqOeBqnAwe`}iEf~72j0GTm+2U< zPMuj?t!7CGVZlCp&{-xOP@gOar-54Zuz1?O4l&$T^^!0#n)f3-6iqHR3$_h?Du+Ax zp}R20w!CIJ;|8<6&sMiH=tKd}K4{j_g>0yy76*L&=&`<^)wOx9q2dZ3a*R>y&isln zL7n$F=79^MfrCxNb)7?Rih-;d)T!jTF${_lhSUfgQ!EJ}w%~RZhEWkMjlOFX`kO$C zo<>f+Lvc<;A(I4cid-Fo0f14^hN|Ib4+F3JuI`(6Dsh1PoDAD7lQ2 zk+`OUA4o31(s`9PCUaVx#4rf%FjVAoim5CDGOU9P)OWX4k(hz0z9?5O>9Q_MWaDmg zRvgD66%)iSQ5)EdmMpW4)Pg>DphpyXmnE2;yZ|Z7#ASkJd}o1!p7o1pOCM32+Psg7 z)-)rq@uT^fF|bw`ML}8mW7el^ZA8AgkI^X@z&mFYF&izis8zun=d~zZS&jJYS(Dhy z>J~48PZU(XxKb1_A2bHJI?Q&cC6|n!@#eK>>X`~%!slMW$i{>I)k$4h5f15fDKAyI zSoeuouNc~yPPWKHv{EVX4n;51>`j`tsOC*)CnJhA-LO?8>`%}!QZU9^suJK$D(kGfU+h4#>X@V7BbZr zo5w|4Q*!iuOQt&)GeX6-&VS7p(uU*{6!8)IMxmPKCFug@HfMlGCpcZIKm0cBSwtbg zeYFFMG2*Lq-|HbNM^n0z$&{0ZT#d-2o(7L*IqVH`7g6=joVw$cRg|_)Qd>Ywi~+rVnG|y@LQ2Adh#P9Nynbq_@H12+%qd6!YEBF-aA&M%x#Fl*kqB#3M~=m zB!b@6)4mVQHyxvqmy`ep(nUtZ17;P}Rv1;CKRZ)w-k2orxZw7r%(5`Z1aI5DF)pDh>I&%z zK)Oa7zZevv#TuPVrHJjCb>o&?hR4XSfkluhLP#6nRS48711at(9O?|C+l|4d?Gi~r z40{#?{*VQF;3?EsLUsgVmbmLymZ;0>YjQAFG5%<+pGqRxfZ2^)t+bZwEX)dl$O55D zcO=YF6e4keF-u(ENq2fAb}JDWMH~T4M5KYYdZjV^W9<;n�?f$Tbjv=WLN#gQmQ? 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 z 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/images/up.png b/examples/multimedia/video/qmlvideo/qmlvideo/images/up.png new file mode 100644 index 0000000000000000000000000000000000000000..6823de0040faa2b40088178f9de0aaa2a33f4ee9 GIT binary patch literal 1268 zcmeAS@N?(olHy`uVBq!ia0vp^LO?9T!3HFAj=Wa~Qj#UE5hcO-X(i=}MX3yqDfvmM z3ZA)%>8U}fi7AzZCsS=07?@QuLn2Bde0{8v^Kf6`()~Xj@TAnpKdC8`Lf!&sHg;q@=(~U%$M( zT(8_%FTW^V-_X+15@d#vkuFe$ZgFK^Nn(X=Ua>OF1ees}+T7#d8#0MoBXEYLU9GXQxBrqI_HztY@Xxa#7Ppj3o=u^L<)Qdy9y zACy|0Us{w5jJPyqkW~d%&PAz-CHX}m`T04pPz=b(FUc>?$S+WE4mMNJ@J&q4%mWE% zf_3=%T6yLbmn7yTr+T{BDgn*V%gju%aP^Az77Ltu^?{Dj2SqJXRKtXT=?BDwCtM&0p7c}mfa$#mn6UdBzjZM%Fs6CBIEGZ* zS~GROm$RWr`(DGQ1?R4rZ+N65vSvm8gZW?fGn%#QS}+KIuEBnAvb~;U`Nsi%k*|0eOlwSa_!rIo8bZ;=T@q0$a;AATeJNhA+d{% zOSE3}v5GZmo%#~&yYAQulP7Xn8)tAcajww`UlQ}9>qOXm4&xU-LEbN>u`X-YIu-JK z{={qbdzaNIF8#fC_2Ww2OWT*5asFNR_36j+m78n2dwz&%{)tVt&Mn;f_^!F3xaf_= e2hP>ANHDZN+w`o>Y1uwdIppc;=d#Wzp$P!%^~9C{ literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/qmldir b/examples/multimedia/video/qmlvideo/qmlvideo/qmldir new file mode 100644 index 0000000..1cba13d --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/qmldir @@ -0,0 +1,44 @@ +module qmlvideo + +CameraBasic 1.0 CameraBasic.qml +CameraDrag 1.0 CameraDrag.qml +CameraDummy 1.0 CameraDummy.qml +CameraFullScreen 1.0 CameraFullScreen.qml +CameraFullScreenInverted 1.0 CameraFullScreenInverted.qml +CameraItem 1.0 CameraItem.qml +CameraMove 1.0 CameraMove.qml +CameraOverlay 1.0 CameraOverlay.qml +CameraResize 1.0 CameraResize.qml +CameraRotate 1.0 CameraRotate.qml +CameraSpin 1.0 CameraSpin.qml +CameraContent 1.0 Content.qml +ErrorDialog 1.0 ErrorDialog.qml +Scene 1.0 Scene.qml +SceneBasic 1.0 SceneBasic.qml +SceneDrag 1.0 SceneDrag.qml +SceneFullScreen 1.0 SceneFullScreen.qml +SceneFullScreeninverted 1.0 SceneFullScreenInverted.qml +SceneMoved 1.0 SceneMove.qml +SceneMulti 1.0 SceneMulti.qml +SceneOverlay 1.0 SceneOverlay.qml +SceneResize 1.0 SceneResize.qml +SceneRotate 1.0 SceneRotate.qml +SceneSelectionPanel 1.0 SceneSelectionPanel.qml +SceneSpin 1.0 SceneSpin.qml +SeekControl 1.0 SeekControl.qml +VideoBasic 1.0 VideoBasic.qml +VideoDrag 1.0 VideoDrag.qml +VideoDummy 1.0 VideoDummy.qml +VideoFillMode 1.0 VideoFillMode.qml +VideoFullScreen 1.0 VideoFullScreen.qml +VideoFullScreenInverted 1.0 VideoFullScreenInverted.qml +VideoItem 1.0 VideoItem.qml +VideoMetadata 1.0 VideoMetadata.qml +VideoMove 1.0 VideoMove.qml +VideoOverlay 1.0 VideoOverlay.qml +VideoPlaybackRate 1.0 VideoPlaybackRate.qml +VideoResize 1.0 VideoResize.qml +VideoRotate 1.0 VideoRotate.qml +VideoSeek 1.0 VideoSeek.qml +VideoSpin 1.0 VideoSpin.qml +Main 1.0 Main.qml diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/qmlvideo_global.h b/examples/multimedia/video/qmlvideo/qmlvideo/qmlvideo_global.h new file mode 100644 index 0000000..8df5b5b --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/qmlvideo_global.h @@ -0,0 +1,10 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include + +#if defined(QMLVIDEO_LIB) +#define QMLVIDEO_LIB_EXPORT Q_DECL_EXPORT +#else +#define QMLVIDEO_LIB_EXPORT Q_DECL_IMPORT +#endif diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.cpp b/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.cpp new file mode 100644 index 0000000..2b02fa5 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.cpp @@ -0,0 +1,54 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videosingleton.h" + +VideoSingleton::VideoSingleton(QObject * parent) : QObject(parent) +{ } + +QUrl VideoSingleton::source1() const +{ + return m_source1; +} +void VideoSingleton::setSource1(const QUrl &source1) +{ + if (source1 == m_source1) + return; + m_source1 = source1; + emit source1Changed(); +} +QUrl VideoSingleton::source2() const +{ + return m_source2; +} +void VideoSingleton::setSource2(const QUrl &source2) +{ + if (source2 == m_source2) + return; + m_source2 = source2; + emit source2Changed(); +} +qreal VideoSingleton::volume() const +{ + return m_volume; +} +void VideoSingleton::setVolume(qreal volume) +{ + if (volume == m_volume) + return; + m_volume = volume; + emit volumeChanged(); +} +QUrl VideoSingleton::videoPath() const +{ + return m_videoPath; +} +void VideoSingleton::setVideoPath(const QUrl &videoPath) +{ + if (m_videoPath == videoPath) + return; + m_videoPath = videoPath; + emit videoPathChanged(); +} + +#include "moc_videosingleton.cpp" diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.h b/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.h new file mode 100644 index 0000000..3e5201e --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.h @@ -0,0 +1,46 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef QMLVIDEOSINGLETON_H +#define QMLVIDEOSINGLETON_H + +#include + +class VideoSingleton : public QObject +{ + Q_OBJECT + Q_PROPERTY(QUrl source1 READ source1 WRITE setSource1 NOTIFY source1Changed FINAL) + Q_PROPERTY(QUrl source2 READ source2 WRITE setSource2 NOTIFY source2Changed FINAL) + Q_PROPERTY(QUrl videoPath READ videoPath WRITE setVideoPath NOTIFY videoPathChanged FINAL) + Q_PROPERTY(qreal volume READ volume WRITE setVolume NOTIFY volumeChanged FINAL) + QML_SINGLETON + QML_ELEMENT + +public: + explicit VideoSingleton(QObject *parent = nullptr); + + QUrl source1() const; + void setSource1(const QUrl &source1); + QUrl source2() const; + void setSource2(const QUrl &source2); + QUrl videoPath() const; + void setVideoPath(const QUrl &videoPath); + qreal volume() const; + void setVolume(qreal volume); + +Q_SIGNALS: + void source1Changed(); + void source2Changed(); + void volumeChanged(); + void videoPathChanged(); + +private: + QUrl m_source1; + QUrl m_source2; + QUrl m_videoPath; + qreal m_volume = 0.5; +}; + +QML_DECLARE_TYPE(VideoSingleton); + +#endif // QMLVIDEOSINGLETON_H diff --git a/examples/multimedia/video/qmlvideo/trace.h b/examples/multimedia/video/qmlvideo/trace.h new file mode 100644 index 0000000..bd7f63b --- /dev/null +++ b/examples/multimedia/video/qmlvideo/trace.h @@ -0,0 +1,81 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef TRACE_H +#define TRACE_H + +#include + +#define ENABLE_TRACE +//#define VERBOSE_TRACE + +namespace Trace { + +class NullDebug +{ +public: + template + NullDebug &operator<<(const T &) + { + return *this; + } +}; + +inline NullDebug nullDebug() +{ + return NullDebug(); +} + +template +struct PtrWrapper +{ + PtrWrapper(const T *ptr) : m_ptr(ptr) { } + const T *const m_ptr; +}; + +} // namespace Trace + +template +inline QDebug &operator<<(QDebug &debug, const Trace::PtrWrapper &wrapper) +{ + QDebugStateSaver saver(debug); + debug.nospace() << '[' << static_cast(wrapper.m_ptr) << ']'; + return debug; +} + +template +inline const void *qtVoidPtr(const T *ptr) +{ + return static_cast(ptr); +} + +#define qtThisPtr() qtVoidPtr(this) + +#ifdef ENABLE_TRACE +inline QDebug qtTrace() +{ + return qDebug() << "[qmlvideo]"; +} +# ifdef VERBOSE_TRACE +inline QDebug qtVerboseTrace() +{ + return qtTrace(); +} +# else +inline Trace::NullDebug qtVerboseTrace() +{ + return Trace::nullDebug(); +} +# endif +#else +inline Trace::NullDebug qtTrace() +{ + return Trace::nullDebug(); +} +inline Trace::NullDebug qtVerboseTrace() +{ + return Trace::nullDebug(); +} +#endif + +#endif // TRACE_H diff --git a/examples/multimedia/video/recorder/AudioInputSelect.qml b/examples/multimedia/video/recorder/AudioInputSelect.qml new file mode 100644 index 0000000..d1e30f0 --- /dev/null +++ b/examples/multimedia/video/recorder/AudioInputSelect.qml @@ -0,0 +1,53 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Row { + id: root + height: Style.height + property AudioInput selected: available ? audioInput : null + property bool available: (typeof comboBox.currentValue !== 'undefined') && audioSwitch.checked + + Component.onCompleted: { + audioInputModel.populate() + comboBox.currentIndex = 0 + } + + MediaDevices { id: mediaDevices } + + AudioInput { id: audioInput; muted: !audioSwitch.checked } + + Switch { + id: audioSwitch; + height: Style.height; + checked: true + } + + ListModel { + id: audioInputModel + property var audioInputs: mediaDevices.audioInputs + + function populate() { + audioInputModel.clear() + + for (var audioDevice of audioInputs) + audioInputModel.append({ text: audioDevice.description, value: + { type: 'audioDevice', audioDevice: audioDevice } }) + } + } + ComboBox { + id: comboBox + width: Style.widthLong + height: Style.height + background: StyleRectangle { anchors.fill: parent } + model: audioInputModel + textRole: "text" + font.pointSize: Style.fontSize + displayText: typeof currentValue === 'undefined' ? "unavailable" : currentText + valueRole: "value" + onCurrentValueChanged: if (typeof comboBox.currentValue !== 'undefined') audioInput.device = currentValue.audioDevice + } +} diff --git a/examples/multimedia/video/recorder/CMakeLists.txt b/examples/multimedia/video/recorder/CMakeLists.txt new file mode 100644 index 0000000..9fd5972 --- /dev/null +++ b/examples/multimedia/video/recorder/CMakeLists.txt @@ -0,0 +1,71 @@ +# Copyright (C) 2025 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) + +project(recorder LANGUAGES CXX) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/recorder") + +find_package(Qt6 REQUIRED COMPONENTS Core Multimedia Quick) + +qt_standard_project_setup(REQUIRES 6.8) + +qt_add_executable(recorder + main.cpp +) + +qt_add_ios_ffmpeg_libraries(recorder) + +set(qml_singleton_files + Style.qml + PermissionHelper.qml) +set_source_files_properties( + ${qml_singleton_files} + PROPERTIES + QT_QML_SINGLETON_TYPE TRUE +) + +set(qml_files + "Main.qml" + "MediaList.qml" + "AudioInputSelect.qml" + "VideoSourceSelect.qml" + "RecordButton.qml" + "Controls.qml" + "StyleParameter.qml" + "StyleRectangle.qml" + "SettingsMetaData.qml" + "SettingsEncoder.qml" + "Style.qml" + "PermissionHelper.qml" + "Playback.qml" +) + +qt_add_qml_module(recorder + URI RecorderExample + QML_FILES + ${qml_files} +) + +target_link_libraries(recorder PRIVATE + Qt6::Core + Qt6::Multimedia + Qt6::Quick +) + +set_target_properties(recorder PROPERTIES + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in + QT_ANDROID_PACKAGE_SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/android +) + +install(TARGETS recorder + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/video/recorder/Controls.qml b/examples/multimedia/video/recorder/Controls.qml new file mode 100644 index 0000000..30f6313 --- /dev/null +++ b/examples/multimedia/video/recorder/Controls.qml @@ -0,0 +1,82 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Row { + id: root + required property MediaRecorder recorder + + property bool settingsVisible: false + property bool capturesVisible: false + + property alias audioInput: audioInputSelect.selected + property alias camera: videoSourceSelect.selectedCamera + property alias screenCapture: videoSourceSelect.selectedScreenCapture + property alias windowCapture: videoSourceSelect.selectedWindowCapture + + spacing: Style.interSpacing * Style.ratio + + Column { + id: inputControls + spacing: Style.intraSpacing + + VideoSourceSelect { id: videoSourceSelect } + AudioInputSelect { id: audioInputSelect } + } + + Column { + width: recordButton.width + RecordButton { + id: recordButton + recording: root.recorder.recorderState === MediaRecorder.RecordingState + onClicked: recording ? root.recorder.stop() : root.recorder.record() + } + Text { + id: recordingTime + anchors.horizontalCenter: parent.horizontalCenter + font.pointSize: Style.fontSize + color: palette.text + } + } + + Column { + id: optionButtons + spacing: Style.intraSpacing + Button { + leftPadding: 0 + rightPadding: 0 + topPadding: 0 + bottomPadding: 0 + height: Style.height + width: Style.widthMedium + background: StyleRectangle { anchors.fill: parent } + onClicked: root.capturesVisible = !root.capturesVisible + text: "Captures" + font.pointSize: Style.fontSize + } + Button { + leftPadding: 0 + rightPadding: 0 + topPadding: 0 + bottomPadding: 0 + height: Style.height + width: Style.widthMedium + background: StyleRectangle { anchors.fill: parent } + onClicked: root.settingsVisible = !root.settingsVisible + text: "Settings" + font.pointSize: Style.fontSize + } + } + + Timer { + running: true; interval: 100; repeat: true + onTriggered: { + var m = Math.floor(root.recorder.duration / 60000) + var ms = (root.recorder.duration / 1000 - m * 60).toFixed(1) + recordingTime.text = `${m}:${ms.padStart(4, 0)}` + } + } +} diff --git a/examples/multimedia/video/recorder/Info.plist.in b/examples/multimedia/video/recorder/Info.plist.in new file mode 100644 index 0000000..46a9ecf --- /dev/null +++ b/examples/multimedia/video/recorder/Info.plist.in @@ -0,0 +1,46 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/video/recorder/Main.qml b/examples/multimedia/video/recorder/Main.qml new file mode 100644 index 0000000..03bc810 --- /dev/null +++ b/examples/multimedia/video/recorder/Main.qml @@ -0,0 +1,168 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtMultimedia + +Window { + id: root + visible: true + title: "Media recorder" + width: Style.screenWidth + height: Style.screenHeigth + + color: palette.window + + onWidthChanged:{ + Style.calculateRatio(root.width, root.height) + } + + VideoOutput { + id: videoOutput + anchors.fill: parent + visible: !playback.playing + } + + Popup { + id: recorderError + anchors.centerIn: Overlay.overlay + Text { id: recorderErrorText } + } + + CaptureSession { + id: captureSession + recorder: recorder + audioInput: controls.audioInput + camera: controls.camera + screenCapture: controls.screenCapture + windowCapture: controls.windowCapture + videoOutput: videoOutput + } + + MediaRecorder { + id: recorder + onRecorderStateChanged: + (state) => { + if (state === MediaRecorder.StoppedState) { + root.contentOrientation = Qt.PrimaryOrientation + mediaList.append() + } else if (state === MediaRecorder.RecordingState && captureSession.camera) { + // lock orientation while recording and create a preview image + root.contentOrientation = Screen.orientation; + videoOutput.grabToImage(function(res) { mediaList.mediaThumbnail = res.url }) + } + } + onActualLocationChanged: (url) => { mediaList.mediaUrl = url } + onErrorOccurred: { recorderErrorText.text = recorder.errorString; recorderError.open(); } + } + + Playback { + id: playback + anchors { + fill: parent + margins: 50 + } + active: controls.capturesVisible + } + + Frame { + id: mediaListFrame + height: 150 + width: parent.width + anchors.bottom: controlsFrame.top + x: controls.capturesVisible ? 0 : parent.width + background: Rectangle { + anchors.fill: parent + color: palette.base + opacity: 0.8 + } + + Behavior on x { NumberAnimation { duration: 200 } } + + MediaList { + id: mediaList + anchors.fill: parent + playback: playback + } + } + + Frame { + id: controlsFrame + + anchors { + left: parent.left + right: parent.right + bottom: parent.bottom + } + + height: controls.height + Style.interSpacing * 2 + (settingsEncoder.visible? settingsEncoder.height : 0) +(settingsMetaData.visible? settingsMetaData.height : 0) + + background: Rectangle { + anchors.fill: parent + color: palette.base + opacity: 0.8 + } + + Behavior on height { NumberAnimation { duration: 100 } } + + ColumnLayout { + anchors.fill: parent + + Controls { + Layout.alignment: Qt.AlignHCenter + id: controls + recorder: recorder + } + + StyleRectangle { + Layout.alignment: Qt.AlignHCenter + Layout.preferredHeight: 1 + Layout.preferredWidth: controls.width + visible: controls.settingsVisible + } + + SettingsEncoder { + + id:settingsEncoder + Layout.alignment: Qt.AlignHCenter + visible: controls.settingsVisible + padding: Style.interSpacing + recorder: recorder + } + + SettingsMetaData { + id: settingsMetaData + Layout.alignment: Qt.AlignHCenter + visible: !Style.isMobile() && controls.settingsVisible + recorder: recorder + } + } + } + + Pane { + anchors.fill: parent + visible: + PermissionHelper.cameraStatus !== Qt.PermissionStatus.Granted + && PermissionHelper.microphoneStatus !== Qt.PermissionStatus.Granted + + ColumnLayout { + anchors.centerIn: parent + Label { + Layout.alignment: Qt.AlignHCenter + text: "Camera and microphone permissions must be granted to use this example" + } + Button { + Layout.alignment: Qt.AlignHCenter + text: "Press to request permissions" + onClicked: { + if (PermissionHelper.cameraStatus !== Qt.PermissionStatus.Granted) + PermissionHelper.requestCamera() + if (PermissionHelper.microphoneStatus !== Qt.PermissionStatus.Granted) + PermissionHelper.requestMicrophone() + } + } + } + } +} diff --git a/examples/multimedia/video/recorder/MediaList.qml b/examples/multimedia/video/recorder/MediaList.qml new file mode 100644 index 0000000..69ef3bf --- /dev/null +++ b/examples/multimedia/video/recorder/MediaList.qml @@ -0,0 +1,68 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +pragma ComponentBehavior: Bound +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts + +Item { + id: root + + required property Playback playback + + property string mediaThumbnail + property string mediaUrl + + function append() { + if (mediaUrl !== "") + mediaList.append({"thumbnail": root.mediaThumbnail, "url": root.mediaUrl}) + mediaThumbnail = "" + mediaUrl = "" + } + + ListModel { id: mediaList } + + ListView { + id: listView + anchors.fill: parent + model: mediaList + orientation: ListView.Horizontal + spacing: Style.intraSpacing + + delegate: Frame { + id: frame + padding: Style.intraSpacing + width: root.height + height: root.height + background: StyleRectangle { anchors.fill: parent } + + required property string url + required property string thumbnail + + ColumnLayout { + anchors.fill: parent + Image { + id: image + Layout.fillWidth: true + Layout.fillHeight: true + source: frame.thumbnail + fillMode: Image.PreserveAspectFit + } + + Text { + Layout.fillWidth: true + elide: Text.ElideLeft + text: frame.url + } + } + RoundButton { + anchors.centerIn: parent + width: 30 + height: 30 + text: "\u25B6"; + onClicked: { root.playback.playUrl(frame.url) } + } + } + } +} diff --git a/examples/multimedia/video/recorder/PermissionHelper.qml b/examples/multimedia/video/recorder/PermissionHelper.qml new file mode 100644 index 0000000..25407c0 --- /dev/null +++ b/examples/multimedia/video/recorder/PermissionHelper.qml @@ -0,0 +1,34 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +pragma Singleton +import QtCore +import QtQuick + +// This helper class allows us to reuse a single Permission component +// instance throughout the app without explicitly passing it, or making +// additional instances in multiple files. This is useful because +// permission components have a quirk where the statusChanged signal is +// only emitted on the instance on which we called .request(). +Item { + + CameraPermission { + id: cameraPermissionInternal + } + + function requestCamera() { + cameraPermissionInternal.request() + } + + MicrophonePermission { + id: microphonePermissionInternal + } + + function requestMicrophone() { + microphonePermissionInternal.request() + } + + readonly property int cameraStatus: cameraPermissionInternal.status + + readonly property int microphoneStatus: microphonePermissionInternal.status +} diff --git a/examples/multimedia/video/recorder/Playback.qml b/examples/multimedia/video/recorder/Playback.qml new file mode 100644 index 0000000..27d07f0 --- /dev/null +++ b/examples/multimedia/video/recorder/Playback.qml @@ -0,0 +1,55 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia +import QtQuick.Controls + +Item { + id: root + + property bool active: false + property bool playing: false + visible: active && playing + + function playUrl(url) { + playing = true + mediaPlayer.source = url + mediaPlayer.play() + } + + function stop() { + playing = false + mediaPlayer.stop() + } + + onActiveChanged: function() { + if (!active) + stop(); + } + + VideoOutput { + anchors.fill: parent + id: videoOutput + } + + MediaPlayer { + id: mediaPlayer + videoOutput: videoOutput + audioOutput: AudioOutput {} + } + + HoverHandler { id: hover } + + RoundButton { + width: 50 + height: 50 + opacity: hover.hovered && root.active ? 1.0 : 0.0 + anchors.centerIn: root + radius: 25 + text: "\u25A0"; + onClicked: root.stop() + + Behavior on opacity { NumberAnimation { duration: 200 } } + } +} diff --git a/examples/multimedia/video/recorder/RecordButton.qml b/examples/multimedia/video/recorder/RecordButton.qml new file mode 100644 index 0000000..c0870b7 --- /dev/null +++ b/examples/multimedia/video/recorder/RecordButton.qml @@ -0,0 +1,43 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + id: root + width: outerRadius * 2 + height: outerRadius * 2 + + required property bool recording + + property int outerRadius: Style.height + property int innerRadius: mouse.pressedButtons === Qt.LeftButton ? outerRadius - 6 : outerRadius - 5 + + signal clicked + + Rectangle { + anchors.fill: parent + radius: root.outerRadius + opacity: 0.5 + border.color: "black" + border.width: 1 + } + + Rectangle { + anchors.centerIn: parent + width: root.recording ? root.innerRadius * 2 - 15 : root.innerRadius * 2 + height: root.recording ? root.innerRadius * 2 - 15 : root.innerRadius * 2 + radius: root.recording ? 2 : root.innerRadius + color: "red" + + Behavior on width { NumberAnimation { duration: 100 }} + Behavior on height { NumberAnimation { duration: 100 }} + Behavior on radius { NumberAnimation { duration: 100 }} + + MouseArea { + id: mouse + anchors.fill: parent + onClicked: root.clicked() + } + } +} diff --git a/examples/multimedia/video/recorder/SettingsEncoder.qml b/examples/multimedia/video/recorder/SettingsEncoder.qml new file mode 100644 index 0000000..b53fa74 --- /dev/null +++ b/examples/multimedia/video/recorder/SettingsEncoder.qml @@ -0,0 +1,100 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +Column { + id: root + spacing: Style.intraSpacing + Component.onCompleted: root.populateModels() + + required property MediaRecorder recorder + + function populateModels() { + audioCodecModel.populate() + videoCodecModel.populate() + fileFormatModel.populate() + } + + Connections { + target: root.recorder + function onMediaFormatChanged() { root.populateModels() } + } + + Text { + text: "Encoder settings" + color: palette.text + } + + StyleParameter { + label: "Quality" + model: ListModel { + ListElement { text: "very low"; value: MediaRecorder.VeryLowQuality } + ListElement { text: "low"; value: MediaRecorder.LowQuality } + ListElement { text: "normal"; value: MediaRecorder.NormalQuality } + ListElement { text: "high"; value: MediaRecorder.HighQuality } + ListElement { text: "very high"; value: MediaRecorder.VeryHighQuality } + } + onActivated: (v) => { root.recorder.quality = v } + } + + StyleParameter { + id: audioCodecSelect + label: "Audio codec" + model: audioCodecModel + onActivated: (v) => { root.recorder.mediaFormat.audioCodec = v } + + ListModel { + id: audioCodecModel + function populate() { + audioCodecModel.clear() + audioCodecModel.append({"text": "Unspecifed", "value": MediaFormat.AudioCodec.Unspecified}) + var cs = root.recorder.mediaFormat.supportedAudioCodecs(MediaFormat.Encode) + for (var c of cs) + audioCodecModel.append({"text": root.recorder.mediaFormat.audioCodecName(c), "value": c}) + audioCodecSelect.currentIndex = cs.indexOf(root.recorder.mediaFormat.audioCodec) + 1 + } + } + } + + function buildModel() {} + + StyleParameter { + id: videoCodecSelect + label: "Video codec" + model: videoCodecModel + onActivated: (v) => { root.recorder.mediaFormat.videoCodec = v } + + ListModel { + id: videoCodecModel + function populate() { + videoCodecModel.clear() + videoCodecModel.append({"text": "Unspecifed", "value": MediaFormat.VideoCodec.Unspecified}) + var cs = recorder.mediaFormat.supportedVideoCodecs(MediaFormat.Encode) + for (var c of cs) + videoCodecModel.append({"text": recorder.mediaFormat.videoCodecName(c), "value": c}) + videoCodecSelect.currentIndex = cs.indexOf(recorder.mediaFormat.videoCodec) + 1 + } + } + } + + StyleParameter { + id: fileFormatSelect + label: "File format" + model: fileFormatModel + onActivated: (v) => { root.recorder.mediaFormat.fileFormat = v } + + ListModel { + id: fileFormatModel + function populate() { + fileFormatModel.clear() + fileFormatModel.append({"text": "Unspecifed", "value": MediaFormat.AudioCodec.Unspecified}) + var cs = recorder.mediaFormat.supportedFileFormats(MediaFormat.Encode) + for (var c of cs) + fileFormatModel.append({"text": recorder.mediaFormat.fileFormatName(c), "value": c}) + fileFormatSelect.currentIndex = cs.indexOf(recorder.mediaFormat.fileFormat) + 1 + } + } + } +} diff --git a/examples/multimedia/video/recorder/SettingsMetaData.qml b/examples/multimedia/video/recorder/SettingsMetaData.qml new file mode 100644 index 0000000..60cca0f --- /dev/null +++ b/examples/multimedia/video/recorder/SettingsMetaData.qml @@ -0,0 +1,145 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Layouts +import QtQuick.Controls +import QtMultimedia + +pragma ComponentBehavior: Bound + +ColumnLayout { + id: root + required property MediaRecorder recorder + + Text { + text: "Metadata settings" + color: palette.text + } + + ListModel { id: metaDataModel } + + Connections { + target: root.recorder + function onMetaDataChanged() { + metaDataModel.clear() + for (var key of root.recorder.metaData.keys()) { + if (root.recorder.metaData.stringValue(key)) + metaDataModel.append( + { text: root.recorder.metaData.metaDataKeyToString(key) + , value: key }) + } + } + } + + Row { + id: metaDataAdd + spacing: Style.intraSpacing + ComboBox { + id: metaDataType + width: Style.widthMedium + height: Style.height + font.pointSize: Style.fontSize + model: ListModel { + ListElement { text: "Title"; value: MediaMetaData.Title } + ListElement { text: "Author"; value: MediaMetaData.Author } + ListElement { text: "Comment"; value: MediaMetaData.Comment } + ListElement { text: "Description"; value: MediaMetaData.Description } + ListElement { text: "Genre"; value: MediaMetaData.Genre } + ListElement { text: "Publisher"; value: MediaMetaData.Publisher } + ListElement { text: "Copyright"; value: MediaMetaData.Copyright } + ListElement { text: "Date"; value: MediaMetaData.Date } + ListElement { text: "Url"; value: MediaMetaData.Url } + ListElement { text: "MediaType"; value: MediaMetaData.MediaType } + ListElement { text: "AlbumTitle"; value: MediaMetaData.AlbumTitle } + ListElement { text: "AlbumArtist"; value: MediaMetaData.AlbumArtist } + ListElement { text: "ContributingArtist"; value: MediaMetaData.ContributingArtist } + ListElement { text: "Composer"; value: MediaMetaData.Composer } + ListElement { text: "LeadPerformer"; value: MediaMetaData.LeadPerformer } + } + textRole: "text" + valueRole: "value" + background: StyleRectangle { anchors.fill: parent; width: metaDataType.width } + } + Item { + width: Style.widthMedium + height: Style.height + StyleRectangle { anchors.fill: parent } + TextInput { + id: textInput + anchors.fill: parent + anchors.bottom: parent.bottom + anchors.margins: 4 + font.pointSize: Style.fontSize + clip: true + onAccepted: { + root.recorder.metaData.insert(metaDataType.currentValue, text) + root.recorder.metaDataChanged() + text = "" + textInput.deselect() + } + } + } + Button { + width: Style.widthShort + height: Style.height + text: "add" + font.pointSize: Style.fontSize + + background: StyleRectangle { anchors.fill: parent } + onClicked: textInput.accepted() + } + } + + ListView { + id: listView + Layout.fillHeight: true + Layout.minimumWidth: metaDataAdd.width + spacing: Style.intraSpacing + clip: true + model: metaDataModel + + delegate: Row { + id: r + height: Style.height + spacing: Style.intraSpacing + + required property string text + required property string value + + Text { + width: Style.widthShort + height: Style.height + text: r.text + font.pointSize: Style.fontSize + + horizontalAlignment: Text.AlignRight + verticalAlignment: Text.AlignVCenter + } + Item { + width: Style.widthMedium + height: Style.height + + StyleRectangle { anchors.fill: parent } + TextInput { + anchors.fill: parent + anchors.margins: 4 + anchors.bottom: parent.bottom + font.pointSize: Style.fontSize + clip: true + text: root.recorder.metaData.stringValue(r.value) + onAccepted: root.recorder.metaData.insert(r.value, text) + + } + } + Button { + width: Style.widthShort + height: Style.height + text: "del" + font.pointSize: Style.fontSize + background: StyleRectangle { anchors.fill: parent } + onClicked: { root.recorder.metaData.remove(r.value); root.recorder.metaDataChanged() } + } + } + } +} diff --git a/examples/multimedia/video/recorder/Style.qml b/examples/multimedia/video/recorder/Style.qml new file mode 100644 index 0000000..d30c3b8 --- /dev/null +++ b/examples/multimedia/video/recorder/Style.qml @@ -0,0 +1,31 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +pragma Singleton +import QtQuick + +QtObject { + + function isMobile() { + return Qt.platform.os === "android" || Qt.platform.os === "ios"; + } + + function calculateRatio(windowWidth, windowHeight) { + var refWidth = 800.; + Style.ratio = windowWidth/refWidth; + } + + property real ratio : 1 + + property real screenWidth: isMobile()? 400 : 800 + property real screenHeigth: isMobile()? 900 : 600 + + property real height: 25 + property real widthTiny: 40*ratio + property real widthShort: 80*ratio + property real widthMedium: 160*ratio + property real widthLong: 220*ratio + property real intraSpacing: 5 + property real interSpacing: 15 + property real fontSize: 11 +} diff --git a/examples/multimedia/video/recorder/StyleParameter.qml b/examples/multimedia/video/recorder/StyleParameter.qml new file mode 100644 index 0000000..3a7573b --- /dev/null +++ b/examples/multimedia/video/recorder/StyleParameter.qml @@ -0,0 +1,42 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Row { + id: root + spacing: Style.intraSpacing + + property alias label: label.text + property alias model: comboBox.model + property alias currentIndex: comboBox.currentIndex + property alias currentValue: comboBox.currentValue + property bool enabled: true + signal activated(var currentValue) + + Text { + id: label + height: Style.height + width: Style.widthShort + horizontalAlignment: Text.AlignRight + verticalAlignment: Text.AlignVCenter + color: root.enabled ? palette.text : palette.mid + font.pointSize: Style.fontSize + } + + ComboBox { + id: comboBox + height: Style.height + width: Style.widthLong + enabled: root.enabled + + displayText: currentText + textRole: "text" + valueRole: "value" + font.pointSize: Style.fontSize + + background: StyleRectangle { anchors.fill: parent } + onActivated: root.activated(currentValue) + } +} diff --git a/examples/multimedia/video/recorder/StyleRectangle.qml b/examples/multimedia/video/recorder/StyleRectangle.qml new file mode 100644 index 0000000..e28cf4a --- /dev/null +++ b/examples/multimedia/video/recorder/StyleRectangle.qml @@ -0,0 +1,11 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Rectangle { + opacity: 0.5 + border.color: "black" + border.width: 1 + radius: 3 +} diff --git a/examples/multimedia/video/recorder/VideoSourceSelect.qml b/examples/multimedia/video/recorder/VideoSourceSelect.qml new file mode 100644 index 0000000..ace9e15 --- /dev/null +++ b/examples/multimedia/video/recorder/VideoSourceSelect.qml @@ -0,0 +1,169 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +pragma ComponentBehavior: Bound +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Row { + id: root + height: Style.height + property Camera selectedCamera: cameraAvailable ? camera : null + property ScreenCapture selectedScreenCapture: screenAvailable ? screenCapture : null + property WindowCapture selectedWindowCapture: windowAvailable ? windowCapture : null + + property bool sourceAvailable: typeof comboBox.currentValue !== 'undefined' && + comboBox.currentValue.type !== 'toggler' && + videoSourceSwitch.checked + + property bool cameraAvailable: sourceAvailable && comboBox.currentValue.type === 'camera' + property bool screenAvailable: sourceAvailable && comboBox.currentValue.type === 'screen' + property bool windowAvailable: sourceAvailable && comboBox.currentValue.type === 'window' + + Component.onCompleted: { + videoSourceModel.populate() + + for (var i = 0; i < videoSourceModel.count; i++) { + if (videoSourceModel.get(i).value.type !== 'toggler') { + comboBox.currentIndex = i + break + } + } + } + + Camera { + id: camera + active: + root.cameraAvailable + && PermissionHelper.cameraStatus === Qt.PermissionStatus.Granted + } + + ScreenCapture { + id: screenCapture + active: root.screenAvailable + } + + WindowCapture { + id: windowCapture + active: root.windowAvailable + } + + MediaDevices { id: mediaDevices + onVideoInputsChanged: { + + videoSourceModel.populate() + + for (var i = 0; i < videoSourceModel.count; i++) { + if (videoSourceModel.get(i).value.type !== 'toggler') { + comboBox.currentIndex = i + break + } + } + } + } + + Switch { + id: videoSourceSwitch + anchors.verticalCenter: parent.verticalCenter + checked: true + } + + ListModel { + id: videoSourceModel + property var enabledSources: { + 'camera': true, + 'screen': true, + 'window': false + } + + function toggleEnabledSource(type) { + enabledSources[type] = !enabledSources[type] + populate() + } + + function appendItem(text, value) { + append({ text: text, value: value}) + } + + function appendToggler(name, sourceType) { + appendItem((enabledSources[sourceType] ? "- Hide " : "+ Show ") + name, + { type: 'toggler', 'sourceType': sourceType }) + } + + function populate() { + clear() + + appendToggler('Cameras', 'camera') + if (enabledSources['camera']) + for (var camera of mediaDevices.videoInputs) + appendItem(camera.description, { type: 'camera', camera: camera }) + + appendToggler('Screens', 'screen') + if (enabledSources['screen']) + for (var screen of Application.screens) + appendItem(screen.name, { type: 'screen', screen: screen }) + + appendToggler('Windows', 'window') + if (enabledSources['window']) + for (var window of windowCapture.capturableWindows()) + appendItem(window.description, { type: 'window', window: window }) + } + } + + ComboBox { + id: comboBox + width: Style.widthLong + height: Style.height + background: StyleRectangle { anchors.fill: parent } + model: videoSourceModel + displayText: typeof currentValue === 'undefined' || + currentValue.type === 'toggler' ? "Unavailable" : currentText + font.pointSize: Style.fontSize + textRole: "text" + valueRole: "value" + onCurrentValueChanged: { + if (typeof currentValue === 'undefined') + return + if (currentValue.type === 'screen') + screenCapture.screen = currentValue.screen + else if (currentValue.type === 'camera') + camera.cameraDevice = currentValue.camera + else if (currentValue.type === 'window') + windowCapture.window = currentValue.window + else if (currentValue.type === 'toggler') + model.toggleEnabledSource(currentValue.sourceType) + } + + delegate: ItemDelegate { + id: delegate + property bool isToggler: value.type === 'toggler' + text: model[comboBox.textRole] + width: comboBox.width + height: comboBox.height + highlighted: comboBox.highlightedIndex === index && !isToggler + font.italic: isToggler + font.underline: isToggler + font.bold: comboBox.currentIndex === index && !isToggler || + isToggler && comboBox.highlightedIndex === index + palette.text: isToggler ? comboBox.palette.link : comboBox.palette.text + + MouseArea { + anchors.fill: parent + onClicked: { + if (delegate.isToggler) + videoSourceModel.toggleEnabledSource(delegate.value.sourceType) + else { + comboBox.currentIndex = delegate.index + comboBox.popup.close() + } + } + } + + required property var value + required property int index + required property var model + } + + } +} diff --git a/examples/multimedia/video/recorder/android/AndroidManifest.xml b/examples/multimedia/video/recorder/android/AndroidManifest.xml new file mode 100644 index 0000000..414f465 --- /dev/null +++ b/examples/multimedia/video/recorder/android/AndroidManifest.xml @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/video/recorder/doc/images/qml-recorder-control-bar-overview.gif b/examples/multimedia/video/recorder/doc/images/qml-recorder-control-bar-overview.gif new file mode 100644 index 0000000000000000000000000000000000000000..b02053ea530cc0744ea83663dcbd0487ba109216 GIT binary patch literal 111693 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ët-C_wP>DfFd_4 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

mm8 z&`osUgLAxqm<8y%7wQigENOOEyLSOyuQ=B&3@OlEzc|Nat8l(&u+>ESyK=4dyPmGE zsNUOQ-|IIgFjijj?#-=KW~r!1bIy#|ZL-MCda)#GSE=(A+wFqrRY&8*rCGJe-oxy} zg~_wkU9~%6F!=-+O)cmSSkxJmo!1B++~9p+)4FJI4=VD|$=&GaLaZKXe4EbaVc+J#7;ZiJCYB>;k_lnLS+DQ>Uk(`jIl?99S zscv&=t#0N0tVLS){nKq{UuZtv0|9QM_Io_lj+SK}aJqn!_iEX|S+}WjsEUD%>&u+c zPg|{R0kzToo}g7F>}+NGC_n23tmhVnT2}{#E*$I*z!bNa9jdC2yX9LL6?=N= zk0I5-?4bQO-l7nLf|2{IZ2zlX2jiQ3b*zyG8HpCa5u&vdUhMk-y+7XAEi9Jo9vsRs z+g!5tJ$NI8zP2Py_r;w*$o*&yFOgrApKSC9aQXGOv-jPv=B|0?N1V}na2$N!+kFie zOy02uxaBu_&;j@i`3jJY{tzVPo>_8RiFsERE)g`vgQ^OIndFX_j#@gCXZi0)^OKF8 z&dCRb&ORI$I{{-P{F=Ad%vmppt14dYzLL_~{DmW^8ey;U&6`nuzz{uK_~%J3!b4XN zemVx+wKp_D6pTDuukeNBa6LKMh(TqHld*sN3URRf$C!MEMj|V`svNI(rclm7ShppY>oL49Q z0L99nbE&=g)n^aGL_$}1CX}YJk0MS3zq?PkJ9{B3K+0`u1B1nY%VyaC*np7N?>A!) zXK>WjxmL*!;|9gGF3D`b)3Zd#mK;$=i~TmL4QFO=UZ<*eWqM5mf;{{M2HeK#>!cE^k~>b;eCnvORK1fTgOa%Z zXD`e8v7@6O(Ax=1keTo8QrOkjh7WjVt&tfAURaaEa|avW^#)F_-?o# z5?QB71SMadWaM-U8Q)VEU3?Y$?Z3;GLoZhFga4o^UV!Y6ewOrNVExfl+!^q=bdOp! zlgZwT+-r7TUlMY8;cihm8o%8*`(KVm&;{g3+-hozE#N%Tv*T)l)N0os52^_1Ys>D; z895SIK@7tV4i1j9)(9UTHdT}bf&2ULRj^Wy$cDOx)>(RV;z`_Y_DL)Z$PD^EFnrm| z2)h5k=2El9biM4~Kov9+t7%b{NDmPOI+oKy7o%vQb0^5)Ve83isTvFxkml-dhCy6fza zmD~Hri0X$4VBioeOI}jS{lwwtm3(9G(or*y`D=Sl-um+?D!)hdxb`&j&iJ7Ap9pB_ zvXGx-BiRQF97%91waF{gXdX;>S$soxFb@IPVy;OpX{uJy$RPNsGUOOL>|IzlhXz0d zUv)tB-Dem6ZCzR+#92gJ-#Kx{xr*&U?$&jiCqJ652(K-7`7afoYtYpvPZGfQt2rv) zNfkZ!_~OTBu@H*(SY#uqRvOaAmA61EJzKAB_(tFL+9?w8&ZJ4og3jBTrelo~b-9{AnbjNtCKZ$CR1C2rZjUAPOE865VSmV~&zFUr- zQpnZI(28@l9iw$EJ}+=)i-`@{@dhHiJF~2wE^VNCYz_-I;|3qOA4-^IHfYD4bN=Vs zPwziP@oP1g6tL3V2+AG&zkU6G=UaL!u0slwPhc>fA}mOH)Ss!6|6^kSj_i{Q%5Ye= z1?^ZEji20ykf^sl`c7NP6v;h>9<44|vy?A1WOl#X9}i3<^*X9-Rus-UL}<>CAly8= zOcF26@^6vMx-qDHrNN?^-llFS6&zg{ZDTw$!C!fOT9%DY+x|1op;x5TP1MfSLVocq z6Vma&Ha7CwftC@vUx;v%D=Rs)b!K-iTgc68`gY7eS=?wMLm?jPGxq9Wdz`L=CW}33-J?rk&pm#SpPWF=lom|cxqXm}0TJ=QNR0eY0v;{A%m5qJ-Z`k? znK%IfskCZNxlWbK^{FMYT;b#6)1`bLiRa|U{F)*72^GZu`z93nX&FqEhD)pVL6J;8 zrDJhpa9YP_v&Y@R(WF=)qxP>8>et-;&&2&6YEm-9a!8|fTO6ap= z?A|PgYS!81;m)_pxLvN@c)RZeM!xsncLz6spc%n$g*0Z-XsD2AexSGr4z|{70nBd~ z7+tj^e{osw-ie8cwRv4IjkaHkuT1;ioNKUiWMfc&rz3<2RE+T(Yg!Ec&mIW^__EWT zL!Z8I7g)#$=0V{^vIHrdMqjM0!`X*~UGIc1n)q~Sk0;d`{F}OMZ+igT< zn&ulkO&N$73(XRRZCm)A%{C*R?u$_=+pY{PT-N038WL?EvumNNb+XPswKM($R;}#A zbommkDAbTEm2dT3OC=*^(*EcroNLibV*fl7y_Cf?RVVkCV&ePN7K5#x?=LEx9cr4I zBF?hY(kQmJwg>8POUnLpCFXn82E(P4N?nrKSW&k`TH>gg`+4w|sinskLjs9oPrPlj z)QWgsbVKVb%WUAGchl9){+!MGd?R!39~#xOX>jT{(bmBct9#^xmow&>?uoBOJCr-U zOIZk-{m(PrGBDs3=)cr=jefsMspEUmpwryZrff{i=sJ9Gz}{{gH$SgON=BwQ@D{#I z#h+DuS?fKzmf7oHy;t%_qTnf3ls{+@WXW`#=#HPv{Z*{AIKSu$V4!;$5m8#(?dAij z&VCd!H0e-Ha&)=V44IpnTUjZX79Y7=!Vz^Z4%VK|1M%n%qGfWGeLs^H@jJ3oxL7F{ zedmU^)2NJ$Ace40Bkd-SU54t;OG>d;vEk8Cx4S;qI`;g<{Rta>J>8wZzf`(l?aYdV zdDu7i^hjSgziC%Ij>(H)iF%uu)&|U1QjPp$Q21}9phj5K&exAS1q`BoD_i-H+vy=a z>mfYh#)lV%O_$FtJz~?m66ddd*MBKV;`(5L76=d1CcCI(C98t@%inTb+#0pC(@gL) zMeP;XeoSB_H)k1g;|C2(WI9fY0`^r6OUmF0VL~G_`;M>@4S2 z+?8-rL{P1D`EBgWknUjPF&=WOk_RU#@ab2 zqnD_jBk{>?%(u5>Pq$Lvgz%Ugd=?htDMN~D6tKbVV5WdmQEyyz@-qbp+Rg!H8{cTr z2JWaQt3I=9kj#yt!1exvb+!?bWIY;`gh}(d`(;K`5BJW8#?EfjzvvpD%EvyHPe;JW z;S!d5gb*HA!$6t6&+UJf3jx(8f2@Xy$ccSLkbBP zro8zpBHq;XvlMt*S)B*KY|h1&M`@&e!Rgmn(P_>EU=o!^thw<^stAoE=nPQGP)Or=vI1YsdA ztwk{qoJ34UEvt?%OJH&Z#P^n*$t!UZ@XYQ*&`;7E~0wxt>!e*g=nB!fL37HZ`7ik|2rRIGAYIn!q=w3vNQyDu<; zVffrLrqVLh(i;q?4A$P>DQhmo!j(+_ghk(Mvlyl*^Q98e^deT*1k=Nj!R-}ArRN0< zh~$4;YTHds%_jQX-Ar7NpH{-T8;YAt&P^aQj!z{kv(&Yw>pkYaHt~$p_?B8staZv- zNZ9pD_DoMOgo`o{4z;I_UOew4Ab$2V@vkv*YKEje>(KxH|@GK&0rI%a=E|pY+0sl&<7P3G9gn< z$%w;xd-1W@^r%7yV;w=f0J%L*zQmS)JMD@up*;>g_YNM5ks@J&BA}vO#F#(o;)L0) z^RIJ0(oHR4&vy$L_P`_)d(l{J(b(!KEGl2K#wT^=U$z>~`^N6irZm@G65h9s9Z1D} z|4w#GevL1~{{ zG9yTFGF2F}-kTChHUE`GO9C^RU#H0V7T&B7vFOrOxx>ION2@cf9UVd0&^-0(`kKGF zlX|a5exIzYMSZCgU|ymg6QP~i4QwC_?3~3au^NEjfI(LMaGZ?z1|hb5g6ThK-__$w zHJ&28@xSNcLE=~}2h|aTU20i+Ru{{((`BCRWgbmHCqF%2;(8@QTULnjkiV5tO@DQq9X7%gEYk_8Zq$*vC@$*gSUE!Z%KgNI3DW1~J4Snm!R4 zNN4sv<;^}VDXT||7xc)9fd9<`_!Tqo(mc7yX_2ovk6_QL9HP{!QXZ4;wTzZ-%z@|+ zwCeiwYL^o*+-+_8#rZu+0_m^V;^8r0eRrmYg&*%#)svH)u(l;e@o;>O3BZ&wk;kL3 zp-}2*wmn>boMaLG3nGgXG)}A(`9Ad+)C!)0(n8~M^=fMwMGVw$A^758n@6&E+kcSS z$oR#BhE|^7%@e$`xK`5+wgx7^o$ga zwnFZZnE*z&!=T>QH3uoNb&mAUa@EycQ_tv&7VopOv;WP`Vpe%$SOWTeq|8I!wpjEB z-Pg=TRtB2@L&<^zj5M7eT>uGVJALeD!P#3z#Vons?;WhMIo}AsF2JBOTTfuDQZN6I zUNrXyr7GP*mc)*yQ9_-ddFWpu!V&pJ+KRXA#WIdjOT{IZ>&ZG3=dw@y;UP^zi=~;_ z*K5^8?Q*R{9Xd25Jn^dzxZT06(=wZ&8G=q<+X(#-9tcuiK z)7|6&3arwhXCjvB3ESCu*gmr*Xay>fFzf@HQszWhpccu+3QS2&Pq-o{mvkgv_Uw~Y zQZL~)wd7h`yF(#Y>gEi?q}${QF1S ze?Z<#6GW{=1oD(oANGMDz9oP_FSWg^k9%HlAtwxC1j1l=V?5B^Pxg*#UJ`=|xJn^) z9=Kdk$Uu~~0 z%L5aFv>W0WlrkBGtjA$*%@xZB%ac6`|2b+r)_8Z+j(QyQGi&>G0I~{fK*0#-V%)(v=cr13{5}#gpWg+4s8({k z<(hEFVpOqWRg(XLtC#$xg!9^3G0RGVUWM{~DB^40d4X#TsH`9EIbdwj^5kC+Np7QS zMv9q?GUN%VW5_9r&kp{y($Ouo+2;~&yMpqQX+HIFWAq9qrCcY{IPthS@0j+|(kS0~Xd;}BE& z_^o{AhF|k`AcZ#S6R7gsDueN3u-$=GoKAC{-_K|vNyy;fbE%Ou>OUw;FtDPOI6vkrY*F-f z^Bd&&!tN73jD03$<-2%Q>PYxqRI(2PcI<@xo>1PRA%an0Y3XqiEt%J6*ydYegmMZJ zAO7Tg7Oa!WmxZ3$>8Ke}xU9gWbNE$C`vq{rXcsG-E8NZREvt;$2QMn4al@tSU=&J9 zO2b^gZ3Ht``J%)jBocWn40QvH$KUahbRm0tgR>aAUq88+>%jz)OPrs#qrYoMbu}ab z$rmoHqTL5|E?BZ+SXt>$%P_x=Vi>F|U{_jiS_tnju2x%V)xk#HrdBVIh07MHAd}?A z2M-taop^HvJm4G^H)#yWWmNsjSgSiGTxNzagNA|d`OG}KQ1h=l_7pA?D|du=6?>#L z=5V&nU*mwx>rrvg3_Cr>&2qxSf3IV2rtAbND&J*%{Xil!KAn;=); zy?*DaUrE}Hh2%%-yst;fTr#&sTq7daBR&8Mp#n+0B6TIImD#2h8SF5AW6?o!=}PT4 zLv;pd#nS~yl#TkI73pi7M@ASU6+ui4J&Am#U8gs)$tfw#EvL`-?f3B!sc;YBhrc{l z*4B}B`27T6@;0i*#2kuX*gd7q{=hOH1N{HdELQORb~a*E_ez^{4n95TV_out8Hb?CK;QUn;sL9LuaVe!}Ei z!np~r{LjwdQ~d4|0rL%}F-+cBWwN0wlU;U{AyG#6!Kyl+p8L!ALynbo6~|+@wxwZk zs5$_ol)^ba!o|Zk`Q@aK8W{xqi@gI)qj~Ju9XE|JX7`j@VH z>8_d)(Tw|-oJRNWs@qPVi`~CynmAc;mVEg>b8~9{ncgx{|Fdo_CFy4i7VRZxG0tR1tmXbm#NhDSI~`(SE6n9h)iADh*bdj|AY^a7`8?>;y9hnWJ) z+1vZ&)L~lYhB$lz0%jf`rR;4Kq<8OK+-$hDHFyy&kVwiN0iKc!UQPR2+4Dl7obn!P ztp@h!0Dk|aAB7aG9IxNzt==4CRvX_?>QozAw)ztUBY9?eB`LUR&&^x^S-YF2C4V2e zxof^_Ua0yUO>Mq}AX1b{gU-{`wY4c%Bl}25vJy+vOWy0E%hAhUrLEn{;(KTFIRQ_I ztuwLmeLF-(>*{yzg5vO$V89i&wHLBwX{1SARO?j6gnI? z`DUkPnp~O6HxE08#)z$jM&~wed8uekbn~GcI~XjS31! zZqc$5%&?|a?A$K7?A13n_X%w#Zz4$t)|q0EqfIgHwCITgini&5klGo165sbv(y{n| z6}1?ARj12_LzCno%&S=tEO}~3A3v(}0I7XOxuFpd^z$c4l|xqk?EV@d8rmi+OQepMRft{{(GstfcknZWm+wi5vF+Tf@K2jnZsvEF) z3wlA){K)#W&aM~=E)D){ilfpx9WpA4&t9dM`6lKmoc8-S z%f}}E#G3WucFX%%^Q@?mwv5#&|5T61igH+ zY+<^*!pX2;@lgE-pAcZ|#JnC!jQ{GF^emb-$s%=AoP51Aty{3J)N#JVibQ;a7Sq&~ zqSmi;pAB+c%=6n;WUl(%*tm2P4f#A2HYG|7+oMZdoN?@bAkWvv=WYELGS3w~ydIba{ zabfhDaJ+n)RPglpiC-Rr+v5|)Hmf}Y=$B0fH{>@+l}1Gb@vE`Sy;qh|e*S*+6|yhz zYfCXNbqsjqKHa3&sz}H@EV!MPmX^z7!toq{8+a3f8Y}5as8K$xkPupj+fit|1Z4Gp{WlyiJTXCtl={ZJ%LXkg<>JZm9mVmgKrKM( zQp6Jp)DvA7PS=z~7I0$Wc&INLE4cIntC3xVji7(DU7Nar?2dzEJS1+h*Ti~Iy>)ja zytf3Ug-gws8cdpZX($7jhwTl`83| zuHT|@!(#q0k|&yl^oNq`kROMAA{EwA`4|<`y?|}Lw33Yvx;boT9&>MLjjaUHFJ>^Y zvDx1-LlGvQl9*=rUvFsAiSbC18*-CValbW%+0C@qX3YIryZgb8v(Zl4Uu9mCknoDk z797V*B_XBx+w?CaER`j7d{hNTFIk0jQwIql+)og)RGimDNkkc(7c7oQwbA{~nTU#$ zO}}{HV!4ktTV-tNxUDvKc=RR4%*^$xRrx}GyKzSDxXq6~jtT)ElS&FZ*xrO!jTVd7 zCJS+#)Y+BWUANK-tbIL%D?*-c7Apj`oQ=)F!HMwO+FCeW5sOlSa1nc1|CM8=X38w9 z$ncf$bc`RK%!coW>}{Eu&uaUL7t+$?9J>}T<0Fxy+Kh^qm8_yG@rp7>CQlv@FA3@1 z?z$hyKGC{5ORUYsG8SsthggnVWU%0Ly~U58EG*dAI~GY!sXn>60GM6hcw%nKQi4R! zlwy%h6+2HQYO1@ zG<7!*x1ZIfc!jLJud(s6f+85J;Lh%!Q8~MPq+GOsv1U_l=)dh4l;R><8c8>p% zz@v0PN$y<3`OP#khDq_YiUx-h*D1=Aw9u@!>HC_?TX8*9F4@lw1;{qPXnajotDTx4szv)qA~UV#^QM zX1p4-sRwr(^7V)H2V1(I34CjwJfMxFaX20DX-(Wsd3VPsf4g@lFo;(y=q}3WkGSpc zsBZ36Oms{K50kBhQ(hgN(c0g?N4;u4CR_g6=H1%bvKbvsD6-W8Qw!Kse#h4!o&Nd_ zksqm;Z2A(sAhGSf%8yXivJdO!y}#%u%uPU zy)d`n%*Lt&YBc2!Ldh+j8(TxoBl6(?i&%Yk#0BGsyI?+PNTNW28T!) z@8CnVIaUbNr}k!imfJVT{M<9m=%XN}3G4<$#a=BjgsiVZP8nQDC!LswM@A;ooy{HN zmR`DU3d*JtMbPugsK*FUtcbm)_zs9}C|c079h*=N&o;xBxtzHWEw8ab3P27{4)yKr z(L6YZ^MXpz%)7%}W-*q?db_P$>aZYEV)~;-rMnT*eRr_Booz_=NFuogg+x#u2Yf-3r&UIRYJ?&#f-m1 zLH-(~QagIaupuV?1?{%niw#~)tZKQU+z@9DVfR^H{YTO6M(?$18$t-s zhp6ao5{fx$?`%}z0J&4aYLnM?ko}}!)4_Ma>4$p>2n#N+xb9CsCYh}5U9ypM%GhsH zXntWKZ0$SN%X|j zm|n2yw|tLR@Ng8FqP=J~4b1y*N2>n~YwVq{+logQg1O=5Mh!-`#8k+R=)8k!km^uf z=H1GUwa&%^GF`dRE&8Xqihn>)b?_AqI;z22I&l()MIrBzxM*fC*P>4HJk_vc8tZz| z99JgaIrqgh9kKr#6DheE%dTMijM*l)i|1_nTs6q1Nhs=tUzV5qS7aBDDw$D5abE%{ zF<`0b5huF%x})rjyg8uR)@$!m&ZdRyd$bO+1bb&sXsvP9kci(YiVn1D6IH+l98LTyj{Hb#w)JJH41K)bYakbOo{wJ%xn%Uc|{@v*u z)r2E4@zB4W({}}IF>}`~v4?fR@E(bDkobG za|k0V4aFJA0=?pM^@GTDT=O?wu?uRK2y-|sq8p{*T}iCBS2{TeuggVOi?}TEW8s;P zj@DGTlS1dLwWs6Hh6a_J`%HN{--Pd@gcmosGeyEW_}?f30qmb*-sQvQ&tXit;Qh*E zj3tZYc05ctT2&2kb2kYN0ZxNQEPpoBbBcJ^>1#|SYNo#N2lq)~BpHqFDftuV0KaNF zv4pI-{2}W&M)qXd{tP5Cm%E0Hs(9rnP9`CXSAP#7N>EvyV7g;Kjg)9wRvWWREPB~H zCFeNADr;muxiraZRLsrb$~DS%r#R^Ky0a#X0Y*EcA4?}Dmp@;?BUS=_ANxSm7g_!r z_RHz~Y*j901HQtTbrN)@Zg}YPtD&KPx?D%kz@%3!H7jd#qcjoOiC3L@Y->)Mq@waZ zkQ-9|F0sAVR?MOlC0^`-1M&;;%m0wTm^y)!6gn!v^>1xIroX-Iz=D}^F#Oxc<~R^r zI!x&h8AHe}B&T6hSAR4avX6|cIo8{uIutZI(lFtoaU11tHu>YGR#stNts}$3xFc4H zR`oasc-brd$a$0%o!dbB=FCMAKcjJ$u(_>ZbnUMR90;vsXT$AN-h!UC|nEiG&_^k;g0tY-E9z?Yv+P`yCv$@3-@%l@A4 zb2X8{szx4vt4l14Y&;LSouV2%HRV&0Pn;hoImkCAF5L;uiNT{$b9y(FP{%%SmT6qQ zKo1cSDh->l6F@3NS*qd4$Vwl1TVG%QOaBqz51-kPbIS%k@Yct&pe(;UkKa&8kN-7e z;&#5ay$Fdkc(tUgOF_{QUK8cOv|@EwCVI-PLzsV8c8% zhwkj|hG?&B{Ui}mHN$H}|Fb7GYTEAmkE%8KfhN7R%l>Q?a4}Eyf#%~Wgo}HD+hjOR z`K_U$;pb!$*=kcDFsHp;;?(#^(z(csZ@YbtKS(OU`S_G5Cw<|QLxzrBM*3$iS`g1p zOOX@x4Zq@|8!=#Hz;i|kSq``oqF-cLwY`6R?1bNE^ZJ++mNkBKCD%#Z+1ff32fQU?DA0_`Bb)P>fh~`-!hc zirr>_!9$7NhJK~X>{2UGJ{{Fk#Tu3O2Ga?6{gD-kDeOZFmOhVjb?kbT+7;StNb58; zH?N(aC)L;UWlIKrB$h>vGXIKuoCMrYUN#2?vM$NV`eF^w{<^7v963V67BrlHH(;7f zmU8B%VQhSfB*r1_{iwrE`a<${T_ZLwt~vEFY;saVVQg-3(Y$H<%a7z~CQH394ARu{ z3KaPa-|bp9JU2(P@*-Ul2+f}1H@iPD8NHwOXxravKUI2IAWsUtb{O5=WgYAEiPcPC zR?9wKL9FCMsXp(gm+3cSwrpkoN+}|uvl`AiDJ7kZCHcO16yzPt;i;vr&9tZ|M=d|% z|9Yv`4x~`ve)97_BEr9fp-5*r`k%{a%nFoIcUV3F!5+t)_g>b3A#Q%F533R*A(7fs|vL&R-nxD;DPYUovT>%T27UVunFxX%?4iBB}nnDXT2-6-p!KM;fvqiD$hMpexxMbN4${dvIXRoshyUu=v`c*P z4)}99!};;uUh}Q;jV{yUZ#Lh>3d@){Lw&OR1j-QEItM$mXV_m$ZvK4KP~}V3A!((% z<6`uTHNK1}VEjp-rI+iM%%GMf(`YIbChYJafsftR{?EBKeIVnHJqWZKcB7DJvUKAZ zuVsbDGwJnD9|wHIon#MZW=Izo7Z2d@#-S@RGBWYNn?@<~Hg^qYSl?0Xi+0D7`pb)qh>8aC!%lX+nDO&l*;d}wEMLISidi;% z!WgT{iPsT-->)t+M2x>*r2%^{+_rt9Lx1**;oS0#bo-BUnzIgA5K<^Ca|7`spAiXh zznn@RZ>@6z!9LQ9hd610enkmI$> zj<=rkOI1ysR4ZctIe1J$J5IA0-K6C^6Z7nrfDscMs+jhgQHcErd2#X;hIDYpHW zK@!Iv>13rmUG#AY&zi6ASB?H>3_0u%Mzi)xaHB?IIK04q3-J&cbSEu4hR2d7Jv--lZBw5(dwWJHWXS3zdkIwfG)hCK$pWwFy0-+q!v^1`6ZapU_Jlosb%5RB+u7^zA0s@BD*698H{Z&If z!9P2G4izmc%DNP9O|0Yg>o+BR;vnOkBtlofwXV=T>A4d#5%&i>XFq&9JL8kN`*wIj zD&~))_&Frcm5v1boSO%16XO(`N~r44ptj^{^W9s#b<`ShIuxl(j}afGkL6#h>*D1F z-koQiofT4Gr2xrOOSnn#$9~!3OBwya7{+qxncGr7yQqmO^q|>jbn)PaxcOxdCPdRP z2zA}g=X`e7EVmG2+!9g{UV}4-QOUtW;A>nV8}|(Dt9Qn0IrOjI9ri}!8i*lX14^cWMZ=}Cq=N~5ErS7T$3Y0+oyTQ>>pLv!5hZt^%9Z6V$RYt7gN`{E_%|k#=r{1mA=sS<_3u&`(L?UwQq@2C=Yb z-=VbWvOv1!NR?&3$q_KIz2jo)hI1S&70FWk+G+F0OFTaY_6~W7ZXyHv#OKb7v-tO` z4e)eU#&kEid*w)Nv6GV}+dGakv<*n5|sA)B^sCiI(83&S;eayTz~ zUdx2NN2B;mZZlS`?`_#ye^gmbawwdiF>1U2Uk61)Rq0+-Mh4YWmWd|gDk+P)zYj!a z7-SB8qe$2&6HC?dqlk6kiqdkK{8xrZ(THZ@3`M1oQ?=eB$wuZ%nP!rbV*Ev9K0(o7 z4TIc|{7}YNw>pR5&t)7uI2dSf!4EN*Xi&5k&+Lr0VTn_;sn(oj$Q9(;GN3aQ3W`ja zu#|X(iGGPdJZ+&+=k?2!loVvxNIqPdKb&$sCX|)Upq=ZKPcKNeT#Y&bZ)YPLFzuJz zuda$Ni3I_-iXS2s@Uh=6sMPz-gm#ey3JFP2C`Tqq%__Y!NVJGT_ICGV&-@Catq6Nc zm#l`jQ$}zue2eiqW*|KacG8qpvyn)Z^tnJW zig;pkdWP*FOaHHdx}9-v1OLJ=h;}lQB}KDvy)cr{IoRS$G2lDKR;t^FDd6dZ1${m*2dkv!q*^VA%&7ut@u!aKeT-SuE+g^c8*Z8 zos8d|otsgZM!x?}t-vQ%y#AH6OHr9inb3ib(D`*63V?Mk*fX>3+NAr6fyxmm)8bqgY_<vgEi958#BbfY1#;=g_7PV4=C2w55wUDJbpG-3IDBCP^A;Lim(oXEw;_%+ z>UTC^#1Q1Opko^08tK~JyFTx%E{PL<-l%(%$cY$8U}DoG7|wIt_|U$#Tmf+O(*H*} z5kB8H+ZJhC{Cj7iRcB>Cw)T7%kRpn9*(;Kv=jopWUVz!pKUqNJ2v**z{lLq^oerBI6-C^YRqG|!lm5HUEFE~t z_+{=r>O8`npFM7Bw~jJkW=(kFDV&6}Io1^KJ1XheE*w)z&);eGiYw(S&13=p)YOzm zfM?I>A^{`L+1c6EvxE*QW6@c>+wEn?P8OD9bo-);FikQ=M;jx)Gz{8afT~gVnyX44 zgAi9lGE)>%>su%h;?<{yS692?6YYYx2C8mzxS8m+c?EVX@i0&-bT4Dp1B7fJiTrX{ z=;=t#@b*#9Ua)5H>BQ)>C1j`p$88p^VCOq2c%@U-=%qw_+)N#tll}e6dCJSv`x+aU z%NIv7mM{yUjMi(Ao8+Ff@3yo0a2f_?TYpc@R1fjC8wyQ`Aq;1{&s;Sy^53-5LQ!V5 z$x-A6W`a5W9|j6Cv$MTIJ>x{+S(^{y=$j;l#G*L+b_YV;#=jA}vP+)O=`W=IQCx_M z>WAw*)8i^bl;8Dr8iFDeWXte4#Gkx>O>GIowPo>CAaU4i`swoX4mj*=SBL$TXu+h; z=7v@?QZ_~R>dWms{|-X*$tp7bxckMqvh>L!>EG4(zYzfAzCg_kHdnTn-dht9SAA3N zZlRaQ#B-aZCx)E;Svkew=_%ajF{7qlve)gK(9jFSiRKzXu;{Isk706H_{Ih-&VtU{ z%j%6pkw!K@9U(sPkDuB7LU3Gh2*4SIHLqI1D6?f=49HyW$q3~P z27ubSqE4+GMzrAgB6PX~GtARpngV+dgs&f_dOF_dQ|-``*~@{wz8Ch}LAZ~VKXxi> zEQ`AJ7|fUmJ+vv` zUdZ|N-{zxjUkrC5Q*^7= z7J~Xz837O+i73kQ%w7@q-K0akI4yiJ-+DB&a5j4>4WgT^as3$8o^SNsyZRlvr6imm z=M&-ZJ7NidN(8^1C-1h8_F90Y?=>+>X6v&D5aU<7B6LdZhSTU6iS+c5@y(c!h+l8k2 z`96RFzvb*d8Z?!L{JAOl;z8A+FR!ovo1IueO)cA|R8<;9;#Ttta(M#-#;{*+?o0my z_4)I`%M+PML_}!2cKa;5YT}`%fk9mpa(ZRM&*Q~7md%k4J>aIMrlqCTh(^zYaC^RA zC}UTN+qXnwW--D|kXYO8T!$uwx7TlDpSzon6JJKr>CBogPJi3_TjqO^?n%<1X-}D! zW}0d76b4Z76$rP11>J#}7PgQjvUqy0!_1K8JLmjgpd(|+1Xc;UmSu`j%OpR#z((WX zrd-mZy`fBy7Y5>I|9^Fa-1*suJRE6(?ypul|0Iyb8n95Q{7YEI}b9Z&h*T*X~P z;x;2FRj6>D?8#huUjg9VqZgM)boBJQ>@RlN0oTi$#>ykr+FkPAf95@)nG+!%efh-u zyME5z{x0SD7n$>$mm3TWR-3qN*)|-4wiuDFL`#LRM5$H0{mBFMVjNwc@>vg6){@&_ z94>bHNt&XAD5qv*k4ax866EXa6>j8cPv7HlM0{8$NbO4;Nm9?23i)hZWhqIs_xILz zO~Y9_iz<=I`oyM5F&X1}fgwh??;wLTl?N}HxDMvGJH1P9RoV3vl4V8mO7I3_t_Ysf zqcWmz)R-jBQ;B>FvY5n>K>L>*q_(#c(XZ5w}6tc{o)dA!oz$yb5D?JgA?Ct<-)U2#HDx!cIEFOz)N19A!AOGnQdCrsmz*fWtbH5Q zdqd^U+PZj(;xqWTOBWDJ_|01^n@kh!r~&b~l5d1&UMcC%h~%BP9f@9?PmLweJnil2 zw10tiiYigZs@~@`-a;?Es(0$eG8H<>9r+w%Io{yk#hD3sO?4ON#w>@T&Yz3z7dfHr zgYOtZzrDD?zSucG*%OJ!L^H`m2Mfuq_bnzs??50E&P;|c=Uh%WFAsX!AAOLrJK`u@ zrpYCVaa3b+dHdv}PmR4x>&L001hO`hzlbWIVc@T+LrO$ zy-50EUvFS=5C~L&Gk88fj+nEgEw*JoZ$WNkVGoq@$4*>e^1eb`2BM^?BAGftmuU}S zxD!UAmLJFTy>WfDv}4!0&uoW?oXC86-+%p@z!HmrW+qKmIMJ=7WzGYzqjiP(iH?;( z972({f+M!Oo7idnxtrmIMk0%3;67+$n&>JjDcSm}8bTdLq{12*IYb4BikP%?fg1O{ zd-qiK;81ME%#i5ID!dq&Kq8YfZExn@DqVMJDK|K^Vviqxf%a`}@ol#r(Kk0Ymy77P zOR{5*BMRz6TD_aA+^X6Ziu~51bYQM}G;^7{NV8Z^12jKrt7PHoK?H&dWhN(2*S%=0 zluDTs{9%I`c zU#!JC5`I#_e7v@7iY4Xa%c(LoOLV`3_a#~4k>wUK5|z}n2K94Rn*6Ynbz9vZJ!j$9 z9DKZUw_I12DcLb~^sa${U`9WbQR0IJk(|H;_0I8*&EetUx8azQEs=!TOr9J=sqt~zbYcX*uXy)X+XC$*=X{YJ{K({T5b*KyUxAb7f6v8h#$8;U%ptK7 z7K;0Na&oFYd;D#`&gWkXYl4dXr^zfE&hXOvn`2R9zWu?{4v#+6BHGGfT?>No^fFiA z!|p@r7ZhY-^_I7sCbtTI^5_^?2B||V4<)BB zs;Y7tg(_;3Y$kSy!hoN$h3JM&R-a@>e>xD$Gc5!%`Z=Orzj<>-$$DxsONd`dzn@u( zn30j~nJD0y*9t9iJ6-c-me_9Ka8(wAdULx83XWlZqT{cTF^7$JV5ohIBcHN(D#5#0 zZmTSr{_>MZ^N#}v__6kJ8XbNM@;FoH^2qIQb=xa*Ij!^7B6t48ZCPKlnudmMhQD(R zyI_up7f?0;?Ok3j2ytyoD9-R+Kf2X$4=P&dLyEkMC$HE)I!X>?FCgLV7L-m>P5Xto z?@Fv37)<~9<)sk*-d~h+ORW7qD>p}RgiRVN+K8vItZ%}H_SzGV02pTX4TrYCmxv%L4;uZRQv>3r1Uf?QWE^zUBI9x$hPg@oLlQo4U) zXV&gJm_jLX#N>=HdYCQ<={7Zg(N!YBs+DHjN<*IVFcrU8r}tx?GmSmVm{{R3P548l zNHR{OeRKvdE>qr9{JAam2;vU+tw8@-d`^-E)%KI-{Luw1I$6^>vX+=Ea)_ogwJirEPG z5X}aciSB&8)_+%y;8d}lSe>F6^Tun#S1F}!Yf~;_GXGSBtHkq~sC}h+ZYC_sTN@ci zBqbxW0*VAcqbRE*1X{u2AyuqWp3{WA_vr!_I=fI`?mzOvSmbDKrT>|)qH*e?CR~n8 z(e*(|6q#`<1Zm|?dy;!bEhrlSgb0#5sOkoKaIgs-2H*Ur;R*Bp#I70rzjYdb2RWKbI#H2MX#XSNRAbvN*ymY?43 zk2yU9u??-S3^&(5yE9EJfK6$I(y`Eg3%dCje}|G^+YA3r`l zZTEwLNHHO!OCRe>^NNgQ6DB9h&Vw3_q1nR3L``T~2C9m-ZYFCfs97QLZKjQeN1gEy z1!=)gzEkOuZ{cgiv-E$fruR%nV9->pea$=J+(h`28vkN8icQs2YA%Ug8)ODB9wx@( z@)Y~k^GY4mA$_ve>1c-C^sP{`tkQ6IOE)!R4Ey+u4E$M6bU~oKEwLBd;rK?sx?ldl zY%hDstEaOQ*CKcacQ8Ju#)tLDo*o{bz^?KnL&lco)^*j(>8o77pN6^7u(!nU zow{x;(jW*cza?>`t2QrIP{Nhk$7*N5l#-Woq?3Rsci%8-<)&d@j}xK+F*)Q4$KcF3 zm(_tlH!yHd=4^cM7yvo{D}GGWEeP}yu;!n_SI*wD=9o;N7+RxAWgw!a+S=*;+H2%e zf#IK`a1Es7Iqp`EsNVB$p2M0B1-V)D(T4lJtKEp2@zt7s*AhjnnJh||oW zyAHLk@E}z)w-qU}&E4RB7ir~U*jYvEJyMUsqd=qN9Bo z1Pw!EoyprcL@D_?<|SY082f8_6w!*4`-|a)f^Omy*ktLLTwzvGQPE_(HFU#5 z-rBC4{ZPB2Z$q0%eYvw?DLMEP*gT$|Te{bP1nllUczb9lU2^a`kn2kPJhkMa>h^3U zJk>V>5Cg;^#&N3~F4xc}i63LF>Y!Cd->-vZV^Q@oxzEiSkUFw)ph7|&Dvx_(miYD6 z8q7e0adi9%R~?1tyJh|gIyg9-gOLN40#rXh)#TngSA}GE`@j!E&H_fx6wBg!r*~>w z7`HZ`uzVOS)Hi&eFI5&ZRHyX*+C$nEU8Bh7$WK`rsJ?bT*TRiXE0>zyAEX-Mk<_EZpt*qstog$&r#7S1Zi$AgY>27SmsS zx%oZd#oJHTLmQC%GInvtFcT&BOoO#OHO~%8S}P4)Hd$JEh1ah`ON%W? z0_u}*D^zNxhaG*RsbjXtjb54?C4Fr^u{kTub=|eUPy`?{ zaIlwa!~rXIL~%yF1~SLtKz*M|-CJ~V(80>r?LJ4*kRHcp^3G*zF7?xGE~2dvw~0i3 zzRY$mb#NrEIl<8`Isq9RM8y%pS1ne#=hAH$MjRj^zPzHcvtH(H8W(=ZWI0%Cy-T(o zbwKu2mdv>r&)K;eSaUwaa6t^vo@*v)i-e&noVOQkZTR<=`X2YZxngn!M;}cYi%#=L zy|7}PmwztJ>XY7+br4uL&pcH)JHqEtp@kqIGmU1i^LywvwTyPpa{D2p(1z<5T~rj& z)RdIZBroU1u~>Cbuy#0m**eX9+RBR~h_1$<{a)>;Zb(6OD|^k3L6Fx&<`2 z+*k5wD8MLfdHP*=DrrrRS3#iIpS`UX)^**ZKH=GfoWsekd+cAalRs(5qBvAdM|8Oy zXO-3nbyiy3LgU_~k>CfL;9tT4RxpVrLZDn@n6Qi1F}btbNh{*2iC2jY$kP*D`5aLb z32FSK3re)T)pE3;wyVJ9Y#nd9;*UCL-5YK0J}j}heAE!spv$R9)}&Hc?E@*NT%iQj zcv0!P)vL(?I%KZQX@cd(s<7#0Pd}J=e&Sc1bEqD|TxnA0#o+J2OPX*Z*Hx(}{D2bF zCf(P#uM=3&c--WP^iZtp!wa(>`}Y(R2aEmi!PEhsK0a5i zHKlt_M|@pN{!!mGs_8!ktxu`K>Gn8RwPR`!>i8mlGMkqrS)+?=S zVOkKVuabRZU0rPhVTfCg=QQ<1om(tjMMhi>M@ir7lQE{aY=roljchFKpW*5h<}t-F z?@sv-H7ixQrM&>e$&WO1=<3;O#JMp1vfTN=Is*VIfZYrs`^1AeGArXX4p%fvSaY&l zhQ%>iSEEqq+B}EbVMXLT&Zt;bML`lJ!O=?0jA-r}V|Q&(ux=gS_Q{F(Ra#?bX9q^W zcB;x3m4lW~1?UcY_V77lVQSShFbKXtmw3wb`O_oskjF~(8^L}Zo7k)okO+1ZVx8DP zgL6||KnR&7@z-m{dKW7-`6hiX>*FD>VD<6S&z z^;ebxBo|Pe^78V=#>QX3j|1dL@H(H=r!^VfvUIjF#xP>tk4&SOQs=fF#k`UdfMEU9 z_f}SbYvS|**f!n)QC^6O5PF1xMwde-%Hj>s78(=vK{GVXBE~%y&`DqR?dIv3)@f`Z z&5`t4wQZA;W&cZa{z49d6(icGx+J0x_MPD6DSAHY!hq^E{HwTqGKn6f#)Vp0qw-5i z>Z@*FS!Mv}l0N?zz z(G-ivPu~j~^~t!yI6&C3_6$G8}YVlYXDez$@4awL^PzpU6i`M1W zKyo;n)dIn=?ebzfiRJdy{_O7V-n0?v)Z|vWj>>w@#f=TgS&_Q79F41sufG?3J*s$bG74DolsfA#n(I=$`9&L+J@LJ@->z)@qUSfbi%^IvV4h_&B7L)FQ$pWo z{Fd*X?GAB(SC}oW-oa=4{at|0Y@)22L-3e@Pp6(m35+1@1-|gj)F&d`)$}Zh!4SMPH^P261 zK3O`9X2&frq^=nld;0oz0-*_u#X6$aD8aB1zlne?rRIR`zuv#RrJIAv4^r!WB{NV$ zxy5JD^Fi|>T2~{UWh$G;_5r#cGL(sW`s|K|nJ2#rFfx1=?HJTs~rtUGMUH5Vp2 z{!gHJ4ioGWUJ&1S%rq6P%V|fd&;JuRaTa1GqfK&K$Py8~+wm~P+bXvBeFup$uC8qvh2UPX9Q;Al zKCy9d1gfDZl{%d~idoFSB?7?BFuBY$T07pNBnMc}*Z|ISad#)} z7A!0*yegh$;pMMtN!b~Uwog*}+;7{zX8L8=MPva8Q9ZW9XhbWbduE0nD0pP8H$L^J zidK}LwOFY5;TAMyW!DDGK3j}Xv$$b3*3NR}B}^>gN>CeOAY5H)dhE7o-4tamn_XD+ zLx~nYc;)sb5b<6$r1on$^Q*O{?|W+h1GT`LV-G|ZB$D}x2{pVp6Aj%*G6>SdLWi(? zqs*0u+(vlyBnl3%heO1XZOFDDsT;ptg$xZ0Kq(kVbHK;y$3D9Vh_ICY26z$SDG zpXgDlb(>9H6{|R0zo))?ELYt$Hv5xjP&A%Wdi>LNdk0e`0?%q9|FonwIX{<=Iczh5 zwV7<3uZqgb`Hi)T48!nttg7{EZh(OQBZZ=&QM#gvpDw4VzBt!eUjb(xFn1aVk!RcO z+6D%aL5DHg(kB25fTk-zm%N(3LPhP?+5~gkVYQx+58}qJ6ckxo#RuDx+295A_`j`8pSx>XJiWb(2U}C?;>W7K&T?bmK zwTlwGfK0QYrNm75S*o3u(NX8b2=GO0^Ua=LetiWN``UE5??I}6yuLp5k`lzTeelWWZpj>9H%?{DvurY|muqqD zo$yf@UsY-sGWmPxXT$r}K*+?reAdk=(`Nkq;bhuxz6`t)XC=B$1)X>UGof~ovedU< z2{}(gPS=P9rHX{|;(Bg{)HnElBQ0|Naie4P1SCk!V}9U$i4G{D|1o2zo9N` zy4;Uni82}&oP1#NLvVQ2jPJEPAeEqx2fz%~I;9{|vR*IL>L#Qpn$@l8_IPglFXhB$ z^0qm9zRRA*#b1NH;JziW!8E=S;^)YIW6#4IA-13a$$ zzesL9w#VZx|GiyviqbE%5ZO%p5vWP2tl&R)S`Q5rX^$j>GWHc)rqeSZcY^QMbU#?3l`OC1T_U%oY#z@~0xOa*)u;9u-?oSZpNvZ< zsOXH@MOicBaH=h;kg(iV>rx?R4DTa7$hxG66@*lO__MgDz|YTb!YDySC?+YnxVq}- zx~u=}Q++-`ZDh_vrm}1DBe?ui2TCe2mLW;3hN%zLiCDiiO-}IWzR|xiw9$gjfWeo2b^YA+H(C$kGH$fU{Yhk+gCpIGG%Ln9dimm`e z=2Zo?A^lz0N<#=ilK*mW97iMdCa5~B`JmYpq7e_lEHw@$Rgy3w0AWf>oEaW}&;XgB z6FRANt)y(Dnx6ohwKbocN9s8yy?W0te!Fe5xgkIlW5Ja_!KqtU{(*lPMU>U=0GviZ z!s}iT(XQoDU$>{xKN4>i&%EE1zN{W99V~hwzap!qn(Bbhm_E4teYt$CWESA0{Yh`$ zd_>w2)&4D(NV%JJY(B%cZd`wexvCesrlu&R zxLZrOYRAA6*VosB@V^M)IB2;qrGc@)))=o5uP|-s?Tl!w z0_^0YCVf%q#lHGs!(ElF(23EQiT=sY)|FW@Pl8^+VDn;Zb+?kEqt-an*CJ%kr5}&m zc=?8v6Jl@!DlALe)nyo%@^VXXI}BYTKiOx&0C09A{#SVDT9s&?Zqc-Kbpi@ut=S** z2nxj^jqS)u{33L@F<%-gqo~ean8p(*BA`$Y0=%%M8EI0n>TnqN#iOlm70R6At(fl| zx3mQPldr;>AXgvztZhdH)_-sS0RS2p5G#$)EHA;?8X6)-4n>H?75l~xEvF=9mqGYA zd&Pzv;eC@&&a^xWj3|*6^8SB={d2~kF(Tg`gzSYP5TJuFV$K7fJlQ~%ixs3I%O8bl z%8nzAKN_8$$%WyfL45eH7J>TsxOzm}9LfhQLN$IpQhkpSzux}Fq6+-8{r7nLs$&DV zz#vRQC;0Hj0Z>LjZHF!CHYoBw5FJQVkY^fq$i?-&tHVOfq%@4NZ>xr{9hkME%LTgx zva}|bPELYnL@ZA-G3FI3Bsa}zB;4V9O9d*%8~S@FZ(|5zXeI2FFJSiClD9&*kYcL} zd8yx}bRotk47QQFp4p3Uh&7oqRX2*I-g2oiJ5T<3$k}(pM=tyR+L4m2u^h`aT;I(s z=#XvgaF4@Pp$qaa>CAGpNssVjVJPs`fiIAU0tC7+B2?w~>M~UG@3=czgDX5~ePhJr za_{Y^FG6#~;y!23j7E4XPH9-nEW#@1#H@x zdrqIbfq@P$g}!g+M+*V^*tLUQ!^Xp_F>ijWLJm@r^ZDC$d+XYl8f1-OoP-<5aR7|ccFGp=hQlMJ#cB+SuHdi5P zlv9b_XhC8TS5U4fh_1P7DCn*-CheZe5>0w<$s#aA@9lX5swB`QKzDC^a&iH{$T<&i zkwB;Q^&cYAtz>hVi+=OEdd%w&bVekQvCQi*d63aWy_FQ#$|-3|Aw&?;jO1wBM}p}3 z^pnenf^ShX+kzTL#0TlXbCA8|+35e(apfAP*{x6~+=NG8)f(eMk;HS@rvO{ApYsE* z&+L=+NQPp>qMbS%)4zDm_IQhdM0a{&pIIuzCCS46=&npab_H+GS-1b5(#3Ae{V&@h zPyW>!02}rOhYFO6V6eV59vs!g_e<1%R>pi3i}F}~WQL?RYs%xX0>;Q#t-v|j)G}`_ zRD!2FC%JgP33NATD z#YsM)Qd_6;*kdJ>LNH6~xQhW`tc zf9_Qp%m3_8pUT9}_$sxp@#wyw`+IyLsLnY_bc`-Hai}Tb0u=HQhbDj@cZ-jF5p7C7 zb^*(+et8%EOek~zpou$vDQb%ZpFR&d%W8+0F*d06X^j6TCrZZ;YwH`k}L+Xc+)ibd{V;Lmz~ ztaNCxjOJBc5s*-zT7wP-CrtNKt4LLZv?`{se3^ zksN`~rgbLh#}Jp2@+g?dr2HTrhy*}MrFoqVRE?&Lkrk!V5~?_|%VB|Gg9sXVY5dF{Hq+gW`%C!kDg zltRPE!xhzNVneF{>gyi=DhX{O=%g4lVwmcSSCeg%>7y*I;*t_qvE3@onY*!w)i|Pq z_ygaV>EPl1m7^p$$m`dR=cD=4wF&`UYOvZePED{guF+>W^tc?>D2iP+&NA?xg`Oe@p*P21K+aTswx z%@SBA#BwaUd&6+maPw~q zGcZbyg&0QTil&KA!pnj$UYVld+A>-g4tArB>vm>UEo)X9U52MN zfr_#+p*dd(ya-A{Z_?kH+(nIsk` z2y|1hD?{7we*)m6uQQQ}|9yWBVwPPOH0;TuAja9&F>P6QXNOw4(nU&CXs7uGZ(`5| zE=+}hx>k)Pu80H0__O5`GG!{5K%mrvSFsJh8I||#j7IQ>V$Y^cgeJmfV0sO##C(|+ zx&{yfv#NA{j%NWT%+UR_yhp52WUayuKyKKyo@{lnizIt178?;MfWh>y4hdLsf`lIP zkFC&cZ~4NQL$Y!y{mk>O!&RmhYM~$B&3%6L< zP-YJbC`+eza``t3w&SQ$bQ23WyQsi38*8f9@4E7clZ2gGCRyLtcd5HVx*5;6UV4j>cZhC>eNc9ay!eN3u3XbBju;7*H zfIlHu>Ob#4CTm6COLp-2xIKDh`)$9wmddWxVcUREoJ}H&u?c*88F|As*1ExFraiTM zay{+R;vEP2qGI6PZ+^&~7It*k=TBc6ODHJDvAx(d*-5hTPJPgx%X?Y-l0bPBkwoQ+9rSD&Td}FjBf_rC$>;}rGt{m8%C$UwX%aaV2y#VD`Q*A(Va*|^P?qMjS91)pK8shh zY@0U4=2L#Al5js1Ra^HqYn6?kBg99~4C~t6VgcWlXlQd<%cUFQ*R%hH>qys)>N6%&e9UZ4 z8=Fi3;{nEAQ2qjqMkC3E+|IlM#0QWxyCu^p;35MeTT`Yfv9cg?=q2d?0AnsDcduR?LQ2u|x*@^HRcFwC=DZu5739)41$Kr*y_ACLwchgx}ffxfSz!5SOm zrw1ADDHwUj9Mf*E!z{OPX8pU`;N>!o3Y*ud`+>g|buCjRAWEFhv12H131<35bhVof&cdoPoH|5lR0&i82>8 z(%@gM#ulmWovSE(+_7*+(fziX%yw${Ha%9@lbZc)i0&&6Tmv(!TE-}*)8dW8*>xGO ztjm*flWc7>6pTeTnSpUavU%FW>?T+!O?=RXh9ArckpCbC1AXi{vfThdm{*>%I=B1G zY}U8)E9*@hHFk`1|9Zn;;@)^)}#X@T-F@B%!naK{kGkr8hdx@(L=5Bt+Ag6y^IKIv|YvdrJ> zSG^veNkMya09qSf@U^$o;$-DV@&;*^%FJpj=t;V+4Is!T6RigMnaipEy{X?y?+zM~ zqU2uFAty`EKaxk!)S3QM80wYu@xheWefZY?nb(u%gs0O^8Z&|igQKxUfg@miLjw_D z)x{g|li;{9xR@b6W0m9ZH;D0VAU@d(&?EB{7L-Dxv`~%)qprx*?Mw!sTy-(O{bDsK zjH`(%Ci`a3IqCSOp6`qPo$Z%1=)4TRRkpUS+GzdZ+s}%p9<{uuLKd&X(d9#RrG0f{ zS$ep(#seG=n)yziry*t?j9fsy)K-TfT#g8W(!;ZX6i{y#i`)lM5NGE7zx+nUkJFr> z^f&NDhCl6`VNn|w;a}gKd4aeEk!^k0w6wn&7WDW4`M7w4CSQNDY%y(VVnvrXYny~@Z?EKR^hG#X#IL7eLXZY#*zfjtYU_v$tlQc_=rAXx8NtQk8Zwg7ae@$HQl z`mgznDQg;&L9!Iy%O@^{dB*>Jh!|P(+Fa*4P|EtShD)(b>8LrlAOYExWL8b8Hs%;i z+CAv`#<9*@gK!fb?5UArgljc^Rx8#K8ZHu49XD!X>mPo!jTwmMyW|(2M z#H2|&oaZ4>M-U}p-jM#W_GfTDQSJbzbDhL1Y{$?R2QE3mNPR@5Zj+|l^7nX!eRI)P zObo&6KPN`aVVIj1U@(m9c>-^GVp7E}(^tv%dOHu3@RrDi}Z;Q@CmE<6x+v zNuwkC7aQqd)GrsaK(0LwllF zqnm0uNwgw=`bB!v4QL%^64PPA@lGNX;3fp&bzalLw|3)s##-=YTTa`r9O?H$CK^l!WN4`f{ac|@s$#GIdul3+D*$yXuM_SC)t8GPll4;(}TYJ8J z5NJb<$X-b)cdRp+`JN@ZAQejlF*~xTEjX}>dogIIZx?x;Ont`qUL1{hk!lq3fxW%` z&)YYF+8t-Z(?^3ld0&lK`u7_@x~sWX!Za9|rYZJ8Q_A>^cg^?e;5u2S?L?w9O|`eq ztwo-4HIdbKQZfoEi;65BkR3EQnQGKkbL`5kI8da+;RqcI1Vl=+rb%TQwJ_A7l&jo# zzQDe@(?aq3A^sVoHCUIM#Uf-)<$aa{AA$6)z9&nRY_>PLOx? zfi}rYJ3U@2Dh6Zc1iSDcC(dh{bjpqBE)CeL$w|oDH~7u7%8%g!Yl2ihRD}MKBhvMH zNJH*07!i&mdCZOdnrhXe=cdd&u|hQQhy>lrs6dSc39Tqyl&i}mw>tfm&TpN_(y7*p z5G>v#WvB3yc!P9ZH;;xAfeMc>&0YJ#K~Q_#$x?g`y{oL5`_$+O+|H=L5X)s<`7LTF z*V%`I0$FHz&y`7A->38;z6BXE^7TWy2&d#n)_hTjN8e|TF0AFWTcyW5^f%iYT$>3S zMavzj-rDJnERf|sS&M*oSGzXYP6yiOflx_{pvGsrVut@OxI|WY# zxLsqp{It8EkdWS3FZ6dTB;2|~H`T%R@qtNI7Yvz` zp%S3lS6-54{&cjzGZ)QtokXt`hIc2% z8Om$gtC~M7z>nYY?B#!_h6nbnkn1{T!*~54@BpG%{^(>CI*l?s{SQd{YeetdL^ zNsu;|EL`USD%+k@guefj@YRTI^Q>L^eh;Z)9@8*KCu8?P$nvuNhYwkdKg5kE_}M-? zh#TED`uLlWyRWClinuOMLo`HANh?kf{szLMU`JA_^CVO&k!&34L_(q@1!@UB9SMyC zJ7)K1UFXiEc`s<{0%JMb@k?`@dGsno|9t3FO3xaL#rkg=y z2=H?D+t&cm>0+5Nj#t{|O z#j_OS>M%)TGQPOj*oad{BjCj|La49vCUS`~DGEA*f%yvasU{}c(YRRpwDG1;CKc(v zOHUW>S2ix$`9?l!8_-oL&0j12rD$suHb7A%I@|MTO31~*oY(E&Q+!tyVXnKFVu!+gM^Xyol0Xw z%pjvzWskn-nuliy4qkd!vEqGOkV^^Xt(w zF|^?w6Ykna@rjz>BSfu-cxtv^Y-t9(UfXZrY8G>(l_d)6eg)2@*w^$f%7rNSB$#6j zS}%Ycc=HHYC75Zp-x+I(#!Ic$&S<;9?OBE7d}QbyNR!0NONvDFK4^HSpuR7xEH>d{ zD*reI78+$zdz_6-Dg?x&Xj&~%820x%O8_vaMR(!47^9M%9(GuR#R(s?pNpshNr}XewHkhY`N?VW!2P||#|@{Lfd&jIb-BC$&L!%0qJ z5=ESj?ICnw?C(HUx~ zT(_NbUJuhWD9S@%FDO%|G8s~$Xz&xd;OI(l!vkMQW>6Pj^H#)lMGcMQuTNqO@6}f` zR>a1A&$~&M_Iu|b^fq`#*8iR{l3gt^j3X*NI~&a0TT^8iOR)F!tcvj&HbScI(Ab?A zHR1JrvHOsJLQS!(6_0b^p&vcYjw~Xs=w+xIM$BOC_a!D2L&_n} zYP*u|`!q4umDNm%y_q_84)Oiel;Fg0{R4?q%$V;#HJK$e%nKt`9wn%q?bz8qhc5`6 zsUJu2Tw)yoAlxlo38UXrOK5l$L9=6@Udsv4JHpmdTk^xVIR zS~EF*AV35?vm$Kt8$wX5M%i3VAm}{#G-Pd;ED;Bh%oNvC?Ll`32}#L+vYnzPxs`hz zzy=FkCMDcCA}~y!(?Cn$k&Wnec)xu>`>op@>mgk>LGMG)gCdPyn_9|CAlU{x+Ga!5e zoXUzDAn$ub2=;x?UK!dTPkOE~=1@4oiM#d%zjxi}yK<+Cx6G}>(8&iZhV8vec7uD4 zbx@E~uZcX)z=7OPF}5`xlEcJ%)jH(9dc5IEv24;v)A78*3SViUz#u|vkI*HkV#Tc3 zx;`kIa=^jYgk#G=5ZzjY&#|2pU$35IEkj-6p@j0$=dy}bV;Sz9!I343EI+@T+;PErXE>-+puP`z)WucXd2MJ0l&0J>gMd+Ccfc;-Nol>p1WBurAU6Bt8 zGovsr$H+C6d$L479EFQUA*VBXcgb#u5DIk&unl^fPIm8o8v3O2Bk>7Ie5S6MSiX_{ zyDn8ey%mNPPBI+X=fD4*z?hyD;RTT-mbrnf$1Nwz8KzBM;o;%9pc%@FYODDoj}~fH zQo&cp@bzK}(=D$3x38m`C%BzzwyCBDTmgU_S^G1j%urQZ`!(nCB!|*BD}ca}#~^ci zbMx*@=*rP=m+c>$zR@9b*4*LM%$rt z{hs2sxV!sk_P9$F%%*+paU+SiO2B+u+*mY_s6e*YXCR|&XnoL=jsa@rY&yl$2kssN zQ^rB91za*D7WW0rBZ}PZAihf%TMrTGtSuE*1zk8x$}*=z9KUmRPwb7Avf0A*rklZ3 zHul(CHY**5B5@l6BXCZIHH~QSsX*d3fPDYl~jh5Y!klzC|L*; z7=Yfsu}?O3tDZE7aeB#b&$LFDNVZq|$da>O8|kN*7<1I~r|AZ*J*OAf!IgM`J{FGH z0XmzN^*}^Kq|tXnBp`bZ&4(JN=;Q9o6c2ej;-FO{&>m5LQN8Rl+(QAj^~6;WRemYP z7nVS*?@2e}*5K4IiE*yG>CpbH`?)hp{nn^$k~3G5$ZF}gS$r!J45-Ja3$vb3?f?~{n$-W(RjAu)A#KQE}}`M>JEIx5Sx zc^4HG5NRc(K|<+}5J98_X%y)WXf za?#n?5RI>_utPQxYAiA)M$;#39nDW}x(W>KZ(mE=DHt{)LgSvANppDnG_%OG2ZT$RxquRX1&FHmm;#%norh(@$mzcM8sc(u_2Id2dPJ9#bjDsi2%bS zAKx$PM;xxUQ`1XrYmPfh&nQR?-ead{U)e+LF1DwkQ)v~4tgHmf+A z4DDr$O+EUC5Sb5FH%{A~5s!XNy)d;U!YQ!^6WU~>-nXp@UI^bUE~V5SW3&jZd=TXX zA+X_XocsOzojGY{{we+dy%Ukf5evdNGG`-CezHL%i@Cnux==!mRSu|@SGXLmF}sqhy46enz6krE?`cm>LxYdPfbb2yv^f#C#t_%a>eE6UT8xd|BqKsq8LqC zAEhpsCO(V}r>N}1)E+hNR*5w=%=TBm#+1SGXw-!eJBy@p=*1X^ouf`%`UfCK=Guon z8hVb8MOIwmCQ@{5CmLJN4))Gk`hMeZHf$5YR1P_zzqGi;45Cm+)sO<87~SB9%ZTtAyC)(#EJMj#AT*EJ)={)BQ{md(UVVj{>5l7?i^NJ*MAz40_*1Atk{G`Lq z3BlRx-ZX89^>N`-9lwO3iy%t}GfLC+XJ;bB=FtKbKP#-zuIRbGcMPw256Ok2il6aY zLX>#2Q6_9x){YSC~uRANQ1UNUpuLf+$#bOtf@8HvvMZaPj&%bMfq3T;67P?KNuinVt^_<~$R>%dzO!nkwWPok0`4rSHtIApFt-M@=rw zLGFI_=Pr=Ng*ij>1E18q*1uk@KRZ1-9&0+e)z#Hizuotw{&=$sa7_Jp+Grdf7xsU@ z5Sg0si&$qvPKI*f#4;$H-&@tKo!|if!_VJ3FfgDIo=Yg0eQA=7M(G|~f(3|NM{wcF zMtyWzgi>bu1x?bA5n2(NHv$Gr-<}}L6Dg(?bJR?tCTm*2=Yt4sJ&eap7V}L-YeL+{ zl{npR6DzH$>DWSvp%Qq_!O!B~n7EDgdi~@1Zb=qFwV8dtAFlRYk>>4pNG5~Wx2NZ= zLVgep2i^Yns-_Fogz|&Z6kBD4Szu!nRI)uqWuqG2N*rPJ$mZ;DsVZFKqCfNzKb!X% zIK=FoZaJ!WKOpIVou-Q0$lv zZCJVmre;BF90Z6r!|c5Ly5czF)-I*9U0oNkE4VlEksS;81J-~10TwOL9+ZK$RUl&j z>tG>mVWn!y%-Glu0yG0j2Fclhvh0#Jj#d)U10Ed!XQ@_RK_GO1HviK(H_{ z(lRWYaL&x*X~n?{F>wn?qrrrG8Hm0@ALR*_@w?;sZ!br;=}?VnDR6NeffR+8=;vja zZ}UCEXPW^gWNUFu_=4bJJ(R*VIdeuw;E37jNANQ(a2@$yd|5)LKSQCnOp=E>C_kb@-60qBBSo4lx35LsR6{>U8 zDdBLJ$?J62@^NVM%M7rsh{;<=uA6Who+4!nhnLZ3N;>l^a1}L(nJccVTExRtmHD^a%m|Y&17~insO@ zKyIr%wLL0uZKt`Br_c3U5ERG=0_Z^b+N`Vt<`wn#_oJ<9gy>-qtQ}j|Z|$kWn~iHT zN2d~DjzHSDC7(M1#lb~B-hQhJimk0JmMj=5V&daNJ+%j|GlJo5!t>ptd5;FZ#{&e+ zdijZ?JA}c5k89_PS+;k@u7HBtYuYb+-aW}eelvpBHZ~h*9XlZU)>rI&lVI#BYb(6b zTLyr|;RKa7!~t}$6ky>*P{y#SX|X_--c%%dM$ni%>xvpPS%BeUa3U5n8EGN%jrT~v zt?B%nM4DwmMWMG{_1P(kSH~(fH8cz$fLI)x$a%xTVobPx4X@h}+iphenY{ozb;o|$5N3Tk=CmRmX{ zzi(-Nk||PUnLOy@o~d+k%d~|rHG#mJK`vjP(QC>afHRD6sha@3wJCG>@V@(jzGO#4 zP-6T;>j~8-h@r{*q*=i|Ep3XB^yDtrVt|afYSFN!zP`DwEnXV}5)oPNa&ZWWGoXnV zps{V0cKBhkwHA-q^BMneo};%tsJqn6mlq9ltN0$39wsKNdTeh!^f{Qa9=O-&8G zs1SQ?pw5m_UWbc0bEix>&ayQDv{(_h5a{q-Eyd?)%5yxa`hM^{u4|K7!^?L@6q zW-p5b93YOWGPV$OKXbK{q{3|Ux|3Q8m#Kf%g1fwuQrs|&?=d&XsGUiGkMi)SwYKD0 zBP73Z2djBTI(G5$bP$)2N9m}w!|!j{QH*F`4B^0QTC$`8lkB~32>GJn%&`?7O1vi@ z=w5FxA|=HV_Fie$y6VQkIflvdfL^~KDAk`of1-l(tCqteF}54{XRL^8XpfDVdynB6 z^Bs0}c5d)SKYvodI1qECJ0&Pg-6}yI=o1i)&3c&q+)MpQI0_ywd zco)k6^W#^xlxzzairxrW0c%^^C`MV<#}z}8Dw41W=a2{RQ31A`|DS$^ik3!Uj0?K~ zG*ESc0rX`T=RI_1`#u~*ZI01v;9?X%zLF)t6N;vqGV8dJuAa~R;DJJ{DY`=p#%--# zdf)E`RgB~-jz1dH)Kx4~pI1y)QnGEJ0%3#08i2xsX|h^Q{|87}ecc@-{E(e+IhD%QscAuz-JI*7F#9VrZVNZJ zR=0lPsm};1jWC0Y`o^~X7$Q@@^^kACgui|v1{n+nu7d4l&ZMYZ6BR@E-By}E6&dtsoE=#d~vCNMA-MoQR@SAPY4rv|;XR3x+bNCdo!Ah1Db zT-Drs(aOrIeyis`S}o|IiuO{iZG!1tz(G=I93(@=a1ZK>g&gN`F{*4QjEs#XzP(<5 z{4|FzLD_3+uf}bI9(^X!vQChlxb$VK-V@n@17Gbtt3jAeG3vNFE(ANfV|Vu+IAAXKL;BdI<9@Migq?tlO9&z#S4Y=;LxSPu77R+jk{X_Q1x_Q))NTz zA+Wcnl!^WGCJ+f6Lb>UZOj0*fj$+Cq)>gE{(N>85@$0V!FBjbB?xCqk%*AX{e}>SG z(7!HquwFo0wb}V>-GW(R9i;_MMWF_{^YZHVyVKNrg-4~t7JsiSEG3NL!2mA3=UXxn z^m3m{jEfqdzvQuUMj#?tg54HUT#Idzu90%U6L0WD++fM^cy>9jdJE16?r%up5F%$K zL5mgxV#C|vRQHka!c}%t9231AKN~HjXHA@X`&~Yny>50Zk0EzmXEg!wxSsmR%P7(i(r(e;3TM?lV;rE$4d zr`|1ctjZ1~30ik|U4+DQo~DiGqqO#l&aTn)$!@4MwvVmFDj(B zRGh#bQ1yG&@p|`Ye9`@v@H*-5DTpiPYlU6Z!QuL}GryswGz?`)Oia9Uc{snQu@mTh zAVy%`FUYudEee@o53*$j8xX7pB4nUD6yiNvEMU`SAp3--1<{F*RtK-dY=6VYv8E%H zy29B?(FTy^+n_xoCGuyG2d1K1k1PN>AU~<)RKxy3P{MrjFzyZP_gzD@{NBwcpJI6# zWgj)@Ex?c@6HO!t?Ogq=-=vsI%HIYi;5OYLcV^!&I4^$Z$dYU(;38ldoPGd+JooQE z0sAqi4*iv5qM3R-!irN@CShC=k)a5Xk|_L8!)7W6g%jpTE?<{5~D0~mGg7VI&Jw7v=F=0K`F&@?S3N)z7=}% z$kJdwI>2!frg~XQDG7_H@=ocxxM1^(Lcrs&A=i%POp+newkm2sLbMH)tw2{%wq+Tl ze1A{ke^P97D~km9mx2oularAB4{%)Qxv<`)e;Rd5!1n#v)1;X^eIE$B@gBi5id>GD zSIHtVB+IBk2Ul#IoWNTFJq(YeiZfQ(hUxcd%QKO4FT~)YoB$_kt2De)Ye<4!=DP1=K;V+D~2URdM@&(8Z$*&{7ZhEIR zos2cjfh%K_ZJwxeg(kYJhwY_*6SP$M!*sGGD0hE{ilAVsT@)iLN{O;^2Phv=RZDpti?qS1s>(qh6z279#%SPt#8^C zfx;LV^B7DI5;vBX!HPL80M1`+)T^>yBE+0FMDG?QZgGP3LObvL2u-(OZp9(=X}HE&{{>9x^CCS!NrafM zur5zug9Lb(^rbcg`p}}Sp}SrvK7V+_Ko}6av}jPN7D|{@)UZo&PU!Mc=rnl1TpoV5 zE}{>#UUb%D*`wAx0s=Bc!!xjz%ExRBilR?7^Pb#<$D&Ikdc95pnmf=m3}H1WTr0q= z9jq?^K+ujaumSv|eAp)J#2;FYD?j-`X`z494$L3E-?9Ea~xF^&n9VdsOx;ijH9 z*GPfV9K>_%!8pj1Zn65Ba^LA#x%h&kY>-DGT)PJgxyiD1rDJxi*TBo;7M|Djw zH)?b3>~sx?W1c5Ow6amE1_`VRG6{Jvk|lv@l6Oqa<5n^|TB;mOOWUDT79cVSFdX*l^iVQlOz~=(Ls=T|xe@rhy4brse4r1GX6EY9eyID_m^N01lgv3N6N5|-jis#CD zrvI%4;D5*jJjS{`8ZIaaX~q&t5&C__U}2g~7IF+g`;4UlR`f<58Xj(oowFI^D0_VS zR8|mcCfTYG`}Iq+vbQ#4Ub~~_5aWHQpiaVL!g^gygZ3(FJwE)A5c)u8B{Aj&8lQc` zMH6;7_15=Zo#YT=Kf0mTNr-tNd8KFvS4^GkjqRq7rJBl{ z#A8odLP>@Ff$B7n^JW55e zbz!wA`{&YPq3e6xn3Ux{RB-6B5p*f3R^VzHOH*8O`Ym}`TV>f@d z;I0Uil&fnTpF$V5Qecdqe>{tc61E? zxjRt^nJ-9*gFGsbXjNlUR_x8c$y)`H&lYr9-z?XTR4R}Kj5m5G9UQnrRby-Z0a3aB zA_Vv-YS<*=zz|@d_mqV%98)xeJ3JHykDUL!s1#-=fp8BDUj16i2HxBvF__FdfZMrB z*(6LW_6;!5`_KhB2l3||BNMMY+QDO8(F90n4$8W67vRvqsS*qaR|cs)i2fjr7lCGR zF(BE8HqdphYq3IEfi-4N_m@D&fhD-T6c@FH^%`u+{%o`oR*U^#ALWlc@rVonfMe)$ zkK&4+*j29nh@gz4M?+Q!ZXo_cA2alB6{K|7oRx*FKqr^?^l0Xibt0Q~|G@l_C{X{4 zPC*&D^=BXV3&K+%02q}-d-@hKI`RNI%~(*#+k&!k5ftngfClj3l{Q<;`e%s%?19<0 z>fYRRNZ_~7;mmqk!h5N*H)vyycPj_eVai%#{|F>Ai z4h;#linl;O#Z-k5L-fpuK9A&W)vD4T$q|NQ_f$yWUs_f`e|()fhMfY8@}$?6!YSx6 zZg8G$avlSBimY7Wk)J9~Yv+CRQF!YV5h6T;6be_1Wz>jm1qWH7wesq-Eq|IbPg6O? z!8V(!H!6M#>|PO&MG(%we6@6}ZvxFEyG9>?O{zru8kAu4hqY%24I5#g9)_KTT>g^j zAN?GbBi$ZuI^~CQC^UNuIcEopA$f>zib%4g-JZ7o@c|`s`8-?QC`Q3>HQ~$%djGr+ zEAw6t^6AUvb|}@~)R}6Us`?S84{n)FUPA9FG!SThMYdsp6sY~&1*3OiBS0((>D_}4 zC7)*4VIYzYyX*IFBl2wh>kqCXV`~&Jng*^>>*gsUoc|UOW_@1nTX6w1#VGqjE23r% zeO0s(q7}hJ&hfx^N6(G}77ZrDO`WW|*6$2y>oobKz}G`SMgS7nfMcnK236iY>ow}c z@XwUxw;HIgM9Sj7ehG&JM7AMOqCen;9mz@mn)bZvZ`IGjh=)EyjsP=R#61e4P>9nL zQd8%F3d!YiK(2xK^y^iy@K7u|8V#6C0uhOE-dJ07fB zA6Qb}sa_Q)0A%voo_0|4ue5!9&ynSWMPLis(SJbd*%LidU~{!@4ZRQm)HU?1=t`REexb~p<^#-O8@Do}VEiAhPYpLPFPvYOCiGTfw#A|uMO^>4 z-C1|ND^pFUhs$u(zzbEw3_REaR>PkGIl&s4mB|*W- zk5@A@+pK&kuXC9b3v~~@%7X8fh&(9UShChd@L4E(X|aB20W}Dj04NO5^Eog@19vc# zQyXZRjH)T0TWts+LIL5R3r%$6fIv*g8pUt1XL~Uvn467#2eno5hlL^h1HnW5vT<#1 z4z1IO2L)z0cnfZt#EZ({D)8hScrsWUt0!=MJz7zf)W%q4==`vI=l2 zp;&2ZFCitx)W@fhl2;gLJJLZX%cQyEJT=R4fvx@QNTgs<_Nyhs*d?f^X35rWgn_;!UG@5$nF1TZgD|1w}Aw-5^bZ=zN8|e%HtsOf@)yA5XOFe6;{^ZJc z@9t9?KDlkp1x?pbAoK*$n}2FN<=wZbLw{l`Lbox>uaZ0)n1h ziO&En%~KLj;uDSg5+GHeexjNNeIDJc$>@xP`#!wz;4$I~HwJY%xlcTS+pvASPL}l- z04$6*c*cpHEGhvp0AWK1G|0lyhZb`{8DIq~G6y~2ND-!r69DB3ka=pa%_xwXF&09w zF8EmhsBv3!G4qy>Z9n`>x?}dLC~k?Oy<7%+h>Af$CtE=15 z-v^RZT^$NYI#6ja1vuB;tzbJ@FAJq=ITF_cB_Q(EfU@688+2SMf|>!&u>NFs44pwW zb&N_N+XfrGiMBdGqx&KAi$C|>-w2_gKeVm@jUS?S$i1N`lafh9E@N>8^KsB#m zx^O-Wr&-0Qk8tA1dt1}or>U(Zd7q7u$J6a&n-cp>Q0>v*oj>P20d2vA8PQKhv$M-Q zj%K}?mxc3ZWTDEB305h2fF!^$LB=vMnyo7XfVHAEkT2kg4!14PK|%TpRi22f&iYLp$_ke((rQ%1WUxM7F_wI$~| zXs{#&V7XuRmvoC#w_;27lG0QA~ndLxzM?{-K-+%wUirz%Ym3LI>dQJ?ow zAzt)YukCZWiQh5B_2oNf4IVYSHGV=!GEWHfE7--JDvYZ+Pi23S{no$GR^4g#I|lJ2 zU#;|`EueRsSz>hpe~Aza`#hZ9C1(;TQ*#$*i^iq!WTwes5ccB{rqN)J$XX{O}u zh(yKAl*MC~teCK5q5{7YvRjEWr#y)!PV`nZANZ@QB+|p+DA&&15WqYgx?RwQC+*ra3lPuB_#-CZ;~E2PlygE1E; zE>GK|sU&sq3Wej;iCOPj6+Xj9YQ8!>K{5tGW?f}9X_XTPIxLys$bRxD!%>`q0)j*m zeIH$tn-oFq&!iRQrKPip92^Sj_jNi7tM{wk)tHPQ30)mm6TmNa6;Qh+c85JLs86J; z`?9QLJei#~(w!I>Mv|-XjcK*`sDkoojlm#jYqoeUA#MNFhIVwr9c_Wzg85|qu z#&Kj47-b)C;dKn(X5zo^Z-pqLVnn~tEu`-Lb!S>}*3SBGG_J=Fpi-o723CC5& zqG^465~DbUH-_4Ix@96_=E&Xe{S?i&&M)n=cy^>!q=bidO5mNaA|7V&sKyYE($&O7 zeh3O0y)G~^I{HEE4@P4#Nb!u_NW(lwyg(mP6DoPKkVpiK zkJq=NM?L;LG~f1oz!vknmg8r4Nldc~4-|{)=2urzmSb^9{N+>mm4xD{opInpVu+3FM8q9vGfGqw~jg!>Kv5V#W%pzR&XFNjn{ zmwk}FryI|8+}9omPuPIb=xWm{e||T9VwwB2L~P=wKK^*YF-Q$FSg}Lv#e&L?vnIAmaNWeclhNw+Z6hF~TRFC~}^Ti5s1v1y587M)_3<|zp_=r;LrpB&b zy=LmD>8zSrVk}W{U$1K2b<6Z0l_7;Tugl+7+FZ2Fw7Df__krrFIirq^%?Fz>oBJ$d z9CDZ0ZrRjiN}V45ar5H2D`UPIEf{wDe?Dm>8|q*ddHvo!0noICLJz<<@u{|i0r$5( zz01Q@IzRJ~Bxot-lcYc;*z$($AsfHiFIDJkRNzsiEeS?u^088O>#0iqsF8(68hag5 z87sD!8F%W`TLc4^P$@={YkhTW$n9oz__dla8!>m*{n?0z|GqGmVP-LVguv7RyJlk4 z5{cI}*Pl#7mzq!S<&q3{yduN8V82D_P|OyWoZMddD*3yja_5!1x1aD5V4y8HSh}Z&vcH=66yOq%T&wSR{B&(m!rcGn$B<~JSI4NQUQhJp!7U= zm~GMZEol54gTzz6*A{J z#$h)3e4(F|Aw0j4&OAX92isGXS9)rwF>UIg+o4(!`qm6$$m011FKl0rS zW^<-P^;XZShnIelQ;2;L9^+@jYF$V0sd3I=%uKYw`4__X*?*sWKdNJ^-iarSH{m0z z3P~hxFooiM&TqMEN99`VuWJ=j=Oks5xNxy&bYVJ%;{A^n&AA=aU`@25?<6sX%a-Df z4OM^kQ@v+FaU;VuLwb%*BcJEUr^Nca5l{|NjTn}Fp2d+ZMh1;O^W zKRJGFj=znACXwvH_^ioXV$8f3A{i1y%>El_)M@MM2ZhaCqfD}@Jf@iyOjSBj#clRv zzuh^m`{E2cljGGfs?a>S(FH{g)@dTQQ9PU0kBMY7M$m!Pxm|lcEm+o12m|OE zwf(=lUPadkx@UlJmX6Qd4M;&$T(Zo&A}J~9HejzC_9#RNk*==G^9 zYO8kA2h)QtI>I7Vy5WNQBeDPuocD$8JoyAI3|9P##_vt3aGsO=_rrY!!2W%uXc4u#=Z68JL{unV) z*QqX7FR?CKfhtlGhwTnjj_;<-`AGmmxnrwAap#0(zH{uO1+r(AW5O06wFTX!&Ct$-^}bnfQ8u(yT>T z)|-Wdjqpf?3>$UzpRT#FaY#9VRaaUfFV!y_k$Ec$qjcOVxoFp9w9Z@~DL;-pm~ zVp6r37hLxRLS|k>F+!15aaltc#9Z>-rCoTgKdnqO34PXHnDf!e8GdT`?2#2rm??*@ z3^_M)^mz`t4SxYlx+fc2DKy=RG{2XFs&9XrwPm8g$Upr@Gp4<#eRwZ-ygXkrf`*pZiyn$xN z_j+vrCC@!DYU4OILhLj?CWe^LIr?5*wIFOpbcxl*#G3B!*-z0dmz}M7D4?*Z^r7E+ z&AUR~5a=khBj{V%4T=WeZ$J3e`LohRU}yi`7_+bUjaMJxv&^wC(Ca?T{8r7SvhJlB zVw#MaTH+BOM{qLUee3IX(be7shwqeE2+T6u*}wNg z(kl`f87<{0HVs3sLo~*YKauYYGVQ5I3sY1`8=9%-qJL^l31I)qN3*== zw_^AeH63NRK<*Oz!6EoyjeJBXS6;$0Q|&sTiDC2cHe2HgSGvT*>ojjNq+_e0f?f69 zfi8W+lLFVrDfjdk405VMkjxj=v*)q;sU?Qc=?JTz8%$?wN~dBZ*uj{^F9?1ameje& z-S{CZ8r?g7 zOh6IWS6WcoHL)dfdbYbdClJ2;V{3meSuJAK?1|SR``uFUsnE8sQntv=@lZN4O+DJO z_-=!j7kD---&vR9*q;SlGntFACw&!mjQ#4>=-h=C;x9dp1otZ$x}vPRh@^r^I((iD z3YF!qGD$`L&P=)!b?EJXr8RG9sfEF1M=7TVx`!}++-A6K%5FtyE!4EQ)QPi4y4sIT zm5g{u+r?As66U$LiWnPbbO^ud@(Qs2WisQ9Mq19$=G>s5pmvq=$*#V=IG4SXHer1d z68A5pbA2fY%IFbHrF1gtmEv0q%={0y@a!mssQR=*HL+XXZm_>f3@OR}HT%}TE~Lu6 z*dfl=HO$QBBG-@Z7v}kFD9++{<1pSh*6In&Tl4l4tR$n5WMXA*5yO1-)bJ^of0OTz zux6zcr>_+_e^Uu%xVUL(ecgJ>oOk~rrIer*HYSe91^b>TRbvN-V79K84kzwoYwqMV zSlSw)C4$RAI+Bzz2+rHBHKj)nlfRi-S?_56yX-8jwGM|90hzbhNlew^3300Kq$*8n z2*!5Y_BVnyLYU-K*g~4h))QEiz=#bU*?fv`qx}VCG3?*8Xoc*h7Q|5ntE(uJ-5?|+ z6e2*z%N+XSojx3;wQwPmp>Fojpc>D^r&A_Vik%}fUT;i~+v&U!YaLPFPIpItEbt+g z4_Q!11}&RcE7|ri zJyQ(4eQD|CGAGg^?5kEFclJ~;dGQeBLCK8Uy^z>rjG51M#taL)OTPY>m@@t zgYcw50p0#}hV8=JJf?r299FGdTK3D#a}xY%E(M3B-peU@k$@*idVA@*fB`fM$M*EJw)dS@#`nzh~Tge2E z&eXlX9QiC;tKc4$QU}oD;AFzn(;EwD%(YWUsJKy!dOa3cHbTrwapM|9;Hv)Q8qO_? zt!IIX)fVj?V8UgUAah4Sy%zF1`66tRSDe(kza0sruSR6Bummr~U7-5+fym3m#d-u~ zvA&j74uL|60c+gs_m{7|M&h8c3V?=Ih$A7A3=&@zTG!2w`tM2M(OkrLe+)TK)Rv`h zJGaXDS0*o;?tHQ%OiWDN@>PPHki)^`p<*w7+G^z2$A0R)Lt0R38CW%)DTvg3(pA;5 z)zV)obmzJO5$q50G7(hA#erMS+1c6crCx&R?V2(-9k|F5B*e_JqfG;GC-7-4s(= z*st{@)m+4D|D9ksKsLH?BjIxH6YNx|kBkxfIr7Q${2+wS`wjY=wSFL&+RY-7yzt-yVT~}VkG{LUc(S`WOs--`&xGul? zB6mdBkP&vl8iSbao(7k)#=6ua+OIdRXNb@(#!T}!8-&sQ^tsU|m;3LQ-#1TRI9pLc z7O1wivpY#ZQ%j4!QpGprP?aK!Z^;?xZ^f_W(8>5otxR4~(FoBZnsaPxl!O5@>|`ay zpEhL3)D1#k385F1NIsvWmWh{T8LKRP`4%!rtjhHI+4qB-Zq=Kc;`rnkhHHQ}rNa*Z@6 zNc2HlAdPo>w^9>hC+F7G>4L90PhxX##@o!UOVlnj@Ajx4mON^?qL}u=;iN1=a6{<~ zbCt0{OFUJo-fQj#$B~`=*{L_Rlc+H?Akh1cqzyYI2!2wjlvSTv`>z!X<%WtM=$}Bm zU;iC)_NDVdOBl+Q%X8CxzNaUWs6QjDg+Pk1dmg(dt?A3B=!JLy80z``)`|o>N5L+S za*~V6$6B?XH0UvR@iZPT-R014{64Bi`a+uc7msQ*QJqEK7VGM?1jdlMHp!&g{%f`_ zyzb5Pe+SBw>yLwl-`bw5S3L@_li%)|OlXfQaA(1ePc#6y=X6SMh}E?BW|?Jd;o zv?@@b6o{rDa}DH1$_qflOmv5A6xqdadXjPlbd%>i>4K(~9uq$KjlP14NO&?q7>+&!;xC1?w>U-3X$^IT^HKA<|3V**YWgoKTom;|Ev75~|EqdHG z>06Y4ykPRzGjMmmU`*V&aV%7N^B6v3oU~S(R+se*uKAMr3!Y2FgziJx?bkI+q^rhE zKkePvTbnXRtbiKMt)&N#jdV=nYu^#^*APVDSQ#u!cFeivOM|=_@nG*MgSsKR8>w{q+Fy;$1;V zYU9qDCt=(MU8d3voPTz{;;X+tW`W#ipdtE~bj^$p_77Ky5iy23tT$^`^9 zLCW};W4Egv3OzG|QgvHKUUFYC9?r4H`6_YKkMpSU3UwOIjzxZ>jXGGWSu$+8Uq=yo zLoI<{Br{)yz)Y*FFV)I&z$`VBbu~BBSJ_S)ArOQS%(rg`Q+~brTM!ut@{&;4#+@zV z>&t$$dC%*W^W2|9voayr^ZlzopcC#5^Zw3)hH);F~W|Um(OxO-Prb> zT^)9m+FwyT^MXXfYoKWwc)EP;esPQUU zYupndrTmP4E>@Zj^AU?(r1tU`iRlNGP3-<$I{H2i4pBYU$jwb6C|8|FZl!H_9pdxp zP^|%)wImBx6T0j5>~lTI#VZmjBy%=-I%ZkUK?nA6wmHZ~wTbP5zj_xzReI zuv;}J{OdboSqef~-mewx+v)9FK3CWm2>6FUnBh|r#v?*wUYS1w>$-l+DIX_uc@uQz zC7lw#DH!03lN2;!qTMelo*spLVJS=)s!-5)41ZUx`rnTWrPT)uPn$pT-EoS3_D!dXm~cg4G3@UP%T8e^MY%k3cFCBAMdrfSDd z=Wo~~uf!wb=ZKAnG;;K_(bkzQo)iz_LIjrtyz~6o@QkPb4)fx)?tIB9xzt(GPGP{jQ{3ArbySP`qf*7T23|%}h8)y1coiO+kt-^bv*G_J{ zXB&!Pn6@FArf)NGykdn*++pH7TTiDLHSP6rp8`o{#H%15I){mIIhzeXBH~NY>wjRM z`rAqDx6uya{Cul{4L-IXJKx^4R!5U)zUm-OuGpt<_J7#EjJfu<)Ikqb%bKI>AcRR% zOn33pCmVyG0csVp))NGjrccZ*gEE2y<)Dvgaa&c$9R^wS5DKYXc}|ZT@Pp>NNf0*~ zE*^e0#^kL~*5W_|DdjgR;KU;zbZ&+|*FQnQ#GEOOqb1Q5^$@7hfzTXLk~LvP>=j;i zQ$lNZ4%hUqIY|tA9ETvZpHee_lYPXV2jiOF-fhaZkRy?b&$Tw?CzKRqBfRoNvW!h$ zB>rx>jtcAc8SWLu>sLew$BU1L5+wTV{^Oz}m@=+BKkFCkcjDKw+SAb0W>{kS*6=E9yqwr`)slNmp5 z@WIps10pN-?hMM@_xn4&>pj(*H}AiqC-Em>IeZfO$hW3f`F)#labP-XA@{#~@^T1o zY$%60bI*ppo=1vH{^d%LF#q-zOzeKZ+c4RZS- zLe1x&EtE#qUlI&4SBl~N=W@Amt`>DSOWxLSxuIjP z`_aEDBvLQwIC->IZek#e?0dv9)=n72dyTknWve(0y;`P;pi(R$Idq+oU>W`pp&+z5 zX&vv^LBVyUnU3mR`Ez6J%r?515WpdS!x$XG=OtG*bd`doPjtv1(7hq=T#O62YUloa zqg}skCWipM{TO7=ZHMHYe>RIg=AR*s>|{BAoX4jB*6Ab9KYXQ1e!go7KmCi6gPuzN zfAQg*og3jDpm65?%^ru zB24t))DdTU)s$81B4_ji1`cZ+h6WI9yEPlX7xsn{o^9urVU?xxYotXU!C$RUMr5+J z_4&N+PgmpwbPeIk#^myHcM`gm8Y=tGkt`(xL!iot{x1*p&_13+s6@)Q6(Ac3Ttcth zzB1VZgG~QkQa!g<&~Ol1BPlbSE*iePHg=W9>kIrTUO9!9c4*U!$%UZzd1T%-tCmx_-OdX#`Zp><-4EJQa$T64KIqXGg-Cl>NMKp{fojlk}Hm zQDQ7d*PSLk8xOkeHlei?R&aS?%HjywWcR$uuXe(^ZY7g!piMkrwws+NNo?EYXVc&T zu;H#d7lij~^n6d8YbRD2j?n)Dvl3gFMfGPj%O^Y?ioMsJw{}$`X#T2keNKgE($8Yg zy#K&%<`jl$I)Wk!dy|;s{C9>U7h#|LHT-Dt6d#z>cJ*d`<^46}ieJ;()22G1VL?hs z@4wq$OA%v=M*?Hjb^@tj99lLTS1eH%e!xxBzz9ae5XJywq3Qvgz zdu9w5_I4C6S(%79trSe=t}V(Pg|6NXoow*jE19XnQ9SZK6(`TKJ+H3bt!fJU&rAPW z(;l2KID;M$bjuj@NK)B~dG7wLM3J|qi|#s3e!bd_T*L44(Uwo$F1x;a@<&GOr)!NQ zo*$IpJnQoXLcz!f1Oq&psEftF3{;e9Wj5wS$dgU5TBknnbosbI^Im0X9?rgSF^}yt zeSP1P9pdG`&`ur^gQzpc&lvYR99gRosB-&T?tS?~IY1swCW zH|p5i^mJ<+q}GOW9uD^`g?Z%6jFgA2&gs;7_Xvin3iv{SRGLRxZ((?i{q#kB@14Q$ z!Zg1%{Jigehhz&c4iRG`an?meHT`F+SC5?XWmEZ&PVgtqlsvygGHHvs4S&|{uh=3h z&P+8Rz}r3C-|XUq>omt6p=(d$^nDHbCpc$olZnt}39ByS?DU6zTw0?#R8{^Qe{kAez<$7{ryCNXs zzIFiZOr>kJ6Ws@{p5N7-p_n^MriWY5EZ?^dK|avtv*c8VUm8}(s7+NCcQV#6Z>!~e zg|sv6?0BJm19>arZymZF4$jv=Cq1gZdo63Co>@R~uzc_#vK!^ww~>S@`jnEFW3{lM zeBh7{m4rVxleKNe-2ToR-%B%}IfaCjjr(zQ_~_!%#LqRyM=)t}Y-%3md%BgH))YN) z%%**Ee5x$UAJp>qTgvxl_KkXTnbl`x39^!m9mgd|#~hr2Xg)h1&Q| zUQ^DsvXe&UszV=vwl$YDkq78K6~lSeBVKQYHq;^iR0-<+B9ChDOY8j(1udORN&Q0R z$LyNA2lJn!Yq6ZUZxD{Yf^)4s$DZlwo?_mbuGqAdvbNqPc3QIZ`|lsH(^r3iJcZZ~ z-<(WUnoJ5Ek@Meq07msQLobg9w9PTxl9sU`KLH&vdq$sCu-_P0&pg4DW-2ph_Pu#3 zX|e`(GBI3|>_MkAb|$)erwN9Gw&`SKS}D^UdJ_W=EQ;i*h~CqSu%SMp`ZC+F0DbBU zG0*kBdKMKG)i=ZN!lpH0;HV;7I?&P`bcb!eGvlomjr(F}NzkQXH>~7yv{H3mW$1f$ zdg12Ai)(af{S#c7{S`^)+OmeBPXJ*ksnPvUsFSXyt(`dh_Oq#`aF-+>TibAG`V3j~ zUh_1*Gr4hI)m~Fmqf1ltf4WLou~$5l?L$yKAFxw?E3ZFgr9u%H#@TfWcZ`1c+Z(t@ z`E!Sf3XZ(W^%iaz^f&Gtzy3eNn)#Bshx(o?6?Z!6(1-z*F4O$S@oaPLS&YOvln^J3 zp1SgDnUm(J4#_#<$o^g*aKUXc?M%kt0QHPi=KQB_@D^<}oi2yWpIzz;?Zq7qe4l~= P|Hw)yN`8K1@cMrNbJu`v literal 0 HcmV?d00001 diff --git a/examples/multimedia/videographicsitem/doc/src/videographicsitem.qdoc b/examples/multimedia/videographicsitem/doc/src/videographicsitem.qdoc new file mode 100644 index 0000000..92eedcf --- /dev/null +++ b/examples/multimedia/videographicsitem/doc/src/videographicsitem.qdoc @@ -0,0 +1,21 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example videographicsitem + \title Video Graphics Item Example + \ingroup multimedia_examples + \examplecategory {Multimedia} + \brief Streaming video on a graphics scene. + \meta {tag} {widgets} + + \e{Video Graphics Item} demonstrates how to implement a QGraphicsItem that + displays video on a graphics scene using QVideoSink. + + \image video-videographicsitem.png + {Video interface with control panel} + + \sa {Video Widget Example} + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/videographicsitem/main.cpp b/examples/multimedia/videographicsitem/main.cpp new file mode 100644 index 0000000..725243e --- /dev/null +++ b/examples/multimedia/videographicsitem/main.cpp @@ -0,0 +1,37 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videoplayer.h" + +#include +#include +#include +#include +#include + +int main(int argc, char **argv) +{ + QApplication app(argc, argv); + + QCoreApplication::setApplicationName("Player Example"); + QCoreApplication::setOrganizationName("QtProject"); + QCoreApplication::setApplicationVersion(QT_VERSION_STR); + QCommandLineParser parser; + parser.setApplicationDescription("Qt MultiMedia Player QGraphicsView Example"); + parser.addHelpOption(); + parser.addVersionOption(); + parser.addPositionalArgument("url", "The URL to open."); + parser.process(app); + + VideoPlayer player; + + if (!parser.positionalArguments().isEmpty() && player.isPlayerAvailable()) { + const QUrl url = QUrl::fromUserInput(parser.positionalArguments().constFirst(), + QDir::currentPath(), QUrl::AssumeLocalFile); + player.load(url); + } + + player.show(); + + return app.exec(); +} diff --git a/examples/multimedia/videographicsitem/videographicsitem.pro b/examples/multimedia/videographicsitem/videographicsitem.pro new file mode 100644 index 0000000..83843ce --- /dev/null +++ b/examples/multimedia/videographicsitem/videographicsitem.pro @@ -0,0 +1,15 @@ +TEMPLATE = app +TARGET = videographicsitem + +QT += multimedia multimediawidgets +CONFIG += add_ios_ffmpeg_libraries + +HEADERS += videoplayer.h + +SOURCES += main.cpp \ + videoplayer.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/videographicsitem +INSTALLS += target + +QT+=widgets diff --git a/examples/multimedia/videographicsitem/videoplayer.cpp b/examples/multimedia/videographicsitem/videoplayer.cpp new file mode 100644 index 0000000..744a354 --- /dev/null +++ b/examples/multimedia/videographicsitem/videoplayer.cpp @@ -0,0 +1,148 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videoplayer.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +VideoPlayer::VideoPlayer(QWidget *parent) : QWidget(parent) +{ + m_mediaPlayer = new QMediaPlayer(this); + const QSize screenGeometry = screen()->availableSize(); + m_videoItem = new QGraphicsVideoItem; + m_videoItem->setSize(QSizeF(screenGeometry.width() / 3, screenGeometry.height() / 2)); + + QGraphicsScene *scene = new QGraphicsScene(this); + QGraphicsView *graphicsView = new QGraphicsView(scene); + + scene->addItem(m_videoItem); + + QSlider *rotateSlider = new QSlider(Qt::Horizontal); + rotateSlider->setToolTip(tr("Rotate Video")); + rotateSlider->setRange(-180, 180); + rotateSlider->setValue(0); + + connect(rotateSlider, &QAbstractSlider::valueChanged, this, &VideoPlayer::rotateVideo); + + QAbstractButton *openButton = new QPushButton(tr("Open...")); + connect(openButton, &QAbstractButton::clicked, this, &VideoPlayer::openFile); + + m_playButton = new QPushButton; + m_playButton->setEnabled(false); + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + + connect(m_playButton, &QAbstractButton::clicked, this, &VideoPlayer::play); + + m_positionSlider = new QSlider(Qt::Horizontal); + m_positionSlider->setRange(0, 0); + + connect(m_positionSlider, &QAbstractSlider::sliderMoved, this, &VideoPlayer::setPosition); + + QBoxLayout *controlLayout = new QHBoxLayout; + controlLayout->setContentsMargins(0, 0, 0, 0); + controlLayout->addWidget(openButton); + controlLayout->addWidget(m_playButton); + controlLayout->addWidget(m_positionSlider); + + QBoxLayout *layout = new QVBoxLayout(this); + layout->addWidget(graphicsView); + layout->addWidget(rotateSlider); + layout->addLayout(controlLayout); + + m_mediaPlayer->setVideoOutput(m_videoItem); + connect(m_mediaPlayer, &QMediaPlayer::playbackStateChanged, this, + &VideoPlayer::mediaStateChanged); + connect(m_mediaPlayer, &QMediaPlayer::positionChanged, this, &VideoPlayer::positionChanged); + connect(m_mediaPlayer, &QMediaPlayer::durationChanged, this, &VideoPlayer::durationChanged); +} + +VideoPlayer::~VideoPlayer() { } + +QSize VideoPlayer::sizeHint() const +{ + return (m_videoItem->size() * qreal(3) / qreal(2)).toSize(); +} + +bool VideoPlayer::isPlayerAvailable() const +{ + return m_mediaPlayer->isAvailable(); +} + +void VideoPlayer::openFile() +{ + QFileDialog fileDialog(this); + fileDialog.setAcceptMode(QFileDialog::AcceptOpen); + fileDialog.setWindowTitle(tr("Open Movie")); + fileDialog.setDirectory(QStandardPaths::standardLocations(QStandardPaths::MoviesLocation) + .value(0, QDir::homePath())); + if (fileDialog.exec() == QDialog::Accepted) + load(fileDialog.selectedUrls().constFirst()); +} + +void VideoPlayer::load(const QUrl &url) +{ + m_mediaPlayer->setSource(url); + m_playButton->setEnabled(true); +} + +void VideoPlayer::play() +{ + switch (m_mediaPlayer->playbackState()) { + case QMediaPlayer::PlayingState: + m_mediaPlayer->pause(); + break; + default: + m_mediaPlayer->play(); + break; + } +} + +void VideoPlayer::mediaStateChanged(QMediaPlayer::PlaybackState state) +{ + switch (state) { + case QMediaPlayer::PlayingState: + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPause)); + break; + default: + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + break; + } +} + +void VideoPlayer::positionChanged(qint64 position) +{ + m_positionSlider->setValue(position); +} + +void VideoPlayer::durationChanged(qint64 duration) +{ + m_positionSlider->setRange(0, duration); +} + +void VideoPlayer::setPosition(int position) +{ + m_mediaPlayer->setPosition(position); +} + +void VideoPlayer::rotateVideo(int angle) +{ + // rotate around the center of video element + qreal x = m_videoItem->boundingRect().width() / 2.0; + qreal y = m_videoItem->boundingRect().height() / 2.0; + m_videoItem->setTransform(QTransform().translate(x, y).rotate(angle).translate(-x, -y)); +} + +#include "moc_videoplayer.cpp" diff --git a/examples/multimedia/videographicsitem/videoplayer.h b/examples/multimedia/videographicsitem/videoplayer.h new file mode 100644 index 0000000..5cd4d74 --- /dev/null +++ b/examples/multimedia/videographicsitem/videoplayer.h @@ -0,0 +1,47 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef VIDEOPLAYER_H +#define VIDEOPLAYER_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QAbstractButton; +class QSlider; +class QGraphicsVideoItem; +QT_END_NAMESPACE + +class VideoPlayer : public QWidget +{ + Q_OBJECT + +public: + VideoPlayer(QWidget *parent = nullptr); + ~VideoPlayer(); + + void load(const QUrl &url); + bool isPlayerAvailable() const; + + QSize sizeHint() const override; + +public slots: + void openFile(); + void play(); + +private slots: + void mediaStateChanged(QMediaPlayer::PlaybackState state); + void positionChanged(qint64 position); + void durationChanged(qint64 duration); + void setPosition(int position); + void rotateVideo(int angle); + +private: + QMediaPlayer *m_mediaPlayer = nullptr; + QGraphicsVideoItem *m_videoItem = nullptr; + QAbstractButton *m_playButton = nullptr; + QSlider *m_positionSlider = nullptr; +}; + +#endif diff --git a/examples/multimedia/videowidget/CMakeLists.txt b/examples/multimedia/videowidget/CMakeLists.txt new file mode 100644 index 0000000..0bb6196 --- /dev/null +++ b/examples/multimedia/videowidget/CMakeLists.txt @@ -0,0 +1,41 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(videowidget LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/videowidget") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia MultimediaWidgets Widgets) + +qt_add_executable(videowidget + main.cpp + videoplayer.cpp videoplayer.h +) + +set_target_properties(videowidget PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +qt_add_ios_ffmpeg_libraries(videowidget) + +target_link_libraries(videowidget PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::MultimediaWidgets + Qt::Widgets +) + +install(TARGETS videowidget + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/videowidget/doc/images/video-videowidget.png b/examples/multimedia/videowidget/doc/images/video-videowidget.png new file mode 100644 index 0000000000000000000000000000000000000000..a3c7bcb4423c2c68cfe420817186cf15f36a8630 GIT binary patch literal 54199 zcmd?Q2XDkm6P}K!D&bPukyo zzwbZre0%aC*OkLLd+#%QX3d&4n`jj!+1D5(7zhXmujM{UsUaXBp7{=K`Tp+UT@NB+yRjPUD{Xs7JfI9iTa?`NsDyvNyFZvHf1b929&*aq1!cziPY z?uhaCuBh?F%@x2aS%?m>fHCl5wf~R0H!M;D!Y^nD{tY50?5O>37QLVKMXqEk4NgRU zSdmMNC8aiexpb>*gNFrPZ&TgJ?VRLvR!6Me)lxpyPpVaU@F}bknbD*P5O(CkpC4!m zPcKSzKFmhVKZlmqbfr$^fqRUP@+!~$pJWZ4$tA}Hw%Ylc=P6V6_XybXA!A$Uv3-~gn*?+i?x>r-a~iw(T$zPBoHB~A3( zeB9QN@joj$Ut4QySAirdaQ8aESY;MaJ#)B(m`|$o?=3}K1Ai^AoplkJ-BdoGqIUUs3-Dd>|)hdy-46F@yguFv#_Vz z^w#=)10v1Q@9D3ro7*@~Wa8oylIxjx9xf{$*L^1&w6)AzJ_tVDgaRm^b;FZa=M|dI0q1KQ_A%pR z8APxTUr=0v@L1SRA0RI~51R25Snc>&a@Z&Aq~%!SUsJN4Mq_s-U_bO=p9PEi zN7Vrmu;kY-ggIp>yPr0EZ^wIlLyYcv#AQ_|`or{iNA+yJBE9|Sx<{}Mm6`o=&93fu z!bwrQYFMg);XQ7b50(|XMZR9`iR^G%9Yhsx&#X(y9~AxGL$kHqhP;+NXP^z-%~N=1gVDMVLq6S3P18e1NsA1+82eQy$pSz8dZF0kwC*22!- ztO#5QVT(5-iw59;W?~NF9fvY0g?|NyMvnTjW|g5xtOWi>Ok%X7BbA*rAtuj%{^{Cr zXWSsrHHW!FB{oP9(clVox5)SN30}N?8E{F?`SOqF^LD`6!vW-cqi1=Xv>S@zp%nJ3 zwt3P-=STiupY;CH%@Y0@qyBZx8UyQyUs1&;rcw`fcsLTpN!%sw$qpW zheV?{cLl5CiQOJ?Zd**SyJX1e&hs4ugM!_om_~jR_VdN1mg_pKE93990bAtr=a=Fg znFW65LN<08^XpRpi)XRBCoP1N{_C|~qsKMnq$;sc#kqpZ`?)HTl3YZu*t2dgCxe6* zVtJdVKb(|XJ$~kt5&+3If)tCo>uma(o{H#kkv~6NeG0adK41yMzYh(Vuzjp~V1RxqvYp;)DW043$)3g(dY zvA1ffn^^*^%{NDhbF1h15;Ec|9W&=U{K{!@kn<_FLzt)M7iT9-S%m}fXIq?}Q+vv~ z-!S1K>-F=lEWdoHhu7M3O=j{%`@>4De-zmN6!&Q-u^U+6H_pFu zjcsJ+(>Yc%6{gks73C+ZA)mC<5tZkfz-VT-N6=;ZVgTg>@%@+k>iIKPad+&I>PFk-u)EitV8rXH^%lcj@2xyV#~$jw zGJ!S7!&VXNir=cxy#AEAV|l+kBjn!5lU7-*D{4BT6uZ{Bf7Z+^bK`7HxJS!nggTN8 z{xzKO;tR)fNumjvN6ZzPimMk4A&SCNo^`{3XI?P|+2PiK_8Us(Gn{T2i@D`YApxN8V_vpt_6TRd+wwWI-lOO z6gF+5u6dEJKQHM;^(E<6|8h@7uk|x|QS_$g21>cDVD!Wi_%wx5>$RxZdD`K)Sq*z| zcv|h~PRtA#W~yyBBP_V>qwPG~S?{e$rVu>N-&THJE|nA91y^9#wx5@5m|^?vR02-Y zhrMU)45jj`PAis6Cl7u<-XClY0;6`)-LDQs2S#f48+*?VCpd$T%;IL*z`qy{ zg@I?wls>?M+j^L>MRot)$M6@CnYWRVSVbWuuk3PIJ?CPfqrTw%N4&q#5#9Mt+!cUY zFkWg4)>AMWj{jujInQiFsx^E9$~#$t+zAJ^L%rchs3>-c3L{zTK26Y4sZiwd?_cFB zaiXh<%b&eXM9n{7YhUmQ;eHls82uc_ulwCbK85aZGM3EFD8A-MtfTUv0ZZ(z-05VF z(hFVO4|b#>j~jTm4(kuIC_Gy@RXQ*g+ZmFHEfbNjI28Fx^wi>w@w2x3THJM=kbSGVV8HI^=+S2cH3F4owCzI4yQz z(wB9@?igYa1mH@k5!h{&aT&#euQ603Uil=wQwS)>8k0(w+g#!^DL*}gg{%D{gPxuS z3XQzu%-_!0#{lMdVV<|FEw?tgZuI{UvvC zpm{QIFXXIz>6`-%$UfXI|i$zvuayr@x?RX%74miub7WV%Ld@u3&?fAMNd+{zSlN zsn|7@liwvdS&r~n{v-Hn|Cr9@1|@|Ta?tg|%JNOHFKkom`4SqrKF52h{1W#_sqcuh zHD9o6*8`|nMn|MQUADd{ZnG|=lQu)AocSVqtVajr@7^u?B`pCfMW;F zKkMC(;hjgmwHvn`taNgyR`@X+53audKlZYt4zip$T?Ngw2zG)Co|-@fH#c=%=Wg!; z&yGz$QvQh`qdcr484;!*|)Bq3hA65dOvwnO1lpkz9Xygq@?U?ky0>5y=9uuGA z18=vSwrAHbB`N&2_f2}P#2QAFA9B}steywEI$`g`6?1m|_A7m(6)djEj?dJ4&P)RC z9BQ}MpU?Dk3|Ie%KR^=CL<3J$H}5!(pYH(Tw?!xA;I%|G#Dd3Zv4F$K4c@?KdV(0P znu5=i6gLNAPvG@i*QeR#?noow>%_Cgd&-wJwBsqfSGBomx7Feg0P)8;*ybbb7Sj1} zzaD#3ZE8CMzVlaSkV==CWH4WUKv5=NQVx(=7E!mY*EL&O>a@V zL5)`qbX&}SIX0>uuYcfGtQ7}4*2!+*<9(X#)+V(N>5AVw!Ic0) zX9u9@+JgYa!?HNiA707_Z^L_VK;F>B>(b8r>faNB>xZGsYqI5jcQFF-AV^z9Kpbk~ zaS7k$CO*ZCLLgYd(+MYndd-(YM7vZ^{E{q8-SBIRn^yj}hR(#suJ>);?CGaa^l>w{ zjH_h#ObMG$+CwFz=Bsbg1X=+S%pbJ#=%QrnY+~KEh$s^0s8t(x!&4ec$ zFD%eDQHqDskyZ27?o523k?0Dq`^M-vVAFa9^lXW0j{2b!BH*RSR)OA*r+LAX1^j#K z>R;y{oZ2Dw400@M|sM}k`4+u4VmVM@z&dr6yZjKYK8Iz6&* zfDIGMUcbSZnP2tp^QU~;nJ?H~9A3Q)75`v1{2C6R2*v@=FUpn_y34QRo19B(d>7H- zMHg@0^BrLqP|YE(9BQbfPfEL}z1uB*M~`6mP(o>S&@QUnoS zilCyPu81pia}HFgDN5@Nd!xTb3uW8VM_DWC$Ai-%oOx#f+6pD(nb#^gb-(G@62FCJ zQB~l49PhK^n+0%DMwb#9DClYgym=sPF&DK63V@z~&D zwQ68m+ z)}Vl%m(TelQ$z}tTB1D0GeZT!$6DuWHK0%+KGx?F`FvMDoMm(+HH#k7>a*nfug*U7 z66%iWfE9E?wh#bU<+IEf`3Q;_6@jd>HheGTlR-Drj`1agr)6?v|KIR&pAxwz~(>`ec>&4 z2Z4?(mFRa`ic+5hUdTWZ%`Ss%7ja0WjR`2g)3%A4q8rcm9i>7-9T@WP=a8NAs471G z`5WGTsbrokb)}osyn!@U9*_|QgWl=4w&U`x4$9@|YX8lVJ-CPY1Rz{?aTE%;(THuDW{m==q|0XJJgf>X9g02>bQvbHDX5bA zPVQtD%!V620ZhsxJf+FqU=D#6PhR4w-gh>b5I=_EJqBW5%O!xjbzQGrM2qm6UZ>|E z00%*9MZn|}&Mexd2t!rSuYWoTD0b$hE&lvkfKn~_fC;3d%hkR8e4f#>;NoU(U}F&o zuO&%bV;Dbm0STB26qW6?oT+*$ths~ssthlx`!#X~(su=bavzLOI0klX>g88Os$7Ji zKUo2To7BaoZrXieZ{pHM{|Yjo%DU#<;%wP6W&L~LvNgNd2kqr}?z>KS$=tm4V1)%3 zEFLF9qy6ep?@RO7j(R*ztW)wcx+~AXe<5=r^*SZMX^bSMA!E`?YHj_vc4#GlV%{~O(zSX)oe7gU=b_um2+-r{-v zCp0-w|IeELpS{#OcpL=Z0OzZfjOE9NXiC4;v$`c8Unn#jXIYNtZ>=4MW2*OYNFBa~ zJF+{2TI-o*Vg_IMZdPVi1=dCIAkrY zg#B)~=chD+$RJ099SGFj@&EIpn|Xcrn?!6pYC>eh!VYW>?H=iiwD*gFf4Jx7 zAm#A`ae}r%jP(vb*g9GX;St7+4uES?`kHCSsJZgrnq-*6OGkn%bz}thUF@HT?yruv zMv{xt#w|QPDHk!lxMkMrdqv$G`RlLoou`-rn_0(EUqvDqAs5I8&tqY0&&g>>?!L8Y z(gnC~Ghd0F3xP7)ZevKZfeYx`JefGi^o_9=0i`&E!RG%>+lXWq69^HL{T3C)y)=2` z!9B#q%ln~nmL|arKBGF8?S*|Jog5lk#JOa;8Y8)6)GOJ4&e9xDVoBU$E`pjK*{n%G z@>>I@MdlJTXUxBi0o0Yk{pKCU-}4jS_4@RrADj1cN4(efiJLuw_+)2ek{!)c%@-2^ zxzdpWsJT3toCD$X|J*Gzoh_7(9chx~Ga%nvbU640s&0oqnB_lBxY4KYf5c$|gPjm1SF#hZGhPMDR z*&Av-Q#8#~Kc&E&IUbjwh>Pm}^N$0u^vEtSw#kFY4J%?v&LceFFo?xThygxuNpVnD*m2-Kr)b2pyDp z;3dPqS6MC_al`8G=v@Kz>Vr(gzCXK<>rz_z5FyD|aX|_;ru-?*0vsvuYq`2ACBMp7 z)z+$28unVdqMA(@ysx%aMP=giMwzo1WVjH6iF*L3+(B}4>QS%Y`VJg-^)(3)N!hq~ zU86$5fDd*>gCiqoGomHYTUj2Zip6RcetvNkHAq+xG7}mU6EDTDI&kbKDqJh-Nk>r7A@f!BjkQ?kBXaj^_OI zUo;e+t@W0~Z>LW)Rezb=JOgq?O%4dT;IYvgY>pe<@kkJH3GmAoO;Mr!P1Q=n)6h%n zV|%sOSn8`d%v>ue=TDB`=Ap^O#KGuFaEl&vkE?Xx5GEl1g}CN;^^1n+L97#Dib&JC z5?Pzrsjt>sankh>G<^-fT)GEneZ?lW62+AmebVe|IwM96^3}>?!7qH|VjBhJmttFY zB09>sP{J0z$4n4(VKsKJUigr!5Er}Tsg+CNAPYf8&Vf{DXd#KTu*ytDIY?H$$DZO^1&{AT0#lyYxZe zBY7Q%uJV{J$G{Y_qSP|Jv_z8Uh+6&HnG8RI`sWvmjwX+e?$_`f{+~A=ZSk*(x)h%n zZcRy}xFw-~Ca(fJv#D7SXd6d=0Nh>33VEGSmAJ%}SC&K#6M)!F4Bq3goLC6VxsD7k z_|J0q31F3!scfI)Kz!Uf$d`^RbV=<#DH_QV<)pSl^y_itcD*p1P5w&{&8~ABtGkNJ zujSuR$^~;vi4@9aN@LY~u8Sp5ypzl+(WrPcG&E!_Kw@1z`UBIByvs0iZU{x5+2e3Q zqD^CHV~?S33Z!jhWaaOlM<<6K5@g#XkCPAdJzc{VOed5C2L4ME_3<%(rmyY3`#MAr z<6vvIhlOodajhE~gMSSR`D`Dm?T8&dKneZE7(+L>@~eMyCmnc z1sC-xEj9Naq*(cPeV8_20K2&DWmyYw2M=fAhbri(&<%t${v`!b4yEqg12xQ7QP=N} z+1tP)qYEFk;MT%H#U`gyRQGsSI||C{h&o{1_EyR$8Bj$QD_lOBUK*KPnzZI)MzsLs zH#PBRWQsJ3lIzbQepQXN;UgJv2I!B9Er^X~rADrW<3KY1d0&30>EQKg4pdJo=(-`2 zgQXiQB^HB##3BI|h>+pVlb&=Vy>uj?O#VQppfG-O#w{~6rokYxcYxQX`z_V8H?!=s zowcB%oqNJ}gJMk*i%#cv)H97KX*+{&q1C20D||<&wtoUXc3cGJU=UH5*qh zmN21bbA1UoLU}{(^>CRD$olUE2VG-m?r~q>;?C*)VCyI9|9~wf)v|2j<`$PH>Z!)8 z^>L=L2h}RZGoL96?bG`dIxh(Pt$srXS#FAp=>?V?Tp4*esCzp2Nu{mw|17g$iDmB)vGtmbr&Z@#^{kH7@^DJ`C# z9#_sbN#tv}dDe>5?7q>)Pq2d^WjJZr!9i|apMGf4j5!+fwMTHRk4`P7t&Ne5T}AbO zM+1ER#Eelsm@4Ii4D7o>ScbKj3xzLG{9}7UwP|WVoFVToH6tFnvVoyq@sd-;<32w? z4`+r6zd+NrP1bxQVc!bXs_~=;*MMujX`0qfXh>XhNtVo{q@;9m;;p}P_!Q+*!uaA< z<;_A6mcc$Us!})+*8YH^HgAb!1ec9y^V40JWG`K&?UA}m81r^!@(`j`XFQ$n>O|2F3Z z+jsZf7GS*CsH4=SELgWex?RBEG)-B5563EqebOzNrN|N0xsIQ6Py>q7QWg`E?qg(P z-G*S6!@Hq}2eJkQcw;S3CDm}{AP?rKY< z6i(w(8)z{+AQIrq#C=Y@u_+mR8AMeA9OSP8oTY@4_N@Pi4A4{eO>e1Mg%R)S#;CSZ zhOoyW(f!-2`o>17;c8XpOkzq(Gkbd=li{#%?8Fa~TX`X|XBV#5Gi`+ezAZB^nKUa= zsmHFgN}Vv+;^&5W^CL_>g5cKDC-`rZP^GE%P@t|4(b-A>>lc_;`|c729t_353u$V9GQVgdYvYI5nTBpgIc8~4ljUFD0BmE|)a+s)zb zSWr9w7Er<_Tn)vFoC8~KYN6`WH2M@@dAcVK>ed2*y)D|OAf!e$spJxU7FCYntjQo$ zr(WMkHMI}YQAZ5_=65ySODr}U^;62%JK+vSEaneJQvBu94C=id&dSaEg^pzZ>GtEXn&QsOE_!&n{SEA>;MNWx!uGy#eZTbwD{e>Z_j_9E{ zuseF5&?K%Hw0@jP=|9YiO4J-A|2fdR+Q|M{=1Dm%Re9BzjOeISwvE%Oy2R2%u?aI@ zvHt04yvwOD15wXuAQ5xKpaPZyrlB72Tst?J4qYz8*!9)ew=_w+RU;rDlO1u2RfdPc z)(?#2Y$_gnA_H0c&ClpC$uw*(8T^Q5rsQ&fF=F_&u>7dGGBpRvf77R~2;&u`SP?Tt z6=k_RZ+(}J3{QV)nIP6T)h6t-N>MbyFw=pFkB^_#I$~b&9-rt#0_`}@G=N@F{YR(v zL`@?-*RXhD!x!q?4$QK`tdFk%&hzZkVBMYPkUuc00j&Rhjs$$?`CUXKQPVPevx1CiJp6zI{$L~~2j9lVQ!9V;mc4^c78y*k?Ts{$LV;arOjxdvKd4SSas2AxL`ybj)-ZCmi zO!+i<9BJGorWld4Kg>wlzlk|D(3}zfDKVSCtoOK;S*CR&-xYHQk1->$Cb(P=<>uz~ z!Yn3kZiI@=KHE0ws`jk<$`|9Q;v}2OO@{%-M;b8gTsyCkCAeYg`DX z7_P~m-V6z5VB$zuZ+jYGTuxm!!y8yl&|8>*hV-Jnrz=I?8J;~vAYa;O!E8&j%-Ia} z#Nhx2WtXZZWHD*d7ea9nR8eSdm_nVNUbPWg#q{t3xHR3Hlg}5; z+oC<$DY3y3ia@}qM2%G>^BRh(dqlkaY40?@pdn)7pBBJ2H|n>1g`W^F$u z820}DO^|LIHiwZL`FLm==*S>VUnns*wJV&bl&K`j*=$ykUN&zR_KhCQt`i7?1Zk2K zzwyqPfnJu8uC6nbk65x4qs8?KhtEZDVMbQ2B37~T&%2^zwh2t#!+qZAEzkML!C$byjla;mk z%~+-(Kd`}sutcaw$gCeYbEU-n9VRex9;f7#uGAu(lTkho<&zmIpFc2fmY#+tnIXn= zm-J*>eVU%wcjxndtIC;(yU#L|=`8k>HMRjA!NfR9A%aVdtTwqEQSq3(qUYu#TK(f+ zc`eF`cggxw;ET(~GQa4FcXPr(7@jn4@z*fPDU-aNbc+Ob*v4Km?XOyL8acep{jAYZ zIT=PY)nsYyyPS10MJ^tB>|ZUJ>%^dAUh3w_G{{*aEs-YhDMY_e zCPJYDVYaBA!98C%&yg_7MnHDTa3gQ{u8?k*3ThL_e1#ETXu>6e_K|)ZuC4tmRP;eg znTX_Zx=s^*6{ZPRCAvaK+$FLf!%99xQm~F1CXnYsvKMP7_Zyw>(3<2vRA=*wxc}q@&h+nk1#Jw zF>iRQ&_C}RpPZ`>YQ~}!HL_2tc`c1|(5q9|#=7egkv}3O71Tdd(!aSx<9ihtnw?F& zw2yh|6CX{kcyK8)E5ief%-$hhd-L23DokfUL+bR@&J1<^N(FWWaw7GxDK1(&C6%D- zGJ71aAimGHc*M&=ED3z=?O5M7C_Mg$r=e;jCj-cNb>E2lZkaTI6Xxmuiga4C0vWby(L#fTH`9YAuj1MJf&5dA$ld&QdX-mF3CLiRWqHx)I5Kram z8_NU${2a)=jXSon>$n4FH&PIl5_2Z+=8t}4;x%}a+ndA-qDs+u#l+**^P3)lWjHly z2VEy;+SXlL&tb}5>7;WNOp7HeH$woUegCcTh*R=lvwjfjk0K_6n^O9@ofNS?pJ7_d zj0@QWK`FI_8KGD$+NBLZrZ%sO{lX2MFT9oSU#`vkHW93W8$=OUg~k_aZ=PTL_<1Ep zC?>iL5iug}cAH2U>=#PgAgk>}iDcZk_+7X1TN-;rRS`|u`2FGs=^!t)&PI~e^cauaZV|7Vw0(l8l%O>> zaaIttDK09QVM^d&MlQxa?cp!sO6u$X1L~dc;*sik8Vc{&4-!-VAS#rOc*r;)F|piz z4WOUwDI>3z4lZx%j2Inm{KW?N<&wu4tvAYb5h z5UC|b*Y!dG!*pHwu5V98Qp4L^h<5IbjVF9%b*-&Z1TvqLl>UmmGS`rZx3BzGxL)l? z#s&b{BUa!L; zQkn^N(j24q=iDc7Wch14l6qSCZwbQU*PxcsF8T?PZJi+*-@N`v?9?lynyy`xniY5a zHCx?E3NsR>Hyf@mA3v2da=yji$AqW@mAQk5ED%Yn!>UMCSrS#EODDS%JW;Ip$J#bZ zPMygVhSZ}Jfd8lk@qu#j!0i)@!<{Qp7o*Bx;E_R3@5&}G**ll8!SoM}%j7(2IYmXE zl;gR$xs@C`(SG}klGtS6MqFss5+1P@pRQfn<%`D6Nk^!+nKUDu#ym<}3r^&Z*d-w{iwOTo+tAqNuE_tg3alj*D~MsewlIk>us~m$4KJ zp%DI2@hW}4BmJjJ#EUEj>xM!*{)&2OPHq{oM(fSx8dpE1y1q%Rb50|e14(;Ks z)5a5PHdnX(x=o6Wy-i$-^?MslEiGoPH?y|!x=j*oYTwjsaR%Sxn8r)unrTF-aWC1W zVb^6Nm7aJFfje=};tmx26;a9H|{MN4@m~`@sKEL#n zKXu0c)7j?}K21>!5Mk2nVeN_$cnihboJ{qwH7CtjlaxyPr1HAPWI#WD)NT@5=pS@i zVRXtwm$0>ga*gMP;k=*nm)mo2GcfIb@u3>0QY0UvlMX62r5Z@CQ;J<|dhyrOi|6Ly zAn-NK)Xx-XTV1AO$T3^4!4f9%y7~?1jjzkWSEBr@cC;XeHSC~!#53cM{?NM1uO985 z#1eroy=&*qoK1q$XFqpp>ATNSooNfc~xygGg;@dz(y-!p!lQ2^G>awDJJxdcc8u`IMYO7yKyk9C9!X)*FT&{fayO zYv8K8!i?P#soj!pACz&|Moz5a`yFO~Rg{@_Oa}t*V;ut<=ZifWxs*CP$gIBiV0xIu z?SMdJ_9|Igzpvg!Byw?VZGNXV`wn1iXn`)YQRbu6FSOw5uRuw?7lvkO44Bk0G>c4z zQR89%z$98uT{*`I2ZcIaND6mjzb>Q3+5V9Vu80DJ&j(GP%v$A()k<`-OVrBM$oC1B zF{B3tKFFXF74`D0FyaUCR`n2LYGG?uV-sY9w&RGjHxw?w;U6p!XSo)3(o7T)!R*la-be1${=hm*s**x1<{^4al* zx#KNAH7tG?;gKYemiGCv{&kMT?|uFo#xu|*;cJ^txHKnd0L~a+X^i@4^BFnsFZf?5PY|Uk}e-#zR#R9!5u=?*C8R^{LA7qvry#lrV5i&>|v>lf9c-vxSiq2}H(j0iR zX6&yq{vTp}dHF)^OZ%3IU}OTZqbWE}W|HcRX!3vF%msU5Sj7Akf(O~Imm`*CI8G)7 zT=;24ZhKmb8p<-6vr3wB2EDVh$e75r7KPM>+7kj#5MMu1f38;6{>;|x?Wj(5@D8(7 zzTznW_~Rpq@53gUFwMt~CyC?EZ8;KbmkD^Wd}M$|BuYHu^T= zd&0sQqS$1JsfTTsDoPL&mnOh$*X0k7wv*pa;2+J+GDDbfI@{VT)23gdHeRm5TbM$R z#xBPBbVJ1UM9hJ7#=VAQo3t2r*Q+}Tvk+h2M}@&g1FZ?@xo5vX>D*3TQ>=tpD_Pmt zIo_s6lSr4ix|pWGdt@1J&iP{t$|Z2xErOGO>>;GJY|m}#BL%5S8`)D#K`k5g@&WNo zsI*eOXgPRtOVZ1Q-%HU6oXOOyH6z7Kz4NgHowlvCq7+i$F`*wKfc*yRtujLYkD$YcEF0znx>?5ZHHRHQ=NocG%g+QbyH8)}o#k+(W3X7`| zwpZiIbyJS1w-h@r*)r}xp@e9b9IlwCF>)lcFKfwGi(E+nF_ZHfVgc|tTYg~#Hg?4$ zka-LJPZe#8G?i83khgNjjHQipGMsw$aT%MNhb1Q`Z-A{bEUb^Fmi}}>wWyZVV*Q~< z?C0;gt{)#oC2SPQhNM){Zlf1(xX{q=>3JgkkDsUL#Cs(5+u`WH$pde4XzT04X+2zO zi9|fu#RPwKyfnV?v#ZOtAcl9IkF3`2D0c_v_)gKmnI_}BL^X!%x($y5D&xqkOa%GD zYzaVq9yV6CAFZt;!HbN-E*EH|tNjDcpIlees%O!*ICL4qaI=1zgb)?K{(65D$#`Yv zI^kIxq=uV@#X|G?a`;9S$g+$+NK?2X0%YgeiB{b6XlLVK|Iyee-;(PxF+0yKCLq_Q zFAGJpm4wMRoM)0GUFik z=gg+d7ms9JYCSqm_+e?GJ7I93_LiB)bqj-nX&Jc?V`#LI_jcaRrO=BUVHE`4bemF` zO-k5JT>RCO(#Jm5W;HAXz6zOqOV8SL^bA;ds=Eu#HeYVkPBt?3t$&48HO$UA;u*}>S659h*EZRBH|v4J~JeWA$HsS3d+Ld#v}1H@v6g;1K@;73<61BsHA7!TSe75Ty|>tRFxL z9F=m72nnlVwQq*CGuC`%^H8{mQ!&f(#WZOjNGpd2WIZq%f6H&>a_29qh!Fhryy%-s zA)9i6dCtviv`&FxYoZ@>PV}rEh`j>BCT;de*&k2?C#+Yeb zzY6gL7)UTgeQ&^AmmmTz@3-9dm@}0#ji-!{zrw;U;LQaKF9iM)g?0AN4P^;MC(}rh zuD0iujH>c9+gRH%zUA+Q1-PV^bItLo$04wCkyNOuaP%Ie@hws*+@qPsWuTeT?3kvV zvC&3rk%McXl*rapCtT<~pOJ!5qtq~%>D>)ldOkJ4p^rvDK)~z%sO7d_{Ncmyxwjs8 zpEU8Hy`;u&?1#C4YpO-#T=h6SmL3BNrmP3P2z_V5i0G$&44`DD_YUAa;9_eE6b7!T z2bnn52#JbA_BLs;3MkJW4$KZJHcwNBYXo=1jlWK@%M_YA@uLiRfBTBey z4~d=+hB>*GxN^a*t*w6!4}m|bn0#J#baWgZ9wuG8Tzm62<@O$j7oVnv`<b1FYC$c^<=o=aF7J##rO7#s4oZZ}{ z$cD{zhK#w4`AF(JI>x;Kj+x3mv1lE-t_#z19|fG%udRs+dTjg%+t%SHQ)9M&^{VIS+>|JlF~v!Xf)I#rebQ)rqo4tEE20%-{0^8}|ZGrdhtiiJ)` z+A*bG2L1R>%8twE}1I+%G zM5Ca1q3ftah4nzOajw-)WQd**-%Xz&iKf?7`yl4l4^&zZ*tfAkZPl>u?B|EMk1i@I zis`9;F&>n5A24!tp3{l{cY zDu=MLmuM|%RXJO@0xmQ&NNAW!bn?r5b1N0x>BosS5lB^#c#IEpZ`5Rt&%fq^?LoD`F6Ch z+~5rra^V3jtD^9zw!Wr)&vj4IZ(*M)+LROx84Zi@1DzOvyUR+50clj-)Af6*lRC6M zUL3ElUW`-EF4v~DYzF7igz1J}9tJYc=l+r^@}uy0dU-fBgp!+^dw6`@tZ-^&Wd-oR zOS1z1?FkYk4gGeK$t$v+e9km%1M-aOM zbQQaQ;1v_Sbpmm6)J?7Mds=YlP(}MHHNKM2$v7rsw$6M1{IbtBjO!zD+p#-TU!q%v zdq-cXE5(#5{kyK_r&4t#WhG%Tu@W|g=9U)W1yAxr5PetlN&7ps^OD7hrFo|lxU%2) zY--LeGXo>6-hz>PiceI|v*O?hVjET+Gvc5D>_bj4k=Ne)4R?UIE~XUTvkDmrXwJmS zthXJDt_unZmb1)nyLfmEEiURnL+*M4@AgaMhRv?7uNT+W9IvzK&>I%*rI`TMRh{>E zx*ImHHP%kk6swY%RFkE-B??=2iDhGH#r*DE^Tqtf8tT*wq9;jn5s*vREj6{ex%ivjM~DFbe(BdsWn<1AZ` zOe<5?!d;(fG9mlb!qty#=T1F*)Cs03LK37C_F`Ly7jZMG_#B*^(HaBRcCoUki3=+( zMjuONnB|9#E~+wx<4R_lj!%#-N&rO)IvH$lUB7~N=QOt*<+)VS-zgMk~A}; z&cVTPb6FcW0mr}l`+Inf6Y8BM-oK^F6zjkb_@f#BeULc3=?gPZ7i3_`fRaR{r2S(% z{PsPZV8FEws@2&6^<%F76@gI7g{WJSFWWWJY%wg|+T2fMY{XwIn=+BRfoWi2-EK0zmKjNxa zU)((+71ECVK>Cc!yu)z!@r78&^g^aZ^K-soF23&&Nk**2vbKkF0OFqmZ%T0!010jJ z_X_{!GTXe6!cHfZW23r8zU?akq~_|3(PvX}GYvuU_R>pLqh zqNHoq@A_)F%$mQMOeBcHMsPk-eZY8ebo;r|(a!U#{)muL$PL4B00dE?960nnypJI%mL zA=DO@H#?GQ=Kh=3VdXqkQMlVo)X_yiHqx(Yw&PMr!9R0l|I#JWPc0m-d6{jJhW0*M z4fjOPLOleq%#DtzPipOKgT2N-kB>QIWn~|ZJ$tqu9)SC9W3rU~1M3eH>nfjT<%u3$ z+VmG?3D-@IoSqr#=ZxchvHlNJZy6R<_r?nw2#Bbpbhngrr?iB0NGRPM(uyECbhmU4 z-6co}I3NrR3@{+w@KDll7XHt<-uIgy^m5PMYu)#+*1f3GCbE0htRy}#;XZ!Q9pb5( zo6YxmOLhTtGTlo7VXb3@{MysM(<}=?;xw#Y@>>SZZ5^}EXCg`8N(NQ&~7u@PC zp`!V&jCP&+g18dw-sqSZ(8CC1yFnXa!aqlQR7hYGPaERyU44S*Tkd%z_bGkKnGV9g zTa#p=s4vGM&88Z*O#F^CI2KbT1AiMIzm*U6S@I8z7IRec&(js{H;}4?a-;{>)afMb zp;6V;F`cl#-gSTf*LSw_GfQ=&;>*Z7D}W0RyaG?Xu2z^N7N6hzc|MIq+MqNR2v$SB zXq0t~JV80t%1vPXmJ>7^;Vd4`2$#Wx^uIlNz>e)4Ep>!EzlDw7#^mrcQMLIX#xmJ5 z^5R=Erp=P?5pSo&X3g3`+%=;sM%$xED=qaaC)+n|z4&5>LRy=QcFRYK2@bQ#)qcx; zc~nZT^fHQX<3etFpr#zz4lpy=QZ22mw4<(n|Nfmup$ZrFtNhTvckCCraEG`LZ^G*M z2Bu0^>tEQhroe4<-9&5BS8Jt97?c#o*zAt-Ji z50)NL`5)tkhK64K7b>w5bF&d+m~9dNDhEKKSo*=Oh~%#wu}>?J$76+ z@W$m`loCTte&RJ(tepyh zthJdQ+lz@-%U8tBt9}j&1yp@3VTrU6`Ks^zak9V$0Kr_aDxNI6Nmn-P9=6~F8COjq z0{;4l1)R1mxP1Kh)13Po)Gpuxo-@9GI(XzKYkgq=*IkVXFk*g8uWD`kBniEIZoGLl z6Z28#TeI_(v)d)2+XGJJt%bwAw*8u#@-$VGPw7Ds&Ed(X(dI$#%J+>u9i8;I4NOW8 z>@!ta_nWU7(>KM^A;e0CaT37t$%pE;GA@aLc0>)P2%agEG- zZ)FtcZ{yg7?jpP}kKeXBy1%4n^iM8;osc$Xx|=+2GpRBu`C_^Hr5#J+g+D zln5E$2z1@-R(%Y(dE*)Iw%X&Kf#1)*of-Dap=pZz9Lbd|l?8}nZ4t*2bWj>*PTN}s zM;Z^2H60;#ZyvRaj%s3s6T+C4cs;b+R!<_`?qH;Zh!x=Agds-5n}%+@l`SpCsoKT(q!<(ailti-t9V;8@k5k0qLPC>s7Z6;hth@So3U)e zaWGz%&%GDx*Nt_hpga@NUPS_MWkS5~exXMu;aaz_uSxI-7!igXLSkYTEry4PcTNXZ zfq$*84ybOq057?^{ak{9yu!u+Li1ZE+ooH>VXZWlf;-_q8=fY0NvesNKYu zhq_qYv)oZpwGx0IF}Br}+I3)(qpxE}#ZsH|17>(zQ#4 zk|ThVm4lW^Fwr_+p?=bFO6N1X;=80DWE`DmBJJe}WOskb)39# z>bmCl_4PH^Zyc{bRC)5`saB6hIUY;yQf7KO&*gn9IM2<|m)itp$n-Q}>Pn`fchE1T zTEXrxQX?V-WLjaTE6bjX$YN4LsQt2Q#NM??N|m#4H=m%QN5Zy2G6NA2$Jx!6t8@V# zzkmReazB3kky5{c{+A?cGnQe}R}NpsUIuWhui6TUa4GGb8M6qhv-w5~YWEen=a~|)z z5)UW+8fA_EM;|KxD=ovKLA!&zF;o(3RJR9IfLRB0sdX(dDaQYG(bjHg$wsYjdujwu zPBB_%HjOwcDMd#|H{VGOkwjO=#S#|P_aplr7@3T*V#U`FxVE$tN_N%mPknSUMyB0F zWU4NlEgSXk-Bfs-B)H%;J$-MrzMh$tt#0?4yzlA{hQxa_w}*Cy1FZz{^e%3*c1HQe z2Unaw4B&`QSRdjv-dD&*tl|Cc2dj*Ql_)2Po=Zs^4JYC_)p=w7~nsC zcUXy1FhKt_60_2&Reb!(!pZu9=~(322_roX+K)vX7KXqR-N3%8z-zmk^PJnX>udj; ztI^v`CbjJP%T}k%bzR5-SM#a?-5g^cDUS8Cv<=Pd?AxHg^OV5F!0Wn)6=FYnd9WG2 zM$Po=;YEeLt;Il9`?mS8BuPe$oY?IZ%kXs{R)}}%uX&Db24#p~2GYLO_?Bq9WqW;8 zn(^N)`*TT|6dp$gsn@<4#m2D+Vw1v4 zuoB9+4w}0yioeIuk2sy`1ceGi<(~+(3bh~MOh=xpVEx|f+>eknsQPkzdhk?6KluP` z+i!`cHG2P<+@6>yGvdz&Tsj-Fb`;;9m%H;%Ats3ncFc=Jld5lF6kleCn-aDtT1=s)w8oy02-_H z*nZYVWo1z`Ha57W@_vii~e3K;&bD- z!Kr7(Hqxi=XH(2y{(!x!aQCGjEMUp1|Mz#+3BG@N{^!f{vz*&=s%(kC`89u^`zuy% zRRjF~N$qNO--_hksr2H#%48E?3>3e4&QYX>6#rS;B3*(;mtKpWL4(7Ls<<@Zq@1!P z4cRy7ifJH)`DV5G+6q9$3=Bb%jM*B?{ZNNFK? z&`0s9g7F1$2H|gAFZmz|SMi$Um}r!2|5}Sv2y?_t>&Wo%8zAJQjjsD0kI92@M!tN^ z&)NzHgR-(MonW}G6y|5G_*7!Z;>t?!j~}ng>P?-TVtA`cJ+8MX{GSlpeQ#c)V##Yn z4huz$D7J&$y0H#WlBlr1cCed^YFPDA~yG0nsFh`8dFfagHBHO~;`zuxMWW-`48Z}^{;dd+)t&`AC zGae@h?55w_CkEe+k8*A^yKc6-fQox@Ev`<`;5Of;nb1i9sUZp{CHNjyei2l6WW@%e z@EJkfuL`5FQ$>QUw%itCpp4-lW-+!AsC z+`dEH-2Bd|#HYe*B0r}gEv-0sG%B%vyc5N%Lh>y1`;U?E#GXkv zPdkzAR!ja27Z;Z?tg}`q2~d@MuEGvJDkob&9UBqW`TMX%-pVt>j)2uxUvBYht$dG) z25Yld2AaA_<=-5(1oIUddhnu6ggJ!e0T%S$ zu51Fr{ld-PCh*|3Y+$}yJbep~>DCiE+X_Bw=;x^I3lgfpzd4!Nfjt1;zKUYmX2s@d zieghW$EMTDlH=Z8K-R5lt}u0gppFhPPcN^*y38_MKk+%#s{6c{_s^N4`b8b_V#kXa54u0RW~`{^Gmtj?i4%e1`${Hbw1E@R&M0QCkt zXL<8>9`^UjKRWZO?5x_mP)kI=7-|Q&=2?QoIlef^34=cLKjFNo3MN3};U;r^^QWI= zd+ig{tiJnwNy(kUw6hb{XDT)Cu1l6bySMFOyx!hf#!6wRT8wk}m$8ps{wf=9t5%FjLvcbt(5}RDrM1(BxPK^W zWoH-J1+ayz(%@*|jhpz{pNCK=^ixJNRTuAe(_YIV?V75L3c(XJO~$p@qjEKUoq^uX zpbFjmJiOiqG<-@ViCQW=k-enrk_P!Wz07g678CX^b%m0_1Xwh4*JxbQXE3AvJu({E zCH_r;CJFms`tF(jYkNjgMZ5}^ys^-qqw8+q&7JMk0nekII@%0~jz}c(gPGYEwqYG5 zf9APDvHZ%Q89|#~0$%xj zZ{t`CF|C!0^!BkC&%H~R>^0c+6~==Fs~!zs>i@ph?AiKA&8!IrPz;ZCG3{+>?63KW zdmo~iVN(TOae)>D&$&qy9o3yfov^67@T{#_?4?@YfF8*>HHFEtL3AxgtY4sUs#HEj zvVPv$^n}JSd3N?=Q9trsh9XCZt0VIWAw)Ru==eBsdD#qFRaJxFCdLNr_yaF#T#-$N z|7MJdoquR#>&)bhw*EqBPM7f{p@n|DKq)$?OCI?zHO%!9QEDAFC82v(y=Y@VQ|ta$ z(c+%Jbh(YQ-AkT3Z`1eD{Y}|RdyX|$N*i4)w^QmmZW7H6uB!6eSZ+W&72`o z#)^zpaBO;?X*Y0NawIM@L7lEgU|&4!U*?*fodti$V|LYy+GQX~55?!rxB?P=1YNX7q5)xc zlQ&PNAs}Dc|9a?ifVfTq@03^2L%{zzA9(A(Bxo5Jm{aoj<8eZYav zAhEj;>09n>QpYx>TT?Fk=hC@l#V{j)hNv}uzHa!%Fb z@}N#zsvWZ=Ok2tSkUH7_{T>JdP?f>{$+_OKy4uq1TJq|;qyR!#O-=XvSN9BYI-D2} zTXIo8qqBnFG~Hm6D`A^Esm5dZx|kKInv z@)PU~0(^x^v~L|v;~tsWMsXP$gTZZmTmu6GU>%P0TKKlZZo0*n4^jmqNh5>gC$O>3U>3GLRt4ak5&z~920&@y2uBv72wET>{7PU_i`8%iY#+E>p#3|%jwed% zZ)UJCdFUhYbvzOHgqq2P+j-FmMYFAGu$xa?=Kkz$cM;j{EPGitBg_1lMQ0>oQ--{9%|p2O$U-Qqs_y>A+LO=xUxB^mC;srgAbC9f zpvrYw;)=d%)fAng`5BA=(=YUKv=u1J&S%p(dnLbs0UHx|Wu~gCde+Ao0A70T)HWCS zvspdH1?yw(0r>msiC-``%ae6$Z(AO-FWm68hTH@Ym=0}w4)DhjO)FW`c$7TT`T9v@j{P89Xz!=W;?{4k(9?#8YAuY0Deu39U+#X{@U4Bk%y;!F1;1y7;Y z_J4%3-OmHhUd!d<-q`|z5)$i6OL-ktL>Y?lI0FZ7L@u9>e16CFf|(%$xtiVz-E+{} zqBR+7cvh8NaWoFSEDFc8w&QIW17gpezdHixl8l{-Isx!p_?!5R&`bFyRIm;y}X z+Dc{R+S1j`RIKWD|7y3*RJv$J6u3&AYU|hPvE5UEPgr;jWsKY?$b#b` z*zK8$Q&`<%YuLkdXQ-()+?6L1Fxqz9q=@?C`LqNwx4g5p9F^HzXJ%Iqtx59j>U9kr z9>nwKDp1hmhvnd#IGEbKWzM5_c`93)>rYn5Bb=4rdL#5KK=J>#V{q~+Wus`PKAA>+ zTi8!n7gCIOc6aZMB;uSY$^!_xCYBR_UXE<2R+{WJ@Sk7W=6yB9@T@$^I_hs5_*-Un z`?ATGNP|U|poO@w)}61^s@MvU9|6<)4Ny&_)Cn9ClDMF83U;V9BTqZd!uVeGD+73v zvD_>&V1Ui*mNW#%;ghH&=cppQKB4R7>~RpiqJe{>%7*oGw9az00Uq#)1h3pFsJ`xp zL?p(Gjt(AW%EwT;`1lNgHln6ZAnJ2mLTHVc;m`D=pqp!a#WcNvMZ!d^pJ!LCL9_YI z1NF6SA=wJu=9>||an+dp<}cr!ae!=A{XF+g4aJMXGC#iKNHH`ty!+9cNEQRT#>T&( z=b4$AWdKcG3(h;S;x@w{JI~sD0(Gy``O!j}Vm?Ev*5>1TqzCCUJz%*XU)!P!(F#&9 z*DAF1G1lb7cRdLX;AX_lz}(%E$Y*ARnI0M|#m}|t&Q$P2K-buRwrJu3NNw`W! zp%b|hJQ1i~&z?Pd)&C#TD(B#M6aLqwb8N$cnIUb|3X>+xjOk-kg91$~%zDttjlMKC z&qFw6n4!41STykFuFC--M?*1N)Vt@S?=NRT`qA2?v9c;2?3p?AT_}f8MYiIdWzbChL_JePyx*D`@dJNfEcj3urMzq@XoFS z?dPND+K=ZFE5Pd!_5B+K-ao(tmuHu~ks1+$=2(*CeXtuo^~_w-(345`L&3#8^3gU% zGSqsoXN+1IqC-qfZ1oP<1L{=Ewn_BR^VE|B8)Q$!y(wu5U7o(yF{?zs-!F(!n=!f> z0Cke9^rV2PzP&1=YhC-uZ(Pg;TcK0uYvQjOHD``{@6qkoXwDTGmX}Gp!0<+n8J>?I zEyRoOo&0=p%7%mKcY22!!J2998Rcy7oq_{#?M{(7JdCfa;}O65?{zJknJDGM_K609 zrT&BCXPFHzXdb=PQ1LHan>8dTD~l*EXKiW^@ELM#DOlLA>*^W>PRW<bg2O)~K#} z@(6AeZ3sbLI8}Vrn0p<+$40dNHg!6OCvwvu(0`x~Y6oTFpubr;4hD+byc@+e#w7+v z8*j2+d1+aph`9mpUX&nvT{I6gC?Zc`iE)FpR1ir@PUdFSd>^A`J1L^XU*K~;H&SkKJ(A4 z#%yIAB;7Q(ziv;T+-$5`=2 zc|?KfNA*7j@iA_~fpk;#_?%mq1}y~4 z0$G@0T0Gu^!rh)OF5QEJ;ZMQ^(ife7f`tQc=W#?7^I!Z>Y;=JT1qDci!=;xU>$(!u z3AT*079I6#s$0ysj8rC^K*g$ErJ4~PKA7 z=Zzu|IwA{m)&jS4fzSM+EmNxU#m5^}E$ciO$vjLVZ;_F%`A?6|vCY_A$P-pcUPhE; zge$rbB%Hbuky4faZPCdVxRd%9^#2EwpP4E1^wf4TG`&eP|FQu4K@iAO zpAJgk0o@gtqa(LZjpzNG59Q-B80#k{r<@akn&F7yyX-!H(Sj;)6Az)+5Pfhw-=a@yyMZQN&YtlrFLli!7)GTJ#* zr8;|lG{3t;Cw2C!fU)x@3S^S%%|*?E{p3 z3=9l%3W@`u<>g#$$V-?4WBWmsk)!fq}*Ak?C&uqaky|^YHgfg-0_3X@=c31cv8(^l=d% z{pyC5?E$MTPLYvgmC_r1(k*W3X-fTCl{g3dNZcZR=C8*`G}rT~^o-5Gm^)4U=T&{_ zRioPSJi6>6Gt=Wp0eE}uNXRDrPJTH>d6kw$fb7u0!2neP{o^m)p9G_UudlaVgpcA= zIy!~$L)Tomvz!Aw?@|R|wJ6Xar{_SPF7)7UD%V4@*5JYyd2y0%rFS8S&v?Z0Y(`K`YV@MUrDk`UZ!&L9bK$7OGB#6g2V$s0}m z)N9^zf@9>{Jkp*$amWzbaST6W46WOa$HIwoT zua@b*G5f5Dy&Z4KTKE>@41}NucdS)ZQs;=)=|Okbn>j-AfbzOl+zb$POlFAe3p)3k zAF)@1CxTSN9Zx3L)F!k^Kdj5Sj@sU~0}>5zi|_Ti>;!F$rP>bq#@q@V+sky|6qJR= zzj?1(z&4Hb0WVnbt!2VbM_evRqN%!ln#wWX+;5#{xNWoaA`t@w~r~#UO>3` zYSW@tj)X@?N8gPJ0eNI$Vg1ja_ZFs_x)qJ9==I_0)F9^g8V=!@JCRd}dhe0Ipp#7f z28ZEi+U!h)+83<{i$_A==x*4xaP(yj<>?t2)0rl$(0!3+-|x>Jj80ce&{k67vj0_B zLC;^LllyT$O~P{7R?CFzI|~3082=jDr#U9>u5EZ^`|_Hba5s!CN10KXF@bPQ|ISAQ zb1xL*fvVeLsG+TWIUN~!=Qh+J8WY@JZnvT$dpyG16c{(rG8#@>15nFt+kf{Q=2wqX zluA7>G%D>ZkMvoEfl;WT1eCkwgJ#$^+i-kqTHb{Jh~vnr|6aj)M9%Yt$$$m#SdI8q za07=WoCKa`7q)eJiH&~!*YHg#2&AK5-&f50Em`@P0*JwI43Z7}?!#jq9#5a;JYAeaIi-vZP^kLuuf6x+OPZ8$>S znw^>(^Mg~SxJjE0_f!W*x4ygagh$(C+tF0VS-baBpg~3N_=&Fqqz8n2upECkfP_Fb z2>pUSte<=zdcI*%fB#S=VN~hHGNEbHmhZauQpGK{Eyt5D+w=M;|2vo4zNb=c7`nqqqqiC~y8;30+li@P4JCt4_`7eTv! zPSD$c0c0G(^9JsfaYHRx8hitXuBcOug7}}7lzvSt3U;u`NkZ^WK-iPZq&fNu?5*zZ z`#@I}j4t(njIAZ%$5-%iWDN>_woV_;a6VJzD%2y)u6pf7>FbpPj?nP`D$*>{49iO$ zLxe3lV-hB6E52mt$QyY7yEsMO8s0qI%%UzG{HRIt&!xh@=)}815yZF}n*rMkU=w&E zMTfcLd&B$a6~mUBVQXx|wGf?`!+2)cplE|36lD=WEd;L{K(_5>`(%1jyg_j{_7b}= z+Hf4M_@d;)q$Gu^eZ-^(gzM{|`8Y?-sAXNF(9n7;2xLsP+>YP#f@g9H_zxNs$2yS@ zmf?nphr+$eFW2aE;4GQQ%}1qrjhClFxkYpu?})V4wdAVXXZ~C$^|=0Wwo8C5756r( z>A%RuKlD@R5}+N%qrJ~uVz>W2g7IOJ>WvL39^yE_yu~@w`R^n#V9@B!)K0VjGL4mZ z4qdRdta-A9LzcN$!P>tBc|DM`gV=^QPA@?_H|Jgigas(`x*{(#s}q&-XhSNqmPrM~Nm!Jh-`d$K!0+VA*1C#Jz~y#!q#nx~|y#U?i?LwrO@+JmdBcYG44 zb*51t1j%db>VC}6Qv$o!j{WGIJl8?VhowiTcefy~s0c2SRpcQ`Rt%qVg|53p*FQ## z8*%dL*iqXuQm_zxF*kL0;Hs0L=lTknr+TIAg?o~^>Z+K%SKa0I-P-OsixHEb&7(N( zUZv&{pM2cKDK+Z7|V3so?eW8>*z0lp%i} z)$DcF;jNnkl&D%)@7|ZyHkjf+hXFh|2(WXYIHjm(!aktyQO; zZx)V^JPOF?R{fM{Uj1(UiPGQks01U{=oN{deT8x~RNzWigL(xZXSlOPt;HmH&V%q? zEF`b<9ml8p7eL2ZDBVp-{M;ziNBo*V7G!<4UAFJPc1CHs&d1W!Bw6*ojbTf?tDcb@C5brC?cX=BJyX%Ye0X|589Wz{MG47ks zhkc;=-Z+T{TMlu7DK^?3s+tvOS<{UnXm`J7UE1`5&C;m8y{?+rB=}v!;44fB>(#HCO3zgn%Z4x6$CHA7lg>&br{0w z{?tZGc-!~wApGXEuKDP*cA8r zxq#NTQt>ljcxwnoZ%()Psn(k8&S*Gqkeq|!~gsJKRX3OU;RBv33%KNsCreE zKHD6&D<}8$;chE@^HH&rFfgGDRRjZC#8oswzXfSKa!N{#DL$Ktfwv#R74yUuCyJq# z#OxWZqrDa%=k=F2IVwBG{56#5%g^(rvD|m_5}rMO4j7x~@~hC-Acal>k%Oj{3~n7m z#Jz;F9O&Y@VoXe(4zt->akB&(vWqg7Ta1?nA!M7BU6g4BGwG^@v?T+Hb&nIkcq{gd zL8{s$$VNB~LXTd^yRq+M{eW|7{!_L$5S$l;vUAYzr$IcRp5C1|!8x1RRK2%_rC^2) z@E5QxK%%a!tdZoWJcD-%Pek6kJh%j6io)|qVk&1rO>ky<`raR)09kRTRkySt(ethJ z<&rI6;#raj8ZC~;y1b3=%(9kQ3fm;!*W0vhR{{O~pHdvu3PsM$m;xns%vz>u%B~kx z_Pc#}^>}o0zL+pOE0xYnYHm-itI7^F#c?OJh-Ckt663cE!j35jf7r60xRbnz57ES^;l5|pW#Jk0 z?Fmc<$TOFn&rO(08;bs^qw9C6n=HN_&D@_qk7&F*yZg?g%Fr@c3)+Ww4FmnrX$;9@ z<5gHbjagTwajyNca!aA|@&1exR9VS>cS-<>q#3SF!h0Opi7*<0G8?t1u?l8{%WA27 z^jik^q5WOEKy2C{iK3Q0SZ&Ka1Lrprl}xwAhtD&&kH{S~&^JdxiF;3XgWH2e@6Z30 zYzN{+{0wEDSBUsT6Y)q|>AO{^r<$=dkZJaL{)Hf_vK)`Xyx7ajY#$YP316SRG1=e9 zC<9~k$+(29_%mt@IdpAhO%S7`aW^Z*E^8QKU<7yzHfDpQB6>YeBMn^UOQjOj#u)Qb7rC zRaKqmq{N%nYfL!HuH_pjhrY6R<&Z3Ff9C6?T;hV2GR%K;VRy%vBL$=nir_Zy+|t&C zytAvqMjVTZpC_DhSZQlpSI%at?t6NQTup^96Psl|MDCw%o?hO|%*m-s-t%8bL$4&?bSx4c2O^{%J#>0-p-zb;J#W?mpYmmK| z@#c0B8FK(pz}MEQ(TeR>*v8K3r31eDX><4E!aX#)N+VPOQ4tC^gLB(s+n(pOy(l1;r8Z2xh2Z?z- z#FD?rzKL3KcbIc`54O8}17YWsXBK%0*X0P2( zTQ;FioFL+qs*iykRoqmtxJ$fuPc>vW*a*> zkEGH@HA_!t>`(IWMk~T;&X5J|!6fEt;r4rpwiUpB0Nf%Uh-&JOY8n9WFP{EG%Wv!D zl>dc7;w@I^kRXbt3NT1lGkvtFT>gC^RN6Z_Hom!(ge`THz(ODI;hkjmocLKN!C*3e?s-@q zv%<1CE-oI)i(!xlPhkW{BB=ihiPLE8!L?5L*IQ;h-Y?e738V!Z;=F*s%95)k6Hj#m+`xO_h&qwV;RX1LH&oHLv@B#}B;_T|)P zj*#J&33TPcv{A$L3nY@T&L*5bZ-MHLH6W}bc~w9fx@=sfxKo6mhF#jAVvNHLK2QfCE3mUKdy?|Xxdp({pR1_>}AJpUl9f z?p>tP?_2uZzp!u>Hj!<@{{94MTosCNj4HGymoj@Q#Fasoq4M*JBr>F6fiv@+EjBZf z4JqPM(g02mGA29*#6X!z^BzCHz?~D}+paRk`a6BCC1dJ?g{JYJAIq?PlEj#r(bTovZQSwgQ zK7m_)d$+~6Xp^3<4-b>cpEGOd-6DPWPT9z8m_`E=ee8~FT%S<@#7g#s2^-!2&^?7$ zC0u)KB)3VAcXf-NKA!Vr9u1Hnfq(Ts(XqJowk0E_WuEX^Iqqu{oqCVc)s%_PI>bH# zuE5p@;&{3$4H{U_cCEepL&%-}S02U0-b@n`x&kk@hADkdn?rDJC48L_*SFcl zr~03|pY0K_#1XKE$J_V45vtm~7{GvP^+B~(sjbfMoim@K3!O5Bu_g&v47|w{a5a5X zYp(u8HX>IBj~apWy`?%9g=Eu6YH+hW=)KlddHO1KZ*!9*8rqV5+383=0A_N5u%%7< zlHdy^8&?g{HtSCsN@M#c?;W4LvD1jCNiEZuB^gje%2)_b7Z(+!W@T8|+LqZ{2dO)h z=xmI+x+hx}c*o(Uzg)K8Yt2d6Tca;xtdD4Pr_pH8W-DY>NiOVF)c6Haix8d>}k;!yKTe01;_UvzE#URsF3Jq$3yx}3=%M?F@yelgtN$kiGf3R zQN|^`=6NKrOxpux_SdVv$TtnnT^6*+woWfvHDgkgZbRMSRr<%t7D*5pOB*r8UzkHE zgST}nWYIy0a@6)(z*@}>`J(-nJgm0aCP*nh*w{%jeQm|s-iRp=qVfgAj2Dka_r^9W zAf!diwy(meL+OVfFH>Gi$rQs^FB%B9Ai_NGCv3ksf2U^;c-XFZ%f&NV(5YoJt!^j8 zsZYpT%4S(*Cs?)R@nkuBHz4xmzNy1w8{f95q!(Ibmn0FP{_5K%FtF%rpmm2nluc(W zP+U}=5oX?UM42A`Ha$v`b`}N$F}Ki+pA2})v*f=`t&z1)9I15WZ%;e#oSo$0%MPLz z6{Zz^wD`%?u7maj3naaML}8_L;^Y>#4;Wp$jMU+p=VmQ>`ZPb) zu}QudzqX@8w$hlj^?SxsQdoZpBQFySf81PGFe6=s2M_KiRXz0fiZGV(T=q!S@5qedXz9v6Yg9r!)QMzlG4k zbt{}3JLmLGdMg+5z_u3oW=Qmr)EQpbe*|cY;%vh`jk~qa+*~iz+E9!tnnBdLI_2tB zQvC|t6Z!DNSW|G0h)R?}enbMkd*21H{9rJo} z#p~XMv--OR0&deVOl3M@mD9_dcV8};2fDT?w`!H|MObXJVaUg1j?wqkP*_@8PCo;& zK5&amqDFq~nG{QNsDCv@XiJL_DFpq*0DsCup2NKHaxPKdpo;(bt})(H?dP9wEBASy zS@Ek2e{+LZ6B3>jeaSQCheX=Eji8Nj3$XlLTFOFt!e9W0^JYX&poA&e*?9k2mj+xF zh^0+QE+Y+_yf35BeSB0?^%_kKcs>u_svB3Ka88b+IU60hg0m&RxDSk z6E;DOS?%!(D}QtdJ$uOo62=>CB^p7eBt>|V(65q7klX0+LEl)v@lNZn$c=?iOYUyvPCDen9L~Irp4mM9N=|yJIq#z%}=_BaI*?xFX zYz0K7rKQz2YS)Nd;71I~=x4{RE_<}J(Q)zAkLx8HIi{4VUl+Lu^QgoZ(7PxHzIy*^ zBWA>eM)XK@;EiPsMX20cD)z#h0zSBDSwN;i@TD}Y&)og%2L%Gz)y{I4w`vh( zPkc>;CDYX@__8foUQog=us_4i%NHzCj|cHp3h2g}`)CGE{MW!(?zAkLYPZ^Y6J@zk z*SC+Ef9rf5ay_)y>m{>+PiDu)CFCo(z5O9A$yh@f0$Zn7jN46Pr1>yG7i|{LM*et{ zeBtCj)Qir2c&$mkP8HWGQTM(k#A53NUA#`uTEjM9zV68~_ZQJeS;Bf)h9WFW1&0NA z*3WItf6Oz9LzeaDIZ!)6)P629AF+Dw_qxaFW;iRSG?y0ho`Pd9H7BywY?0KM&0hPI zAa4MU7Stixk{$iKL@Dt#wIFZPD;9W1`&=>)TS7n3Spho(e|4S)cSUGMr+F z$jh@)5;2?APlgn-ySf@01{pjh7K*b$Z!JlaIqwV3LGYd!P>`k2D-Lp#vAuWiOd5%N ztXle7Svh?zzheC3isuXf)YUw$pUol#!xfj*buTtDrya-6_q=6wFO=;fkS#(6Cl)~l zlI)iT>Q?3JHA!E7@M6iTsw!*n^2B}PCacrA_Cf!DS%AYTLS{1iC-pClc|sscJhfUX z1+-yDpjs@;gVjkc8I`+p;xi#9{Zsi5xc;f4qQZG+nhX7l6io!U+ z%K2kk7DN@o_aoWGyFb1=+`f|WlEhRQ7V~}o67_GAb9J;y^1yc-aYCi8@9$)&eCBp`CdK&HV@I*z^VT>mRkOmmX?7LZOueOi###9cQ z+<|U5Hsfq)G}QMi*vCtzZ1~qo1W3^wX^trxv?hLW z>k2lMg;?0xJ5VxYq^3Crf75@ta5&A-G6LCZez!=sd!6AEF=>nkk} zY?=Mi=WSkCq0gP~JX5F4uVvAKzWwmLkg$a#dBX0TK#8?h%rZFxH!Ip~*}G40gt|oi z$pg_gg@>u0M9xMS@+yS*dG4Q<1*a#*roZ!su-okJedK-Fp(p$t3$C$yN=b|o_fBUD z7=`U$?pfjC7K44~{cqpN+Cla&3)?m?#TRaGPS4i_y225pQy#bWF6X%e{3?=`(&H=k zXQ7j^;!4+>33xe^X5`rD7UAEwwqAm}sotb;#6`{ZM3w!~Ky&U9m9|Jo;Obj+YJ`NYJcnw=xG9}43&zDPpJJcVl zw>%yCVUbpNPV!=HB&zqwSxW@TlwY!0pBQ3FNk_6OICYj_Du;irN;YRiBn5$kue zpwja63n3EqR9q_(rI5b(4p()9Z(Y@|Sulf~o&N_%;W%b;y8NUNE(|Wkcnrk5biI7e zckB9D)n+|YFm4Y%{!J;Pbzi<0+TQVRb`|5_>%V}*;TG)n9mY)2X00gk=-u}idq4Sp z$&acf#6J*%x=LBlrEpP&_h)8e%kjYITurgOT=5c+kA0)|$ya^L>Pto&h&!Tn)YZ!6 zo`U)95aTcE$67kQl4(3;l{?`=^Fh>@YFN10LC*KM@_t1X@jm#m@*!Q17T>I%D29#> zP9BQXji*0FH4;TH?;ss+wbh@-dKook7EOSQb{Y)s6-cI=>m~Oi(#bOf2i1LS6P-vP zUfvmT;^!NgR{7gvs$Wc-!sT^a2OC}n7h6c36b@@D;Du>KVA2;llZT8Y8Q4^N4O3*h z-|M2r>`9RRSGMeDR>QMpF z>nr930}z);qbUaL*NCYpQ04kW&*=w_M3>_7?KboD2XsDFD%6p``>b<1<@lftCWNmh z_GlbCUR^>v`!nUqBa*RFKE1M!?V0L2YbE+W$NOYAY2S(~%F$}B=TEUxxwYh&zx?$7 zJ=rgfnsx7EpFT9QghJ$|yVAiq^HPnl@L{BBqjzlGMegoj{34T8Jn)z54cNiV^Lu1j zPlM7!M+o$F>Q9gJ$!9gEzoQ!XpB%9plJ$ISO2d$gE_{hr;s5k6FJhpPfF~<}pW8b*z;`_&{TEGbAdS2R@AO`BS{9C8pmoNW5t=+J0yNZ7g$HbWz$!qw0XMo` z-5Wisu7Az`dmJV3rW>y@{J%_iO3s0*gTb-;6MnA8>F|Wgx^B5-@El3NgF-JM>$lg8E z#La7dKPkHe2$i20>M(lmaSn*FZ3ny=XIs z@5zm#nT!X4>|Og?U)MJ=S=a5l(ALj>UrwMU6Y)Cz`F)HobSW_=>y@k3(=MrOs{%!( zct&~`>3BwS7p3@KY+uaj;(1)!kN|a-$W7C^rxP`yNm$s&TQ+<9ZoL4+>Q*fab z5-DV9WhMB33VZK(Ec^F=Tv4eIQ7D^`WMm5|E7?0cS=la^J@8$OcJ?Y;#+B@y z9g>y3e#fc%{rUa*y&n&EkHmSM=j(jEj`2L6$Mf)-5~^D@)aDJ%dX>l!axr~6akT9I z@%}8axvCwcbo{=M()nV)M%~#IV!{i;TA#9gTs_W~Ugf38*Y}V$X7(;Z7TdhN%?k>;V|5+@LKs`!m;uY6Im3=b zVRST?DW;I4{up+q*0S8LwH4S|-v=@zA_ga_3oQi|)M+Ko(pRKCx zCFQoWtVXZky@Z4Rzm;_MMI6;>?`pkJg+qG}v zeO!dhS@WL(4(^D}G>dD6y0PwnyH>PB`Dm?;_uDwu$jsa0*5xGmj845}Rurwb{pK1& zp-6Y{vj|>e(cJch)Kbr%9(95BVzi$RjyzpNHiTLoStHf)roaB05a6lzPqV!jB6CB6 zQ<{R9iPkJU+$7zky)XLAcoPzZT*4uK^S9bR zI+L*CHdc#{u}E?MQfe`1YZ+F8Nt&xHS%8j^1p)ND5Z0C!QBssCVKa(|&1N+FN%Df; z!lTR^7rku>iB6FqVq+s;Mhgv@$ zyRzG#?^P&Jv>IBQ@|c^kQ}G%sNFNJhHt&hn!RSc_X_v!L;-5oQEFDFbK@1^9cf%Mc zm7OfI#SM*l>$VrO$PJiM;pZ~fhh{3fRcZhH2)5)#kG~ckbU;Z~<|Z#p39^M6661(G z{Mj4d9UEtZIvkSLb6va!J?a(c1%h(x@#&MJ!IQP1l#}?N7`Ba(+yc~6ANlkCe@lYuqjex80ODRJzeE$V4uW!2~B;`URktABg!gyj-ls0$x^1?fR4_fF-v^I z&e8MyTJ6>p3yxkb=yZldzquLYzR}L)zB?6wIM7^;f{mrz0=w0~%?i z!-FMk+MmijBqX?TYF(ADy^<8F$k*(df!x>Zd#ZE85x18ECFz$cwK^+|ETTxY+{ZNN*1 zgm2jaa9Io*9t>>PT=53Dxh>aP9si_HTM70eT{E#&-FgMB&p3wg-Bz9rYVpUde7#yNJw&Ae79A9769v%z5M>NRh>UXOG+F!%TJKM9F8cbQp3oR@b6G^wHL%Y@1tBODv%&7GT7!L_liQU1#9J>VyNR>>x{)8eE8a0%Sr?Q17F zNBorshi|Wl?7s9mDEBf1{~M#{`X)x-Gme-^KJtL;Abg(g|K8AZ^Rrz)Sbv+?s<&zY zgYM6GH4Krsg?knW0OI3sbS!c|Z?R8Hxb?H$gpO-2YjBy!A6|3hAMLF=$?p^n>w6N* zOu2N0TKk2A%ql7oql@-|otSDTO+7smN5^OlJr}>rq-<*iC;J7y25oMuwMgqJ=D~>& zyts^hb75tjXowtp5#WwOaYKkYq4E#EJg1C11M>x+Gb@e>z;l2UvEQ7Ni_2%A>i19H z>Fkl&=bpT0xuwI44chICn52vEe>A;<5?FjsC7z>uAj$E7nR{}qfMuHrt<1E#!`x8K zGG?&j9{+;1?lI8qU7`%jazh=TfW8LMD49TsFCyOh3bd)>X{ z*zonk{xNRjTZqJ9`h$8dYQB>k&?Q!Eg zJiOgpUbl7EeX@1uNa}_Q3#?$psf&)x z@i8-bJ!sAYKBPwrX|V=4rf!wEl@mn~=8&J@p(>FTS1AH!qexj-k2Gu3_SuqCSMZK` zo;6GWd-!toAW_)udMgS@GqZ>i$k4>Z{OIH{uZ)b0vOFzrgUYF=ISYFSPYkj%5Hoa6 zZiNvvptPOa|LrkDE2`z5D1K%>J07xkiljN%6ho@_v%5GNG!%GJ`ca8?-cc@c_mc>s zjf)Bkzx@5n&1XIK6OnezE1zg6v(ocAasaF*WxE#=G+a6)9%Sw}Ud;(IYoP~D8+v0_ znzaKsS{L3^e7qRULqZNixWzyRaya%LxsJ%*Za`G6$p?-5WA$z5T*=2PQ44$A9Qv%X zDzO(o@SXjmXx{Xf|u|MctRP|M7voVh|G$ zCxsHCR(rZ~O{sKnMhKtL!WnU2|Z^h>5LF{Ht)Wmu!9y1H|aj~I(RcIbOf=Kt4K7)%hv z5IWB%3zQ_C9fxv@I{UWfT|!q6C?0qwLbvhrQQrE4@zve1lie#-Te-ff(jL5u$e7KRUdkZRf!G+?!V=#CK zz)lcFmt7DxYTKm9E443&4leOivqnaL9p7Y+OHM`4eO)4r8DXO_NIzLO8|8(X{qhzB z9FQr7Gmu*-UhUblR9UevARvA@{_rd$G%x4o<~C$H5dkbjPcW+E51>t9H_h0t`eJ`G zS}4`zJ%`M7R8WX8CfC;17FY6JJ;0hHNzg0MXj%MSzG|xWGJZiVFD$PG&sfuc!G%Hk z-aNB*G>`fP?eR?4<10RfmZ78K=5d3g+=OxLoM1lD3*F$vy>=U^0q2LQ8Gs)Ng!h)M zYzVDvd0vH0s@k-Uq?1HK$qP~C+^!*jG8LHx(*XwCnwx z@tHk1p`pu_gPWhC8Dia4d)cZc}sAiJ81^7 zH(*&0p$(oGK$$7qr**4%Zq0m1oWwGX6eU{9R+MK|W7@kgt)Y~LaGn4V0Av6ftiV9m zPu3TR{H2*!6uHgVyk&GfYwtiW32L}&wf9839Mpy=#ToSvq=R2_Yo?#F=E+ z0JtC6j}TQfVG(96Gfp3Bv%93&Mk>OIVy;I zkwA8G07)+ydi%E~n|@sEMo;H|1a1-B4Ex z4qRr#ZSX|wXaHeEBR?4)mh)mp48P|gKOB#-N_3XJFq6f44ta0{>LF$%Bfj$D3`*IA zV%D=X@Jdzf4OXwG?ET6iOR`SHtTxAg_z6H8YqoSyZ)UzL;cz3Sp7mU=)#R$S?D;>J zy=i3WLLrb+wj5={p4T0m`;j379}oc10HmSc+PTznrY#tT)_E@Uj( z|8Yube6l61?2+uE7p#x({nBmcPipD>K%Vw#@>JtYl(!Z8l4r2L=MxFkABL_>sj6D_{e2K-pA?}$WKV+ixP(3gms}X8r;}~gqiJ? z(VD&a1f=BA9PS#Q>1*&f+W2X-nqVp>oSzhDYMu6Efyh_vaeSt6h%T8wbdoIgW>wlR zUPV!$H|M)JQ!hr!U}$)p8+<-SGr;`XTD^tNI4)3)0Dw&jLg0tVq&y8^0*op9l@for zGvGGpA=XpuHA>)28Z(Q;ua7EOu}Mi8gUdbE<**Ghu!d}gH3=Cx9a0*n3MtZEAcTsJ zjz$8E^7^B@wR%_HQ-Xd~g#Je+Z7T*K+lb z0u%UbqDNJ44(90F<2)qHIlal?_TPP4#QwBpR%qDz5W4_W1m=92U(zDPSkrL&OW&Mu zN6dw0sx$E77F;xUwC>7fM{~uS?Y3I9`(ykf8r*|ZH%;5W?stAhcCQXIdAu@dceslRXP5%dhZoSOjAx|j_#s+C zE+T5N&wm`37PAQzat7&do5Zc_9t~#fJ$tOgt*GIQWMgs^h2f~9OY$-1WbXkW*aeTQ(}1c~m=wFdW) z;5>{KKmA3rfTey7{W(8UJw(XWVlW>(DU7ldf3;>hbs!QViQS5-aM@%`ao@NI2W^O3 zzNXLRl6N5~f;^Bn;dTt_xrHDyQQSB1^L49R0L6N8o9J9ail4D2IDbHjz&h(xJBBz` zAwi878y{Y)qk1c!M7;xyzIyKJk9ILy!68InBJ+ozLt}(n?-bNLqG+|Wv?TO55HP$i z*Q?ABJCvF=E_cK)I5IUw`RhQ*VTEzWw9HLW@>hxHo0(W{IWQ66XyDj5txgzQSmX-v zp(q|4^OXSRLH^q{1jK4ty*jH4fg&#s zmdg6273Q}aT|KETxai@m@+HW@&O+K092~B_ZI|$-`5nd&j}Q#_2~;M@@LoPI?gU?1 z30@*gA!Q!fx>i6x!3LF zJmp6Ufg9q4$`P|`+*(ZYJHV_3WM9DT=BdvN6&b>rhfN1VBs@m~m~k7aptPelR-8h$n`KjDb%pw1Tkx7J<|d>84&_+H1$^5UWuLs3}Iv zD&2P2EG#S(4hW&%@c!TZm8gQLF^f-&1Q6i!01!p8dZFJOP}*B{JGHA2Hr}~&2T7jZ zjF+txbz1>%jx5QCDrWQjm^?9g>EO}Mh-3X|=sm{F4&P>M$d~if=|g9VQ{^ml>n?O* z<}ZiHc3<^Pe{67HK{?GbNHJ-9PX@`E1k#zTGj-)C+n@azkk{C2fGjrQ42-#yM57 zl1~wl%j%tiEe81l_IncWnt%{c{bIR<5s?(qidGvSPME@;_pn=?sNE3pU-D&sNEpf( z4uOvpVM!-ND<>RQIOd-Rgm%Wz?vOh)?|68g98AXK_d}2eC2^o?0H17h<@spY>(}&w zDDT|RDuiNC#2UnbR|zQk=H@1UsLCa^O+V9ujdO7I^N8)lojDM}f`**m&h>z>LNI9x z)3?BkK}7+yCZ-?)>g?=%ADM>0_aAXF^uZq^{OCGhm@rW7zUyde0{U}#4u_sA_7v5# zGWw_sPmh=sTHLd+hfx$@^TAC6bn1CHLyZP=fCbK}0(|<;pYc0r(JOW#S!?}}lPZyb zdrDp)!a4JhaBVRw<*NVG(9!$HQXKSrunAp}5K!uEd%hF%7zXG^4-vxx=uF+}=7ifS zYUdARp0t2a!Nl@>yiC$iDz(-hM$Pg5T$4L6H9|fMIw4F%D-M zCmtyJG?rNbnr?&Hq`++QdmRfsBm|BDqB!;x>|7w7<*12^OJ%1Ww{`SDm5x@|=JVv8 z-lyt3l)o}JM|AFF;5HW8k5gr+z8@La3n3C*ialQf0Zn{J4!&fqUO|m6h5SRp)3wnI z9yP*=Bf1)GOe8@RZEP^giv*)K$MZH75T@DG?J;_Rs{C$@*B+_oMnuXpO?7fvn<1I+ z*8c^R0n<13zL7X#%5+inB?xVsHLO8JE>WeNBP+}C zyu@{))9v&*<-oCd+fqw1#}WnPFT(^palqIhlUVAzjmYLBQxfAd5oyATil^s$HL#mr z6=j$co3L+r1jOWE>ri%?<76*af&XaWV359QIZB1@mjFB4gP1kkgXd#+#K4tJHwOWV z)?>-LceLt-(YC2=4!OyPyglF^f9N-#a?u-J)S--ddX3rSwmyHNYKc&ng$2b14K6GW zgmVoXtef|{ND20S(Bevw?)5i~{K5%)SP`~l zX-Cf{d%?Z*c(a*Qe-`-yVLR*x2g4X=kS#$xCdhWNva`p$nhu=_uGCYgs#9^^P>mVr zS~YRcj2jdo!-Lrs%;6-mIx&6U{V>7nRbz<5#xOtM*%2oBekW+Tb7S8GT ziK0j^ZP^rhZ!73S^QFwHf#U;c4D#?acd*xYBGLP**NL0w@n*^<=s(Z!695)!*c#en zUJ4~)IO^|lKV50GW&J$CpPu>fHfFP^f|1@gmGFL8v5~e18^oZYE1qO1Q2ZQfuBfMr zZi)MZ&D$kWW<@Nav^V!b@OkecWPPWb7I#O<>THqKfrx<;K6XLBdB$t-S{nKuQFk=* z*N`I6@xkh;@)g_%U?xbh0l^%0*JtK_)V6zms(L258&_|U*XpaU)+B3U5kJE>8uu2x zNtQX^H!C0SA$utmup5oC_)$&#%m+Dg_vTAK&X+V;>x3^?!I~lUfn$);FA_3sk&Yqs ze8^vgERlgi4x7=I)B8{TpQ-}-4=nOrjd@V*d_Cf;`n6~bI>d<&RJpwi?{t2qvn#FSBmTeL9@ag5J2Od2>4 zNXb0@Jh>V}%7q@|Pw9V}o!&XSSs?ksCArm>zsX_TuIe37_lwWi8u5Yz#4j9=BuWZdD1zs7zs2xg)kjmLh z$+dpg3@;FT-=fA9W)rUyoNgYUKxJG>d1-3)Km>q$d&MrtOd(O7>RQeMABcq+kX`Ql zo2=-C=5+`yq3&cm-E@&nr{c@XX!-Ea&`;9(-E)xVjh5S>kMy7@iy({C#3D!y6_jHGc6rj)B*IPs#Zt zf@_rY`gNdPK_UxV0x1?FMiePP`)ypFx!^PXXX`6x%nvQL~26j_#uoDX+tXm<|`5+OnHmHzKZ z(;Dsl#d_Wv`RY@&g8BM9VBEa`K7AK(;O<)Jae;&id2V1XA!sB-i%@NV=Kx_WaBUXC zxmyYIPW1QSC_CuFztpXUNgN5ul8sk8g~89lopu=V^oaJ)c}{uCf*i3>u910)*TJ6H z#7_E3@y7jS(gVDn^rM930Feo?&>6E+4tr}TQG$uJQxt==EkytVAM=*j>*e-4|EXL+ z>@a)n->Z;`gZ=;@si*IvKp#SjJd$((pCjIB<*Ac<83_(+=UrD(QGwXy_it7NYLw58 z`)sJAOive5aX5_el&l^%fp`Rxe5C5VW%s5|uvChSNe%?y?_!KgsRn5pRR1%x&c9<5 zTcuG3zEV6-Dag6*l{WWWK2@}Ji^)73TT zm4PB~&EZA|G6&Fo#X?`qLU&*c=(OjiI5-#W{~U|#f8wg2To9LczkW4N*gdsXAqpip zF1+o^j{tEE#9v=`x6i#$@zJdH*r6`Xe(gXm~n|k>QoJ{j0!$==AcbXDjV~~%-N!i-ys5A?=7Es zKRN_Y?mo$0JpsK2OvG{WEyez)hImRZl;%)o)bQxY5+Oa4)ERJ`E zP1@Wq(XomCEBCY7Y7`*Hs?75$lLF9iOc1b(Z~_bu;2P55?@QUxif7y>W5!gb;=VpP zso5#+mKycyS=EcUd|sjG{!s^A%30uqJno!*-#)iyPWfW1jw6}cJh59^qszWDVa|=X zNOip2jQ?ut-#Jd}qBs&`o$pKbw?A%@_@)QA=RhFylcP&Ytw*yqG%fr0+kCbHjU*-X z&ENBH)MIA4JY;LL7hL9M5)#VkAnaCBygNrusBLn_uR|=mL4Rdj~v*d`#nfnaWD}QCK$!^%xYgb%J3OT3-Y*^*d;X_-&~m$W+d#ax(WLV7fnn3! zhibDYv^n|=I8%z8b{t~&A~PNu`(=OFOfC@VA9SSu##{F1{eRCs)`}{m1yF5T7&Cp4&HL1lIh=H zus-{1{4^xrinL91)$?oKv0L0>xuHnP4{kB-8>0i+@2~w%834NuSN`$%NX~nFq#^w>#3WpW+el69Ltcv`gmHDSyh63b38m-Q$ zP$wue?6qG&QC=7%Skt-kU~OIK%Aj4(FJ)2lPwzx|PC^ouxraqUB%a)6wMtbhqMk{- z9-95gY>OLT0g@Nwxp2cC$@{l3(#~!ESvXv9tDj#wSnXZ3hL~7WWFqa_=e5IkGuZ(z zGQJD4Cw5W1euiEne{x%>+J9l?l0vIvq2=Y#;-Fg&xvw42D3tA5c6!lT>>1IS^uD7I zaX*Ln^!GoSK6KFautosPfBIzD3i92IHzA_*0c;~CA!Xu&z%^TdXaU}Vnl`g8g9Vu( zXL?(yn&y-!quC|V8(TpaEt1C1(~Po&^UFpT&Rka+&}nTR1ZXzX&(Bz!UsGh@vuTLA zWUnP3f&6mAox4rHtkLtmIi=UZq#%#DhTFt|M{Z}ha$dtmZ?0tfk|w>u`WPM)8=GQ6 z(Zv}8)EFZM&8<|F%HsQ8`TeKy$3;RV-(oX5xk+xl|IuStdCv8H(OuGxGTa}GWyVCd z7e{0tV)F}`Ej(NawD+4x$=(YFTmKQB`2L$PZwO=bzMwwo!X12{)8k0j33-8ITCRbRd>+fff(SIBf zO!8Q@ha{5GPi0spaEOm@ahjhXba{G+_sN2Da=^lQoYEU*#@D*!qJ4~qoiFLM`i(Ud zCx_yY{NJNLeZe}nK7YTSUPeXv{yF_AdF`g{mxcA`1e+b~XwE;v8WRejh_nO2P}a+B z?Vn&GqvCDN_;=aQFH%KCc1*b>gS2*}a+5r19*?G4Oe;Qo=IsHd7SO939?k$QJ;rvwn>RL!=CPQ=6XNKl0?yQv8@=fyF zHz-&dNo4z!lIK2XO2!*AN2NzKpngw#rq`1aJ-$Ik-S%_H@tvB`kB_sAY`3Lu>&hF; zY$P%V0^35bJSc?;I4yDLn3V1}NJ@&lz2dLt03%;|?3eh|DUXXf`!F4j#xKI;QR zx>8*_BmKP}+_chxf1IpHW!9qAI$suaTd=q6X9AR_d?O>!RiQUSkDF~pFtdNAy*M%} zPw&neE;c!iX)#GRVE2=9LbA%j6OH zT9qLB$5VCM#~yRfG)?rXM|LVw zPD5yHrv$CDhKA0%?vqU6!w=-0Mu`uiniF z&}Kv`8&xVLTNmL`jrjT`X0M!O!z8)CSzI*J3ekiH-iPmlGHC>XtUbd*izgO&-pZ_4_F99JQCy2zu=>)+ z$|NLug%8A;BH|3qx*W&Gc*XeoEWBQ6u~5U*-b8-+LiZGY3cI5jH7MTho*Zx3JOv(p zwBg^ynV-|s@36+LZ;nbA)?fuN_U__r3D)(0ZJ=NBlBZ}fViDCoBUrq*s(<_dA->dY z`K+dYcQ4*z@`q8aBaJO|DyXTtoac+Zs+U(MR-L2E-pBmEloKOzc? zj`H9cU{l`Xy59)7L98)BN}66DYMf4`ug`Vqxptj`OA#|;& zhFg4w(KkliCA?~Kr&Y_hSv=9#lTBOh%RiER^jI_`@on`=^;jJ`A!N%zeGq{}8zB^K zn9j{=SA^cZv=Ui2J+u>#*uvcg&!!~IdD*=V9l;a9ctPQ+r!Jyn8Vm;hxefxPdfK;ZByO z+?vwqf32OW2b#&`?;>sA$VXnF)UC|da|AeEsJqZI!IO^;!`hwb@h(D!v`vxW1YBgW8io&a%*^() z7p+vMIjt_RvM0VDyI2L+sl*S=8Ma%;4j=We75B0Id*iqt(l76Q z==~^F{%X03KVRW$mZgounS^G)8E0p_i$$oOS^FUqv~xhyO8S!6qguJ&1h%Gk&ug}Y z+`nTqlHS64^N20*rQZyb=J*(6;6aW3##PhM6a(BL{?9K`zjtzW9R7uYxV`)iawe@! zn&OfEMsKj=!n(Og6inSS|7R^*eP{Rq|BpAe7o^l_y_J2=mp*l2%D|Ag1?bDqN5MhA z{UCAPG=6pB%!u!p$nlEQKC%i9& z#(dCwz8io;cYLhMEy?}(d(&nAr85_49(+*F$@rYKC~ImmnY^I6e7OF*_I_htZ+Bi^ zipHkV_HR>t_4*a+luygwZ?Ldse&tp(S1o*MzAHq_e(%#c{kT+0xpxu~ByVmNAew^Xuga}v4xYM{+K};JOkD%Rg^x@Q z8#(m3PrYT#NdJcR>fp!E+@_YdzTb{9Y?ha+ZQzz(e%q#;3pXyUW`mHw;~K zyL!1ZhAq#2r=!1R%$rMWS?Tqw^Dp;>mMh=!(; z(K#~1^*S2%VDGHguV1&V|5^L=cv4_#%qhRoT}g5FjDBRRHZba+6AQgc+c6JFsy@jw z^FcY!w3&sgKku~vWp&TyqN+|X&p99Liv_a3=YRga^I5Cpuf{$Wc3!X~Z)4vvswKh$ zl+{&@!wJuREFfyVE*8?pFxRq?OCoYjNCJF7^kdvtHEp-uUzLXP2cpD9CxWtH@g*CQ zyVHcyC6?lxJ(rBdZz}zfgPR)$eTlkIRj+i$2kZFWWo>zy=pfEU7y2zWCVW~);2e$o zba9MBl%Vi`*Zn?5&r?11-6>p8pzqJ*?D$-v^J)pM=)#Z;9*P38+5tiLsrKobog|PP z{;2+VCX!$Jbp#HU2LGp0=hgO+IR6pk_T;a(#JZsQtG(X;e!(sEbd<7T>e&dT^%Yu0 zGKJ_lGQ+jH_erH45pOILYT9U7>PG`aaqCDugVJa)9cr6h-<#t5wYBqq{(F0g4rGQG zzrt{ha{|fVFDBV^KNZs>AxUbME+ZDcyxOiSSu*^^Eo_I%5bquO8RbB+gpuo{u_p7 zGouQUweG@@dA&jtbw_PVsl=QOQm(ZbKz5Dd30MOihU8U_5uOBj+WU-s|q}? z(Hk<0qOy{LcY0<pQKM=H(!I_CUS0`0|%8y7iK~wKme;D}Vg!Ke}0i7m}PPnLgoG%YMo363tuEb9J#^ zcqV+#jsgpyMl4Eg61@6&g{lbys zvq@DfFE0_%W|HfjP;@0}<+u2FaNeb^N;oVg~xJ&nitvPp0gWHV|L8#jvAA1IK_FZgZYk1Z^vNExdnBDj9Sc`A4rngA!)EjZGraJv;mG9)ZnY0>Y_mb(W^230Xv<4GbmiH2-rWBYYG|?}t~5mO0R+s=irJ z#_;bVcHF@a4ts01Nz&AN=;SGR@5#!_txb2_7qDv7y2|zFx#8LC0qHjiXdQ?dhPjoL zQhBsFj-IsK#?C7C{EN3A9?ANdS@t0f$2h-u^^0d%H^1Nn;a|rix$gds@Ug8#2(!ZD z5o5&=j;DsNCw4z{UrVP_AR;1qcPrdUJw$sM=zYMSc3c^0o}FbV3K3i=i}}Hvp`HiI zoi?NC?d{SnEt2FnZZu50qQyrg5+rNoLAqpD6!uZSxx=5E?n)FBsv?0P0zIZfV7R~4)Qw$Za<bdhUOw?)v-t54Y77ydiur+{?;2Z z&jJNYf)$Q@)<0^*b~66}$DG1U*zG;%WaG?0)i>KaxE1S6~9?{fe4%O_p!F{kkUya@} z_`giYJ%_Ji>h7L+M0^mJ7*BVFyk9HCnc3LHBzm7jR$hK1Y~73F`vcM3{5a zyz5&7B2XfZW5;-wcVBHK`g)<0C2vD%4cQ$6EY};B8Te+}gYd*2<~^YOjIE+FLzZAW zFr4+Sf9gbd{erpKHH*9HrKO+p@-tF+zLUN)#Sa{Nd#wcem>EaikXK7wa^c128;Vw9 zS7+!N*A{Opc?D@6+{4r>Gf{>9rBhg z(FUKG*LM6lP1#So{=*fo9ONp>dYrm(N@rA@`8K0 zv$MN!^}7gxJkFGz_mJx`PJ1``cQLY(WFEMXXw$JQ%WdmjkU8;G{hU)V3uFK zJYrS&FA}ix#*MZMoy~O<5vC=Xbs=u!{2(q(Q}&9PEgPTl(*ujUy;~Y^H%2zcS4HBC z*Stj}$C>%X9&7EUNu={PeH}iM&gP0u0*QA3>v{cdHT)XKlb)#e9{QueiQ>^X8&Za%3d49S${AJgLtrQ4qCqw#061-Z!m|5nDVr5S2T2Z~zL~ zuXu0D!7Hv?!|~b`9*EuGc|m<@T!_6Lu3L0;jaO?EM@bpDrnNo8cGkzT;x$)?H5pONKQ$tIj{WYGS-ETqZBZ#1^+8ahh2xNpjBd~f0R zS^V^2Clw2uOpNH;v%vN*&S}iFp*g-k&3HO07Ji%Isrt8h_%yYAA6Buyb^G70enohe zHnMSSKyXdbIc!CU^wF=RauIHBaWuD~xp_ELT{d@0oa`L;ZTfVstzLcpoP{i~DA8;? zlIgnN%dd(g5(4%U^yh0bI?z}XMQAm&y{THzJ@`t@~(5f^ejE7RN$glFG5 zkXhJ9HXgR%1PcqzQa_@xC~xNikrqBimU@jr8Z#@&hYia@mDwq<pbx$>aY7nO@*WEPKgqnJab zm1QU-Dwyf)2uu&&&;@Wc!tl9UdfIHf8)_W>guigUN3CwD{xfEmAcPr=Lz7EzmX#DT z1*Y5m$tcAk=9rkSUG1vIqh)VQMPV5svdP~$b{kY2)b5Dt@Yw|F~Sq zH;6*)$fB_2dkmg~dg0A!hQ*bgHwDjvX?f|Jnx3A=V&*V*b6$C}8mdsxl)tQhCk`^Pt-)~;c)L-Agz04l4EZEd)0W!xk9-Wb%t^T!>PF{!_6 zgVTzoew>pckx-rS<(JMDR|{vLMa^MAZ!is)II1>_(Hl45R>QM5zu0dQJMB!fD$rd@ zdN3{_H{SdhXV9YF!9;Dr6ZDerj^K89DN2738iht zDlLHvTr8w}s^krtGG6a~>WFtSGMGInRlX%hoW}nLf9im+u;p1{tX-ZUp-M}~>z~+{ z!%(>;-bY*iMYwO73PZVK1)QRNx?`3>7& zpv))DboK}CnDs3`1IqQI#HVR(26>H|L8TXq-k|;x?GSwZOr~*Ob_Q?!%*F;;=gX4N zwyKR_r-sDKk7C`}4&O-s+vKlCT!Q>_i4$Ub0|tov&sq^E{X{wIIK8@ZMr@3nIm`{? zVi%~GZ|^h_Ev0)Sh^LHLJQXiqV%0v??kVM$X`crMZucMlyV65TW^Dbu?7wHzi~J*f z2_IEP5pB9LbSwy>?mWGuFZu`9uXQwA=u$7aC7;as7p0dr=vL2lR%%m|&(K_|rRP@Q z{?BZXNDw`13kr5kClE~}OGFcXaeKf{qQz>`Js{C7Xqz->=r(%8uluzt?p)>XqT3o@ z5(EyYG_hMm`9rT?rp%K#hxz#NV}^MElFDAZZ9%PvqspSU6*zFIY<}1A`F1aofV5qd zI=yFcb>GvR_w^^-Q4Y2)=mxgqyn>NolJf z@rnp5i*wyt!)5nr;uMe>VO4XJ7o^^6lXCv~>cVx3aMfP=`y=sit8MEB((}&#g!Z*x zONZib|N9h+9<h;qF&jkeVhrsINL9AGFRY z=-g1`m+N({RV#t;EOfb~nctTxr)pJ>puF!`2s9tQntJ1o>t&Y1#j*2m;1h{hrNgpz zJa3QKDGLrzDXa=FB%%rKJN?n|S5Jzq+TtIHcNANIZna(ig35(tH!KnnNRgv^P&}=h zsR2~e&P+@Gm4o1gNt&}>b=4${=T+`6`y71t{rOak>!maDqFXjhFiwXkp^scMi5! zmd6tk6KD6A3rxqW9BNLER!z;#%_k22)b8kYKR9s*>XHz`pQ0{LMO(|k)ZRT~8|@ub zsn%S}O`BPuKYETI4C&~LqdvNHchBtJlOW1@eU~Z54ph@Qyu#riOpl(=#8ZT zL(cq~jc@0Knc!w+Rx9FW_J$0@)sT_D$TyebNYQKje~EoqE74C*2bhUHotU}zq$hk4CHqx~$=B)+7T{o^T`;(Jyi<<>;?qKZ^}#Ou%I~A&bn2tmz|D(lrE&}2 zS{~eNB37{Nksw_UcyRa%S|t;DdU}lGc1H7Bi~KQnwaXL>1}Fbk{?S2#4VS!TwiaP) z^-={nxvhB;NBk>Sc3j!2t!uZ`A={ze{~l2B_lJzz4wdUKTI=c+-ZbXv$&;hWN@&Wi zgyv+o)q@7oI;<~1h{G(1>{Q+|+k8Z^yyHu_yR3gw^?L{Oj$2~0D-!j8Vn z=xjam`3>|)IKI*5o`jwc{hez4qg~i!HhwuRiZ5G)0i*CDFzc&lI&X^SEC=>3Ls4c#Gu0;nWrQ`@zk!b!UR)@txWgE1MZO6MECvYq#C5+j&jadDK9^ zCu8W$1j+eTVUTyPT4Je#X~=dRcgtBVbgQ?%D^|k`dSfPCrm``?zF+mz`|>V`uC-G- zjeP|p)Pekov|RIAjr6(Ue}NuFN4C1%=Tt7UMAnsa(G#_!*3}`xZrg=sy^PjXi;NS% z#qV~T99xY)IDq~!x2D#h%IhT+zdmLqYlZXH^lU9v)eIlOe(A6rEepxbuL^`s7zSfk zKr+K;Cpk~M{GNb7J9LG`l-7>BQdr5ATMpYbC3iM=Yr?k#Ulua57U`^IvD{iJCaXkjjju5o?rF1s$DaenBoE7;U6hou46G zP&BMTZ|?ejf!)U?vfmTN_G>F=@g1d=9QY$62OY;@W6L2&_LDJ(mxmuuYAaH= zfkbOJ>9Mn(?^J8?Cf;cS;eK_sgxn-ObnXA!7Fw1G2G`F0sp=X+{d#o|w{3Z}0%cer ze>pXtYPe@W6_C-;D?xfX_Iq;;5X@t3IAWgL+WX?O?T(f|10{? zLmSN-$LN;bSRq9AQ^Z)!&q{;Q+T4Bu_$!e>y9C}5Db{i2@)s69cv!dzEep0rU&0~# v_6yi53i*y`8i|0Rj=KcQxk()JI literal 0 HcmV?d00001 diff --git a/examples/multimedia/videowidget/doc/src/videowidget.qdoc b/examples/multimedia/videowidget/doc/src/videowidget.qdoc new file mode 100644 index 0000000..bb040c4 --- /dev/null +++ b/examples/multimedia/videowidget/doc/src/videowidget.qdoc @@ -0,0 +1,19 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example videowidget + \title Video Widget Example + \ingroup multimedia_examples + \examplecategory {Multimedia} + \brief Implementing a video player widget. + \meta {tag} {widgets,QVideoWidget} + + \e{Video Widget} demonstrates how to implement a simple video player using + QVideoWidget. + + \image video-videowidget.png + {Video interface with control panel} + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/videowidget/main.cpp b/examples/multimedia/videowidget/main.cpp new file mode 100644 index 0000000..a4e2dc4 --- /dev/null +++ b/examples/multimedia/videowidget/main.cpp @@ -0,0 +1,40 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videoplayer.h" + +#include +#include +#include +#include +#include +#include + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + + QCoreApplication::setApplicationName("Video Widget Example"); + QCoreApplication::setOrganizationName("QtProject"); + QGuiApplication::setApplicationDisplayName(QCoreApplication::applicationName()); + QCoreApplication::setApplicationVersion(QT_VERSION_STR); + QCommandLineParser parser; + parser.setApplicationDescription("Qt Video Widget Example"); + parser.addHelpOption(); + parser.addVersionOption(); + parser.addPositionalArgument("url", "The URL to open."); + parser.process(app); + + VideoPlayer player; + if (!parser.positionalArguments().isEmpty()) { + const QUrl url = QUrl::fromUserInput(parser.positionalArguments().constFirst(), + QDir::currentPath(), QUrl::AssumeLocalFile); + player.setUrl(url); + } + + const QSize availableGeometry = player.screen()->availableSize(); + player.resize(availableGeometry.width() / 6, availableGeometry.height() / 4); + player.show(); + + return app.exec(); +} diff --git a/examples/multimedia/videowidget/videoplayer.cpp b/examples/multimedia/videowidget/videoplayer.cpp new file mode 100644 index 0000000..1a778d2 --- /dev/null +++ b/examples/multimedia/videowidget/videoplayer.cpp @@ -0,0 +1,137 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videoplayer.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +VideoPlayer::VideoPlayer(QWidget *parent) : QWidget(parent) +{ + m_mediaPlayer = new QMediaPlayer(this); + QVideoWidget *videoWidget = new QVideoWidget; + + QAbstractButton *openButton = new QPushButton(tr("Open...")); + connect(openButton, &QAbstractButton::clicked, this, &VideoPlayer::openFile); + + m_playButton = new QPushButton; + m_playButton->setEnabled(false); + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + + connect(m_playButton, &QAbstractButton::clicked, this, &VideoPlayer::play); + + m_positionSlider = new QSlider(Qt::Horizontal); + m_positionSlider->setRange(0, 0); + + connect(m_positionSlider, &QAbstractSlider::sliderMoved, this, &VideoPlayer::setPosition); + + m_errorLabel = new QLabel; + m_errorLabel->setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Maximum); + + QBoxLayout *controlLayout = new QHBoxLayout; + controlLayout->setContentsMargins(0, 0, 0, 0); + controlLayout->addWidget(openButton); + controlLayout->addWidget(m_playButton); + controlLayout->addWidget(m_positionSlider); + + QBoxLayout *layout = new QVBoxLayout; + layout->addWidget(videoWidget); + layout->addLayout(controlLayout); + layout->addWidget(m_errorLabel); + + setLayout(layout); + + m_mediaPlayer->setVideoOutput(videoWidget); + connect(m_mediaPlayer, &QMediaPlayer::playbackStateChanged, this, + &VideoPlayer::mediaStateChanged); + connect(m_mediaPlayer, &QMediaPlayer::positionChanged, this, &VideoPlayer::positionChanged); + connect(m_mediaPlayer, &QMediaPlayer::durationChanged, this, &VideoPlayer::durationChanged); + connect(m_mediaPlayer, &QMediaPlayer::errorChanged, this, &VideoPlayer::handleError); +} + +VideoPlayer::~VideoPlayer() { } + +void VideoPlayer::openFile() +{ + QFileDialog fileDialog(this); + fileDialog.setAcceptMode(QFileDialog::AcceptOpen); + fileDialog.setWindowTitle(tr("Open Movie")); + fileDialog.setDirectory(QStandardPaths::standardLocations(QStandardPaths::MoviesLocation) + .value(0, QDir::homePath())); + if (fileDialog.exec() == QDialog::Accepted) + setUrl(fileDialog.selectedUrls().constFirst()); +} + +void VideoPlayer::setUrl(const QUrl &url) +{ + m_errorLabel->setText(QString()); + setWindowFilePath(url.isLocalFile() ? url.toLocalFile() : QString()); + m_mediaPlayer->setSource(url); + m_playButton->setEnabled(true); +} + +void VideoPlayer::play() +{ + switch (m_mediaPlayer->playbackState()) { + case QMediaPlayer::PlayingState: + m_mediaPlayer->pause(); + break; + default: + m_mediaPlayer->play(); + break; + } +} + +void VideoPlayer::mediaStateChanged(QMediaPlayer::PlaybackState state) +{ + switch (state) { + case QMediaPlayer::PlayingState: + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPause)); + break; + default: + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + break; + } +} + +void VideoPlayer::positionChanged(qint64 position) +{ + m_positionSlider->setValue(position); +} + +void VideoPlayer::durationChanged(qint64 duration) +{ + m_positionSlider->setRange(0, duration); +} + +void VideoPlayer::setPosition(int position) +{ + m_mediaPlayer->setPosition(position); +} + +void VideoPlayer::handleError() +{ + if (m_mediaPlayer->error() == QMediaPlayer::NoError) + return; + + m_playButton->setEnabled(false); + const QString errorString = m_mediaPlayer->errorString(); + QString message = "Error: "; + if (errorString.isEmpty()) + message += " #" + QString::number(int(m_mediaPlayer->error())); + else + message += errorString; + m_errorLabel->setText(message); +} + +#include "moc_videoplayer.cpp" diff --git a/examples/multimedia/videowidget/videoplayer.h b/examples/multimedia/videowidget/videoplayer.h new file mode 100644 index 0000000..3657a04 --- /dev/null +++ b/examples/multimedia/videowidget/videoplayer.h @@ -0,0 +1,44 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef VIDEOPLAYER_H +#define VIDEOPLAYER_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QAbstractButton; +class QSlider; +class QLabel; +class QUrl; +QT_END_NAMESPACE + +class VideoPlayer : public QWidget +{ + Q_OBJECT +public: + VideoPlayer(QWidget *parent = nullptr); + ~VideoPlayer(); + + void setUrl(const QUrl &url); + +public slots: + void openFile(); + void play(); + +private slots: + void mediaStateChanged(QMediaPlayer::PlaybackState state); + void positionChanged(qint64 position); + void durationChanged(qint64 duration); + void setPosition(int position); + void handleError(); + +private: + QMediaPlayer *m_mediaPlayer; + QAbstractButton *m_playButton; + QSlider *m_positionSlider; + QLabel *m_errorLabel; +}; + +#endif diff --git a/examples/multimedia/videowidget/videowidget.pro b/examples/multimedia/videowidget/videowidget.pro new file mode 100644 index 0000000..2e26a55 --- /dev/null +++ b/examples/multimedia/videowidget/videowidget.pro @@ -0,0 +1,17 @@ +TEMPLATE = app +TARGET = videowidget + +QT += multimedia multimediawidgets +CONFIG += add_ios_ffmpeg_libraries + +HEADERS = \ + videoplayer.h + +SOURCES = \ + main.cpp \ + videoplayer.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/videowidget +INSTALLS += target + +QT+=widgets diff --git a/examples/spatialaudio/CMakeLists.txt b/examples/spatialaudio/CMakeLists.txt new file mode 100644 index 0000000..26b836a --- /dev/null +++ b/examples/spatialaudio/CMakeLists.txt @@ -0,0 +1,4 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +qt_internal_add_example(audiopanning) diff --git a/examples/spatialaudio/audiopanning/CMakeLists.txt b/examples/spatialaudio/audiopanning/CMakeLists.txt new file mode 100644 index 0000000..302292a --- /dev/null +++ b/examples/spatialaudio/audiopanning/CMakeLists.txt @@ -0,0 +1,38 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiodecoder LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/spatialaudio/audiopanning") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui SpatialAudio Widgets) + +qt_add_executable(audiopanning + main.cpp +) + +qt_add_ios_ffmpeg_libraries(audiopanning) + +set_target_properties(audiopanning PROPERTIES + WIN32_EXECUTABLE FALSE + MACOSX_BUNDLE TRUE +) + +target_link_libraries(audiopanning PUBLIC + Qt::Core + Qt::SpatialAudio + Qt::Widgets +) + +install(TARGETS audiopanning + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/spatialaudio/audiopanning/audiopanning.pro b/examples/spatialaudio/audiopanning/audiopanning.pro new file mode 100644 index 0000000..ab5c81c --- /dev/null +++ b/examples/spatialaudio/audiopanning/audiopanning.pro @@ -0,0 +1,10 @@ +TEMPLATE = app +TARGET = audiopanning + +QT += multimedia widgets spatialaudio +CONFIG += add_ios_ffmpeg_libraries + +SOURCES = main.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/spatialaudio/audiopanning +INSTALLS += target diff --git a/examples/spatialaudio/audiopanning/doc/images/audiopanning-example.png b/examples/spatialaudio/audiopanning/doc/images/audiopanning-example.png new file mode 100644 index 0000000000000000000000000000000000000000..45c53975d0525a12db285ba0674d53040dd86b8a GIT binary patch literal 171760 zcmZU)2|Sct|36NON|H8Y8POe5)*{2WfeH*f` zlk77X`#zXq#xTqEANTV--|zGL{^#X#ow=@a&h?q|S>Nw7^UBP`K;ZD1!(3ck0!D^6 zEx5RNTDiFP%^u|CTt+al?yp?M_aP zj_o}P@`rr_EndEivv5SUHgq=pYUpunZNR*tYN>m8^0v_>6W%|l@T;0tnK{oRB2>8BtrV5yxr%JVJzh&^ zW`(bcN(E>=uj6etc~&SGKKOjUCeNsKxJSfnT=PjO#-YTYNzcz^Bs53i`S*R~zO|!& z`aEyd{;}Jtaz;Ppxcho{4y4?Aza;wC;e>``x9@Ls-x=yRS5{S4edNgXLgOZNL2UBx z$0uj5y_}PL>{$4)y`f?3)v-H?E{-F`?;|1r#T$2L#D3ptP##6qN)^cot#P%&FSfX~ z>K{|z4&db-asvR=Q5Q$Y;m3~j5EcLs2><}p9C2k|;*H`Va)od?-mXm$vg0gj4D5l? z6Jukp3!L^ruKnC+xDIey+?)f*=-Yb!F?2Y-? zndeOu7a!-{an2Exx$i%{d0I1h{?pz!%elvO-BQoUh;z1d_JP5?d|lywR(5&moC}Bk zHnj2O;yV4;-ob5Tac+Y%|B&0g2YwHX?`k>2Jr$iE!ymyEgFOGR`^ADEQ7qOzj0H2AQTl$4Io<0o1c zH}(HLobygs+SSkRZ!IOIz`#JoKs80UkBgFurlzKnvZ|7*>LpH(OTGv%Kc}EeUcNH_ zn&dz8+=Tf$`?&q>=LYwZ+MCzu5!~NTS6X`SLI3mmmz=O5xBq>Tm+!wn7Uu&h?cGsQ zQB+p?pSd|hb@r}mnYjhQJZx^dd2-f_^9-=YWo4az`v3p#{O=S0YvhCf9jU3V{@)}2 z>(2ijdEXc2qX+loJkk&Rzv}w;;Qzk)?}0i>d!PKjR^ngF{LfX+I)e}EDE*JlIJeFi zmT=T4?sn7k9_P$4vb`6#59goUzs{UC_g(RO+^?*-xUO*--MoG;h=9zI!J9O)qSwE?yJJiT8KkEbMfrm*^4@6CpTVY{**iW8bf;#*b4k z+E{p1FMT`z6+fRIfY0r)JP#LRdft$I5~_bYp^}S^I>2&Q4DNiV@QN77^xuy+*IGhp8V(Jlw znnCnjFNX5?I8^MQ`FRp9cWHJVL&j+F`T$)sN^KZ%l!%}&GyTI!?P#g<2sY+n zu0K&Ke)D|i>$vgE9br{-L6~PwWOW>>m58W!8-vfg1J1Y=;-l%|O{}G8yb1R_FL?Yq^JP}DC(5UYNc5i&Q-?EI3oAkG1m<#WY6yEv{@WU|R zFRVD!8VbRjqbJS4Gf>~=1rcofcRQxN5Fd8RCT<6VdZzhO?IgJ^R1(!KPuP{WRC?=P zv8@H%6lDtkxP@r-n5!uxpn}?M&&O{<@vqTr15regG3(7?9gUfj&rhg~7|(5Ca~|*+ z&KaEk+b!*Ab8ik>Yc??gs_FlG;{4VUh=gBy0%a{;<0bwzn^}b)j`pGzUDv$~r7@@w zk_*%KKkK^5RD&!4I)I7s4PUm}0h6n}AKT`c3JXx%5Oz!bRpJ6_3mwdqnISi-=uOPD zIvX;Dy$R>Yvg(aVLQPY`G?Hn_qr4Ik>z4zyhxgYE$?)|h}M%j_8%>LjBTOv0_= zM1fp>%PPP)9+s5=K`@QeuT{L@SSmIbp_c$?vb8Z?o6rp4oh%%^fTEFFE(7a z)OQ6t(OlLbd>do|?ty*^3iE5-#3IPT<>D^Eqr;f%w7zj075(=&CI6Chbcyn)$j}lf zv*fv^`^CdD2gs{v8hNSH2X2g-e35v?)MnycIjKoF7lYi&;n!xZW*JPpOK=BCBvzls z*Q?xSs4;*WY&J*IgR|^Z24;q%%sLz@2@K3~)GjF0{x8qU{=4itMFXa&(V3 z*}7m;aJNCRG*D(`>Qg}z-XK9h^JQ&O%u*%&4phv3;k9ekm>5QFrs(D#otl*Sr-FQ;&NLN}Cyhx4l-S zQPoKTJzZj zlqMhnWA|vjXFaLMK}O!q?tqYW8^c%WXm+e{kHN?1>u+1W)vfmTdgs*Z7qXic{wi}S zi6}gw93(9RBCwot0##pqoO>YbpObda<&lHK+@&mQ8|JmQ$yz~DEIlj4a`jR;>K2?*pMs;dZ9x0=QG(1Z3WrT+Cabk(<;KqTb?v{%IQ3=9^v1|XPiDoXPb z3O>xV>TAwABHDcEs8=#KSK~mc<^~B^P4+y!1{sIt5>0SPfXksd)}y$o!WJT2pD7?k zt}<+m52G}P&c5cB!<0lNT^LK&6s0xOt~yrX@k0{RcW- zSjG?xi#UG@MeTtx4fwp@H}6E(3#hSghRiyPO3)u6ldQg$c`Y|S(T+X)^62kxQvte% zrDkV6FDyekDOr&MVJIm|se*y7BW})rtJ1g8KsP`N_8A#e#QnOrC9E`(WKNoClB4y3 z7zHeE2IM<(I)&y!!^Q#KU8|=badMXu8Y_12f z%ozoC1hyR6lp%`R&f=JC)U5>jcIT@J?n6muDs zX9qQyu1T~sm$>`;vSNg!1p5>PZwowgyeA2BOO37$I<;SSadNq^Ix$)aA1%mQE>~MF z9#bAbc>+;I=)1FGZDF?2$e3WNChad8l-O2Q;P5C1V%x1JG4S@k}em z+v3P*S6H)Q-G(f?d9y%uH`mMg7J{E?lLAjjk4^uaQQZ6C5!Wx3xHpfU3rMDa_7GzZ zST0<$Om-U%(?D#w4c}vB;jJAQG^djc%A16z*m1y%*5?MqMTezHYd~p5uW2sC0H-ly zHFgy+N7jJMKoj=F+L6UU;tDi@_a98P*OhyA+GuLPqy`KcJw}w(WVaxB>qbOQ0dm6r z0&2jkkwkW`OCmC8A(+{3>UR?p|D#esTZO&R)W0zpHJ=eNVt(diL-^rSpW{tz3wX+9 zW(1``p0AV3Oc)MVeuF8qeFo8)=Bq2HQaG34S1+1dEUkz?{t<)*1x1w!63>w|dWTVN zsCknJkrT9nFb2^M1-QC@WI;$c61|IVdP@oo=&*g6@AqN6@3xa6I8H>vJS=n0f4zxo zQ30Oh@wVN4%9cGpy`9o7sK#!L22G#o9Gc3mf5gLe1az}*KLlp+DwF`$nvX$U&7dma zmtolcf=(`f@ix(yTG}3?>YcpNz3uL@(h$<3xs`*(zP5_m-?v2nsC2eB@R)xyUUmUF z%w-{&nG>a+P%+OP^HpclFea!4>_cK3AX&Qw7ri4|m#|v%e}Ga9`QOg=tryCFh3#uH z!%WvxM2pFep2Wo(%`JB)%ug-0D?dnT)=eCi?=D&~~lK;JsfW zl9MaY4tP9mZv6=;jkWp%2d1r{lo%r|`lUGZS14;$Mh|t~lSmg_M&WVv1$Js1#~>_| zB8}n!O}2?~DTUdOV!vJ>>HzaQfdmL}n1-jj0?g0Z8lM-5i_)Fy*Nl9U9wYxlL{h*~@ORdc zmIir#jwNK!a(<*DJvh>imviD+Ul*9VaSfjhuUmC?e!ysTy~o(#I7=|oa}l&t)rv}H z3p#_acrvt|o&8VkRno?(b5DD5%3Drk*b8k=;(xQ>&#W`!u@X|3<7H0I&|^)L-T_%I zznP$nt8B->WR}t+agQ>xHGzGV3}0!0l3Ja=d1A*=bBiDZV|>;f7J1w=&aEQ!ZTLQ4CrTfgVV^EGh*kffCct2irF!vgofZin(SG6Q>}Cx zv7-k|VJ0nra79g%f(vU&AApK&h}8?3fZrOcN6!G{Ly~gK8%!a8&8Sk6dsbRpy?m^I zhs96^E!Q&IjR2;491D(m1qr~@UJrwVGs{_jr8pfvG^8IV-4Ml<7Jfhao}AL{CGpUC zl}9#_8;Q}sgf?qnUDg~I1DGdd(AY7+2XKalQ|M`$z&st|&j!sg39C1$ z&^?PUCMtuvH*rCmfHwsdOR-s=I+}sSl1S5-jjG&rd`8`L6)2@nUK0Hg(bm+6qKH{tkq(>lXJ)Z1|e0UyrI{o8m%z>B6Cl84l*>5DeMEYgun5e%0lc4Hbh6ejN{lFlD3I&~fIRW=~ zbXX{80N5!+_Zp3Au(P)QRobU@b5JO8V6V*ESl}4{zd@c+H)NApqPzf_K2jbof^9LH zX~sCC24+wX7#k68!Ba}hWYC)m`MW>~^yHFK7_A9PgN8Is7MQO#iIG;YVd?=2mOOEu zrFzCQmnS#dvhd6(4a*iRhVMmoY(R>=A!Bz`iA~YLmCzs7)fCO-RU~wAWnM! z$Z^~y6x;WRw;d^v{ldCl90;tVl z1LYb<-Z0vuQZmk8dCM=eGV3>E;TZo?;SJmv3*jU2~(YQIy3 zP$)~kW!UK25b*r$j&uR9D_Va_<-tJ7@h;?|)+thhu>Z10scDT^xkoIm!+^E;S7l#) z#r7@6^8IXDkqidWnOK{JN3-3s(^&M#Uwj<~^=U}@XSNp$O=7J&-w|_z%wQN$Nt7o0 zZhGXNDWMlygV?ye%6po5fnz+qSm)4yFFUfVwHGLz0RkZsc(DwiV_4qN;e_h6%AsqX3D>WnRVfEw%l?(ao0=Se zm%f!f*Jw0rl&crj6PmmZ!vvFl$l}`+Pm-KZh~cg4J)vpsNd|m6vo%x*UKYdwJ9DK4 zYvsr-0e4WnA!}8Tz=7qQG8YTn;2_692wRn{CVR?R1=I#zLsbEq^F^rlff(npD;Ngx z?**bc2Tw5P$O|g}B#t%ygsQq$==?zUU^+xQK}rKOgAO)oIoO2H7Nql^)dP`JYr|&L z#JJM^jY!Ds1#gCwTX(q-VZvS=1_KPdX0r45sURXvFQ~UGRee+Gq zrIR;h@#&cYlFLR{TqUF1la`EB3HAohUECsTt**N0K0EIr_NKkaK85^>%MWX}m>Qazlsw@@@!pV&rRB@?}U zEdHw|N>I>b_h!V-@3?qlP#SIs&_M?4m4D2qd5%~R5twh8<1 zg#&A}68cG-*!qUya3(?Ym_X}+`S;yt4bp*Le|E=u;W1j7+A>=Zh224| zLP8_wF?4P!9{A9@TOiCfOCaWov9ITY*kX@CbsLu&GGD zYvZf7!X#UR&LJGwlUCqKtaP=lBhj~40K3%{Ydi*dR%V97CgE5G+w`P1B7IL;mJ8Uu zs0S18*aY5gLY$8;KxZ{&MN7OFp#Nl5@Z~jnS6DRDZX2@gY(ZNI+cXW8cmfQ|T5S7T zY()Z6D;+D5wA>RIvuH{GDUg4sD?c)k+OD9NPU9|{4H<>c^p_+39%f&nUO9S~@w=Qj zc3a@xslk7MC2Qd4m1PW%1k{t!I4cQZU3tx zDcNls3&7Nn-jg3okM@W zI5N-^=BrSqf7wHm_fL4H4&~E3)mo9__>-davy|npc}bMl)w$8CUp%QTyHTIm?u6mM zRk;G>Y!>T*sqIAt_ZV><3boj@hW$&=p)R=$#Ijm1WEp@4-jh4$G(efMYZYniv!g-$kl?NiN~Rz?smUSE$Z6i zS3aUVLN=8WY|&GmNT##LvsO(&D0(j@>Y&Y{c;itCsR^;-VkGZ@%Cx5#RUeB|Q`-Wv zbr?esvxhSVKasAp`0Qk|Bxegx%ngqA)EAGqg{#CIJl_4q@A!Fa!4kU6$Si0bP$;@cVc7d>gmbPA9>@FDtrgb-?lr8 zyy0-6^s}(VtN!L1p1e2h_jtqf~ES;28s65ra`Np2>urDh?aHd$&Jqk88fvMhxoSV>#7kAkGIb zuhLUzOcSsffp<4K6)lGc@xUyAxX-p-Ej63LE-X51qIws`TQQ3+Ity*JI<)9gBzwgL z#P(kO(SK5RE5e6R?^!o3h^k=A$hLsfvVVGFs=a7Gg&$kew&58n^O@+IqI1XM5@WJT z%$=I<0cRKPABDMEW(Uh)X??~uwHu2$)w7?vOAsnj8@OmBb(vqi&=it|M9L^8f|Dvt zDNX#N#Baws2lOasg-MoPglJHe(`plcygNsAgQ+w=fNi|7hm?)cfh3mG@4YgMqqaT7 zys)E$12lp59lnKUVVmo;opSq(l^tQuV!&sf)0mJ9fSLl{Is-JHUyf&;a+XuFdL2Db zpA)UxW}|_e)`TTyAD!@GaoCm6MW6L=tI`Z>RPa-F7uvn{I*>E)|f+7e`^9Jy)^ zqW%#Mg++eIH0`qZ=DhpL0%j$xNY{u#SGx`TOJ^Mtz`vO5^^HB8H@n9L zAlRapfzy^pJ^+Ft>=(Eqmv=0<2*WWdjOGk#0qtHBJq{Fp=ZBDH33OBKFB>l*t9QhJ zm-drrdUUO7Y1uy|2WWK^!&yzeBSxcAn_rBfE7+dLM~))WZ%I8q@oc}znB`!r@&eO=6@}d3oZ))^5o!Rp zX9J(j5Xk>KPsRw~3I#Dnqxl%D>4J>Kt}i4(0t#uwuoS*?p330ly$p;uNH#wawg*n0 zOk6bb$TW(BaL5n#@CtKXMHt;84)`*09N0)~31E9;nw8pqI?WR!dr^xLFlN)d6k~UU zAGKH!TnhiLQ=f)*`zU<*2o)37!gj=H%v5l8e~^C7T7K91j{3ijMu@@GJACs7Yb2H_;prsk$Lhj5b!^{fwl>YL=P;BXUZ%<#`=S z_SL1Um2q5_}z-`BGE-rEOEwK%GQN)u>q z(PwHj%64&RZ3(5vt7^=iqh^-OhZe{->*?QXg0(dR;PHEesVk=k42p>~VO{^+JrI>P zb7gO%%!m12YeCs-o^C5Eb>-;4iSmE8a6Y2Y&mj4=lunH*7 z{NQlnk)YFQ5%yBFEA!GL?!6Fh;0nh?f_NR~@O0T}eb1|HZX38#2}-9vgOeynI40v? zSlw+`y;*hs%*mTC^_TtHYonHq=${SxwCI-=dgdVhy8o!YXq{IdxH=atVJ1l3XGjTm zQV*+i&#(HnkwuB*4%;pu^lBSZU9!^^D(k&1d2X!WH24cOBt{|t?;WRkO3P94m#e}0 zQZk7`?FS$4SKTKX5!Vm^iulOrWxr~KT^zX2HFOd0`Jpv%GO|mtCeJQxXHI}-Tjc|D z;&G2?<4Q3T!+jEbx@BcQ388pw-1zcVh8>5%&z)+p@R~72G$&2#`MHHyj?WT|+4aBtj5v~i(XIAF_#Q;mdLWU(-Q3l630(=ZKjrYy z`reA?ASaRDWVOfNdL`a=*!D2&UxHryx7;2fLL(n6iSmo3q!y15ipbc3d;;Rk$KsgK zsRP2v{wqT%tZgFJ#%Mmkoz9U+XZrUg!Sl{ZkXC;7OQ0D(WRO14=XIgs+gSYmk?CLM zEPde$iwd#*<#Gpt9yJKSw600obmooRXfGxoQSv+%+L_B2W`+&D>b&q;LlC3-W%=xZ zV}9-*qZ2n0%NZ!8<|~ zx0pt{!G?o}TEAR0IfvuTUws0-_)3x#*o3|F{TZ*w%2nPgF~=pon(!GO$SqB>PPixP zcbk&<=MeW530XK-az&hu>bIe!;@hE1UsK=CQE#{WgdYi1 zlB@K8h5r55KHCs{T0>%jR9-YT9^zJFKW1oiE#85WIASi5JnG7qT~57xg9^9L)Pm8t6I)Rt5;ZN!6)3f z?{(T!rpO&IGaP(@=IXcU!c$kKyM0Q|=!@LgIW; zJOvReiII~$#6FWc|Jl(>lBlL(cg{s>ySttw)l9IAEK6E`NfQH}I;W%|>V==2ya}6i zHaIq*xqNocBWt{t^kwnaq3ebIcuPU~FJYAZ2`(|*E&DfK+Kzu8GPXaEiJWjNiaWVE z(Rca3V!=Olnsv)j#n}IZ2wXb^G)b@Z#d-cMsn8aRH~M{BsTt*{r~J`>T89knHv?=; zV?4yH4|}A@v^dP_4F!<+e{pb8hKl|%1M`>rk{?D(Q_jS^1c~CMcBb_7HF>UGXpD5G zSiqxK!*`QEb*KIQun@CyX~1BD)m~f=rvF6l%wMs;o7GYqa5=^0|JCrStI&hHmgD)mQy+*Hp&o#jr#cbWVXz@c}qKS^j>;B!wv-()8gE400J^R+y^ddR%M zfh_CeA%yxB-F=a1Ywe}Ykk}`8eBk?o$ZzG&M_>V&X*!+*dY!RDeOVWGyeRF3ef3Xz zK0GO-TTyS>axw~h`AiEx6|NG0ntyPiH0ggM=Rd18Zs1sC?5oWMt3fkq{fz?teUy(S zIK_&}mP;St5`jF8TUMb5>rcG15TwNg{nnB9^k|QP7|mT5CY75DzEXMZTlSD?R6`R( zL=;8cBpq%SkKcDMcbGf*u)~!EFjrw{>77#Z^YM=j`h-YH3qvb+6sx{?ihXeX-s#X$?VV!*)7GxrQScVY^ts)@opInnfcNC_YwP znbh^h$iHn&ozx*`k619>4l9iaff2uD>QACRD=9WuD7g(M2UA8|ZdEsaD=T~-_e?93 z``y_t<4`bqXP_I`@4+=)7wi%H9hP(-q!P!O!7i8p1RNi3%1-Q z`dh9(?GDNA|3A*qKsyuBqE(k3ahc#gTY(LGH5JCp0;MzwLTXE%-ZgEBn1p~=&aqGG zT_Ch3Uk_en$X)j7tF|_4m!T*+w5W4>~ zqf|YDTwW0yvA~rM(Ok(ZUax1Ui`8-Uzv8Z6pveUH;4d$+t>2WzrG@57&La2!WX*XB~ zVw`;SQz6wM*lpAqr`yHNC+@oWD?1js--iD3OUwTwmS}|M#eIZd$sEDd%Poy-_=jpr z!R+e!5AGja;;YiNo;`{vtTba9be@0v#Xd3i=}vnrWbjj*=d@{OBE4Vd>M0vf3*zjL z&rh%?7CUcVcwHfRb~B%s-!UbE4=EjX-REvclS}5sw5LgaBz)Oi?Pjk+VD+ZG7IU{e zbE#Z8=A!GhKM(#-=}>+$!V{*Y9eK0->*BY9@ZZM%PFn^Lrc>42CHQD<`k8S4SDTM) zexFhKhWI;EN(4cfHuX0bl#lenC;vrkO-r7#=BrIk!(I7w*Xde5B3>gdMfCXoA8}gr zoM^w+VqX7)<64GozhyXk7Kp70Gon|k><2|Glj0MtJ(2r51=ZLuYArnGccz8(03~&f|h) zMaw9i{pI(BgLAVlHY%~tDY5VIf|tvPBRP|PYDex_^xd;MFZb42m)R$Z$a*C4$%HFT zJlM5Ki1guUfeP3YJF#q^UpXD)V_%oPJ5*60Z+ya7Bb_=^Opa6QGKPSEj6JaareW{n zmW5h~^s)-bg*Qy(?xWbFwTf3m7qm?V)(Sh-?P*QLWb5oyF(roisNb9>tRH{p8t)ZqJu%A~#X4Bt8@!o(h0L?K}3ezT>ky8JBC@#LaJXMwR4FGty zL(%7|Nx{EiJi`0TTH^LS^gd5N_W6iu9=c%&;W#S;*OjMR)EcGHTGGGRj_`>zT~uuo zO(rAG8J@dT`Sl3O@1qW-&nf5}Oit`zx`klzaavLI(Qq;>)!xbcd8b6`E#&E$LgRS;=7 z$}uR3;aNi;4F{hmqkq$cI|W=&xvLdEmNrG9Zli99x>HWWxdfr*iXWZEEAWdeL&LFr z?g5HjUev_mEh|B#8gai_!+=&8n>I&O!c=d>&Xouwt2`c7eQAZ;jQWq}57x;8^wObL zv6n;v*us^xF6X02GX&E~@Y41u;5GAM?EGB$;E6wv4yvCRE?{E;>)xNjdA-`(WAnX2 z6OV&j?OC>EPw!VXNvxSAXs=baOfHXrnQTkU!~B}H>I7y#h8#zk!IFi$S)U54ENK!6fmZR2gme8xzp;c%rUF~0bD7kYE=7gyyuKXnW&i!pJk-bUdD;1T zRz2RK6f<9$%H08Nj~G?`xsQv&gcjQYS?JVAD?9T5`>IEs5KXF@bpA52^~y@;Un?|) zn(>_u*pkG2AZ(Gf5L#Wkuz1 zPnjF7Ks-XU3ZY9h2%cw98Km;0&5wvCX&Gg<#pOYAmzs z(oF}ZEXrcdzaYfZ9GiHG6;2*?!Pq;HDXD>Dn#+>ga;V*G6kZ!3 z-Mw#PDSY*)?$+;l>FV%%7Yz%V6K7w0M;dJ07CQ$%sV2>D^A>aYkrh7W>m@uqHFdxx zNaF|B+4mi`X!EYwsZU3ij>w+_h2z!fVkaFCTum2k`D3ProhW_a-AeyANyFFqBcbBo&3ihhr zTs$NUItr(T!QAZ6D%N5Jh`T${aBU@dvE{>*Qw#Ry4gqa0Z-vKcxii&;i*t)!f9OK= z0${g*l2C!I6P1nX`<2O`IcqiBa)Su4x4Tw=vH9|fO9dh0D_Sr$z&fJC1+w|x z#|XK}CR0Uc_;eSqtM|xDTwVg*+NmK@^L;wyvpvrG6oe3KYUwRX6Q9G*D(rGQGwC>h ziKE2BL$k)19MtYC$r$nZ+gSKn6pJPNE7d{WVW-pjEe2S1NuP)On5&uacUpV7EHWPR z{(4(`s6?7Ci6X}s8o~n$__k!+!DA5){he{W>c=8tmV!>winS_iIN>9bRoQem)KCzA z)$*bn@~(_kT=9TGRb{3Edw*mMq-IpuR=t|5^+KG}>C8X+k_%?HV=N*R5rwh(3W=+x}C0(+Jqjd*|jcseq>*|Ry5q>ROnkVjTHXg zs_NCS?mOq}eY$Ux6~Z>keHw%q8rq092utK7b{WLzE5KFN*0S@J#uTj+c0}K_qPfuC zIt!Y(_hlAGCg)Dua4A@mdu;Rkz@0a;U*o|3 z`rWT|sz3Zxg|}v&()yyBk|`p&JQt6k=d>l7n0<3F@T}nZvhj#m8$8gH{h?A~F(*WP zysuvwO-8%K3=f|AsQ19$Gb5Hivr=FYzv~V?^YqPb0oa$>RUK0^oq|#?a!EjZqgPu( z?T_j@k_K*jYnY8m{`GBqnXWJTx1Du@(k@jJwtd1u?Oz=c+1Px$Kr`gThZGN1Qzdz2 z4jKniXdA?iE7?4p@ZM6WNOMV;G3{eY?!fa7GV}5sSqS^8n1TAbcPevPAeQUS4P?|k zt=)|6i%N)&J0CvJM0xH(<~;-R{X~+bUV4SiL%UqdlPtcW?)vq;wzXpAJ)IJ%S>G^XcRtIq|64(&z`RTPB{Od%9SwiLD&kxeL zbu@)}wW7NS$0`QjxCS|ziz{^o5|<&wLXZA)3Fh;>i?6+`(dlzkX@QC}7<;tBM0+hf ze#+C!H!Z*7rJ$C6l&*Raj*aj_3hu)Ke}d1V13z!PKb}AhyWHumyIg;zlZ}&A5e>1K za*~W9iYruLS)`h3;>xxy6l5xM8ek-0E;Ddv{XaU#*?XX?{Ydw$6sr%GW+%t?Hu~kj z_rDV^N%U?OGPt~ORvC2j0$UAN$+LI>c&&;%apG`H2iIXv&FQX(1*+MUXZRHy z&Ue^&CY-E2;oViyt9F!3QMz{3*<3@5Hsah>vZB`e?4?o|Ircz9A9~Fa6C2jZ4;?8i zwI(@i;)i=b#3jt|#PAvKGIoRsCSe3Z=bp|?PF<>}UyQv*ipI}9v_+VTC0`%v=m@IoQ(=R$;G_@#;By14r*l1jwg zM!_&M_Jy(fql@fKYfnu{&X*Y#=&}GA#GkaQ?#+HgL{O42V_wS-C8^ui9h^D?n~V$H z?eF22{i!zYLPU0LVgTkm%y;O$&(xGNi1A>dXMQN{cy=~~wKUh9WK#TH=chyFtMKCf zW2*2UScWoA4A>pUDz5*;iWaTu=N+%jnef69e#sb5i_9Us9Xe&bS2v<41t`{vmA^%T zCCz^R;-5_C$G?kSNnWEvhxrZcL>BdRZZsayR_wfaW}#BjpLpg8upoVy?R&OB%vSC$kXWygRE_* z+kn*J97}l^{qpVGH3_2$DqDr-!UFnye)mH5IQ)g@xYqkqGU#f9Y~ND!?a((%_yt|8 zc)&)_%Z(#a8AoS-?|ySOi)>W7r^p=q3d04~*R6(TUy>cvTgi(HedE@H(y0Mk+d)fT zph~QqqX*7u$-o9HcLN&{E1jLubuPUapXsE#Xx6-Mm&1>3MeQp{4DA(NK-*_3mHflL zHn-EkcVci(t*y>Cjh&q21fp2qF6S0Wjq9tPjd?w_|C81+Cxn5muuPn;(WRPX-NitYmglZ zi~4hDU9cfoe{)qli7l(UWK^P1ldR8TnUlZn`aegBY?OOgA)zc`R8dRpsDlGkafpB5 z=JsbGXWRjW&1|=28slf~ZvIc<;%Xt4ppd#r&Be8kUd1*QGy0ArOLGZgpIV5U>*?P5 zzUCg=nc7I;5I44jDVoCR0{(zXFp6EKW!!DMV=C!srtPuh$>w* zx883h{s8WNy!&;6-k^(h{IGq%EgQxcqGA_@QZwVa+@1$C@^!}ePT10}7CPMLJ;@-% zFMpPcN9H}7DND7t9FidC?Mmlo2YSROAqY6I-2?>%Qe+T4Frz(EDz%eHa@uieg-NZS?KsPIE2xAoY z*57}1+REgW3T^)W>1mqXbt`Pgb|u)+`FKNRT`&sZ)5&Buf|%D!p0VLm@dRAXkNRW{$nMJ$tHde zRH>_@ie6GI6}N(4XYJrn6QL>B$L$(+e(YX7rttT%K+8HNOsS-bV*rWK;L@s=kA$z9 zN6+OC`Eo~cBB>+P7Ji+L-8HtDR$@_p>}6E7PoFnPU0$L(W*`DwaEf#kf~tlL7ZUguT) z314o1k2u`OIbyjf;Z5+@z#-e*+?$8w#lEOo#5D(Nf3oa+-3gjY861_9r4NB&yw(|n zsd!r%1IN6@+aNR6teQ2v|J+2{`aN(!cUrcemmVNMRiCA(&s?ZzrL4LtJ&Kzg z)$l^k_Oy@Xi{=u(#9x0;FkgRQEyA4_o)7G-0|}3Mn$fRxw}5&|3Z-KsPMJuGujps@ z5Shk1>$@}$`TTZsja7c1UE}(N>84C0Y}oc4n_G|)2U3cIRRkBhj4Rkd!pmsBVp4rb zz2}rj#oYFf22vF@0Flu&Z)0U;L;mYeVZ%FLA1PyJa!Qwvw}j$kh(VJ>2F z;g?f0?5y=b_pNVz6%5;moa3XC7XPSWsChQ%BcYwMFW;>(*1S$OUbe@r>TheEOj>qz7uHMgl{Br^k54yD7fq z<9%e>L}M+~DW6A0XvX~6De7xIEP|)?tR~4&m$O`i}fa*RTY31dUzTwp#6NiPamN;bA z`L`I2QJb&Iukp+rifM`ZC@a;up*nm*FGk2M)zqQ0^WCq4i^1neO|lc`1V3eSx1M&4 zIs`k0IL~*i)3~GQ&UdHeR%6-Ouib~9sfwM{HVPqtb#$P-%JWZGN{RQ-ciqEQ$ZAUC zH~Q?7ozlUD#@OfXbJ>t9#ir(yA5g)~-FGUqaO?UBLX_vJKlhnJf0YfNc;aAj`PsLl zE4uac%J->WSJ*;LCY!GBTd}(Zy9;+J>lwdI(chef{_c% zu{`~X0AO~Lv;DqLt8D}HSEeU3jNb-jP)GgmCkRUl=#h}{dyYEo`eK!>sf%UX_I~lf zaply0l%(6sq;Kk6v)4#jij}bnK2df?h^dvyF8xcp=Vz@mjKuf4BVpihUvn~3!%7tDru%avWZGDd_5W@Eisv08@d0sC|p zhIsOBpjsJ7JhblIDA0Z;T~;g zKG(J|&cb_+FG2B#SJS22_X}{sXl?0xrv#KI-gnRYuyF;73@~fUd~EdDb|y~J`e-ec zJ03r;zJ5N+wot&jk8TYNvXT@XXtB`LJCbU?6mgS|p}EieMw?>Xt;eit-aVjvbHMnL zU@1lmJlR<8v5Zm`Db$7@2!Ep#`C~0ok~v9-Z}*88eh(R|NoJUB!seMWM*cMqq4I?8R6JTcD9Zcna4qPW?9)Y+d(+?-j2N; zgd-gLcYBZD_x=5h?_VAs4|QMn^}1g3dOn{wBheD;h`X82;UrUs64I-)LV7jNV6-Ti@MvV>5mc_lIIr+LWVS^!Yb zt+Q5!qf&j5B-y>Ucn7z-h=l$+TWeD@>7$~2Dttxvr-HB>(aA6`Ll)6q_)TLOlk*gr z%Vqt@0I4RpA3x{@407g8(z`r)oS6Q@S7z=fy|G6KCCsyM0&szM01^;n6zjy5x1b8G6eS%Jo+b{ zy+`N!k8dEB=`!t1ww*8S>g`A|`M2JAS|c;ev*^ z67uZ!p4J{O&lM=qHz_n8USPAwl9ZNGiZ$)JD4I-E3vWa4Dif@~DosKdlo#p6EaNG_ z1Bq?P>|6h0n=y=s!m7HRGNg}|kh?|FAd%TX-=gHg0P;|Z4hPW5xZSbTiJpYF9J14h zR*ObGxepDG7%g*;UZ^D57ZEsya}O|GO}N7!_k406A0Tkzw*4^dhRJ`m+UGEb7C$kjGR%G6t%C%Z1s zB@fYqbBlSpkYq}88p*i0r?Lc9ad}En+RM0v8+E#4&`i4=*p_Sa z3+!NRuQ829!B|ufb~`J2n(rhm-FdO<$#11XJ@ncta@5Mu6ILv}nM`6Lb^qGec66&_ zcTau3!#S*9{xNT3IIHP!ZJTZu!y!r(<12kn=_{N5%3kIM-7dif)%T?8hE<*l@Hdg| zFsHLs<%Y?v*~8i+ksmEXyXU`l;}t>ZXuB$&?wyNFT7LVpLAa4OQT7ckF?%0PW5F)F zzJ?YtxZdrdBZD7EZ`zww&c}EI8!A%8d&tA;l~tXF*)QfrMKT{dl&{@wX6|Y)Vtvq4 z2Q;jRa_{nNnFd^L$9Kjz-Pl-gmAz+hb|>b2;df{5>H~V6*P%UzFdJLqKmG5Z>j%c? zCRomW_~KWvUhuS=#{kwc$LQt7T`KpV@kxXV5B&FW18ON>3d~)&8#U{_y3f88CQwYE zO3m08^St;pjJrK@X}D7*+44}J=}9oALi$RZq};Yw_PdP^l#>H0duNHmv|TTNgPkM~ z3%rWm5^FAL*Ihqc=tCEBCpi*bNOdrCw^}RH#;|)pxDQVMZd7b-{R>JyT{9s5++056 zqH3MM<=Zn*40>i=id`qJdXy3jMh~V{wouG}f1aewlx`4O@OmJR@3q7wW;xj@^gcuT z`j^H}r1~2%hx(GB9u{I8gwKshftR)57zadaEr$Q?aLI-JCO3FLj0cY2)AMP%ji++o zt@p^ej<0Zl2Qe^yuH$X6=P*{yt5TTKnEm53AOG6X$x*j01V%^i_hb&%S1TWOrXpkF zXN1&P9%7IdwODgVltyrGzo zsB1uG%$qk5Vi)AEaMLnG;l&$C0KY_&3zG_L=uCl4X(E+eDd_h;3$}z|KVy&4@fTQi zvL4Zw;hg~Oo~)JzI0QKjUd3{am{MvOQ+-eUmbv=V*y!~UWF6Vl?_RfDN>hintJ@B? zyq;vy!M)mJec^sYzf2YJqG>t#=JGF%9OvrF(Wbkcl8j=9grUWV;O|n`Fb4CclbP}f zR3p*A?Oupgt%PWpFQViUS9EOB_^**x1zqEAYS5n9RyoyN(N_DB!^Qm7#e7e&0bjSo zVj%gg>QZ!s8Wv7LC}ZJ3UHdMsbHT<3)ImIyX-7F(^TS(j0g{1x%*X9@T(?R?SWDkX zEj={cFY0NSTyHsCHH2Et=jlGFZI7p9$|Hs%xzqNrZ%2x+C6>Q0Y5X$K^WmyW4$oQV%`L}3!^vB>c-fzBtW-A^>DN|zN7k7gE!3g<4;rvWNG1%DCdQFV zEQHX!<%q$3(IvxnA~>e-F1paxIoT=8)L%f5uc&%1&6uy@x!;6LKDSkML3%n46y7vf z%;+!O9PZtFkoy(=W>3z5ur?qIm_?{9cB)-pb*&;$N~ zj*k0T(yMtIJWczwO-vs=jl6$d1_Q{Q++O!O{T6(a17h=mP5Pjyli>vTD1^6%E6sSV zzDDY-mup87h5Ui!Bc{cL4he4y+;Wg~8zp0eX(Mi6u~sK3h7IHc7Y$zY$s6YKX%~`r z%_;b<%&r#fdKnA2NA7k=JxERD9i1E|p*nch+Ejd>jM>R)dGQd3${}q%Mr)t!CMHcM zUDQWu)qmRD7H665(TT%PGAcJOanp)C`)6cWe0%!6V}}QLipQXCL2XnBL z(4BneL%q81x*>ayx!qJNm2H4E@fEgxc9k=L_PiQz+*h-_@;ZbhcprViLAZF<&C3?B zG`H2{h=N_!YR}=vJltTAv*gsER~>(`34mT9t;m1<_ zJ=x6szeGHDSA!2TvCQX;TacfYk?mt6>f+YuaVNhmexdDMK&k1zNWq*PBUa9g0OjuM z=3fV>TaV{=gQgc^B|z(y`8b9;nalDwr{`WdP_Bzug$`^%Hp7i8#khA|1>|zVx7@Rg zsdUnd*5i+l+HWC)un}lC6=cWT5A$1WpEZAp*;7^#aS`k zFg^U(roHuv@GWnLFuL`Z!G)iIvyh+H*-z}#da`9?dc(@YzM06QBPsx}QR)yD!KHWQoO;AMO!GwL`P2GBs!c`J7PEqDZb!4kYvHRA{;E7az3GpnR~BiObsa;H4iEd_ z&TG_=zHU>1XQw*l+$i_AAGv+T%L5N)$I^qoWL+j-`s|14Ug}@Ngi_xnFJIB}iB}l9 zqYA9xR@?bb+itz)4%0;lAx{yVZ~$F&|H3P>{EV=K6F>!7j7UxR&cn~oR)Kq0`?U{< z(_pjZiJm5^CRF-7pHIh7$)n>b-?j1f+EcN4w7|@PosHu70M~5Sp-vMKs;Dp^WIw=) zmhterqN^S4w%RgFbOQpzJ^-WRzR_sI6YjZ_jI^iCRPdvnn(oi# zb?`z44M0XrKevvNpJAQK?uI#UHv|s1YqO9Nbo&M0|N zwxB^n*p|Z63!sA>BcaL+uD!>7R_Jq_DLJ!vr!RbW2{XxHPEK_kZc-IN>wgsc-cXve z+LgIkYQYx;j37?#5fPIxVsnZW4MzIkz zI{whPTM^76&4v9;=Io0BZv#l4sL*;%;&!8g)4BIjq82OY!7eX?JkB0fYt5e}o(Xw< z=@vgnUc-@G*_#^a+%|ahWJ|uhdt#>g8aqEVschV0s|j`X>AsPnPQ%`b<>oS;@4$P7 zmW7!=@JRoIhH!t-V)eT$nFeBhgJQlW&(N`d%<|YAtQ9}E7&=?iQT*XbJe{`$(}L{A zR@|Q79;Ck-731(3lkqt-PIvb7yf8A>OLJ=L4flFkHmUtHMd*smSkYP!HeTox=VmB^qP(_(q)dLq;Ragj!`uey0aHj}?Uv0P6F2DOIQh2@c{uMQ#p}bSw z3fq$XARqavyeV%${wUMFTJvCriF_H{=3K*9lp!!|Jh2|6Tl9MD<^E?Ow)vUYy$)Pu zsIHw&zPxg$Py3CBN0#<1@gWmdpo`75s?8e4J9z|#0O^uU;;FfybLw}=qz~l9MbAx028db zESocG-kIK)HnThsXfm{1rCIU>qC0 z3-q>xi003*OLkPn_>NPU*!vISXD8EbbgUbt}YX zL7YTbz)@*t=D zBc**S<;HJKwZy8K%xI2}FGHLNI&9e^Xr-tW6&NJ*MmGHL!P5@_*)K|bHt=!7L}PMQ zkTvXT+;^kZ^5RV9#hrTji^9(Gx@V(wo`=RIETx-17m8l3LGKsao49(?Pkxu5=V>Hm zvd^|pTrFIz0ve0;AcuzXV%uGb)d{s5=jN1jSE%RvH`j|e>t~lqdeHTt%zA(EarmJX zBbUSZ{#mzA!7;Z=!mBGhfA@1U^K48|#A?_OUWceR!(Gjj5p`;H#$aQPn*x^^xo}w19-Eo2Q{8463_CVdq@jTcDKL0s zs{Q*xPogB3T6eJKj(Qm5750s`^aPiEW|(G(^UZ;v8*&(8u`cy5HKaZ4@30oQbqe3w z1EL4s#YaKF?UOeRBSt}}%2WTPVcypIjj~01qF?XD_L^@b_Z_&)h$BM;*1>E%nRgx9 z;PBJi1a<-6?d$%W+s~BalPMyI=WzR+2Qu5fCN~A3Fm}|sSZn8C!;onm#Jy95L*!M1 zsGr`>D?Tg+z2iowqfbxEx{sjErDPkzJd8S^lPY^$Diu9}H~k24N@&NqBD9kZ=6q*0 zgfi7UDNI{=h>%YX6rUG>pIS9l-1j!U!A(*E8$n_Fg!3nk_Q4Q=r^s}a`IA@TX!Pgj z5*D2EA0d?gEfbNXQ$2`LHo_}4EpF3W0%@(L4i7bQmeY2L}~_A%V;+Nnt=jIA=-$+hjI z{ys6k+82yZqsS(QSonbfBqRUa&~oy{0D&zDnPXkO^lwYW?Hh@(YOMpUHlS88!$yQ> z#5H8ZA0_6h^@h^fk?KW%vnvD zsieh=V|rV0L1hk>H!qQ@6-n=x&OL9H?(No?YK0=_nog1He%wKe;<2EGpU0K^HvX(f z+V}L_)p^_a8eD?qP|RKWC$!k%1pF7axU(&dlVKD;O?>V@z>1BSkgi^Fw#yN#IftV0 zu3Mt9+~eDZ@v|r<%grJNP?=R2{z=EVCu8_NJ!q``K%Cm0` zohZxrlEHUUwmQ!$?5zEPzf;qO?QE5@YF)KG$*`A#$r-Gf6*dI0Z;nBq8+!D^1rYR;2RH6Ve)uz2$115QmFT{MTV>!-&blf zI@ur4o6|fP=8&UT_|E=Atpk`DL`jKhDDL1MZkSdOTg5Vs!Chl(%ECRF+Or^go^K^)09xPWi6 z@y`hyr*0p@$bnWHdE`Lce+DR52v=)Wm~AuLoRJX=0C4qfMR9vG#Zp$OvOWoIf8IPV zhhvr&*W^oTj6g4&V7TjGh(72?7L`9a1TrG3tCQzsNKm*!jugK_y` z;OR#}kaJutz+19q1cr7Ec2}^4x)D?lwWmJk0980syQi4~2DiyfaeA^XsF=<`2cJ_< ziyrk=o%$O=dYv*$dikiRLpGxHx$@L^ZGTIxI8!52?A&7e<5o?a z*I53mKBC7hUVi5MY?w&5t!7_R*Kuw9x5C**y);j&q^h)aWX>lu?x@o2j39!fcYx(6 zkOkf)?#d9Le_DIzvldCTRi+V3AqGVUD4fiq-9Cz-vmpI>*oeazY|-%n(mu(DKa-A0 z9ZK-tPfUS*r?z$fL1ZDK_op5$9gH8DV`au-fL3b-5Hg|KBR^^(n?H|g;^E)=9G&?n zU61^760Zp>QDmn%lUFOW0dxPN?=j-zAjhbXPKVtHb;OHEXR2J{Z>o}(TB(n*vbtjw zI^x1523y0N4xszqk#@GdTTOBzz?RU;Y%4=l4n? z@m)vG+uLWaQJeEKOy0TOW!Jwl)g1h&_j7P_MfxiX7zeuN5#l|5^$)UbY3sF_sxD#zuHc7#4kGC`OVsAwcRlwWU^FsR zXkBC5KbbsrWCKP*vEDw3UVE&kN>ihX@~q}G%(y*&~}2bjiOZVmp#GL4nEovfJD ze2-yz%8}q%SwEL-*zG*2y{(L$jZKA_us(O_fb{Xqd!S*^F*smeM>Bx8UPTZOU5^vaARpkgTdcJ*t)Pc2CKjZV8Hj z44&1+<)TrnqQEwR)1CGS7QL#c9uwYo9SwWRC;m?-=zPU z_>3x&8@@MGjDrzEy(_;%09o{BG+G(MPOmGPV6a3-RckT2&+NyX!JL@m*s4zcg`j&K zm#ZXp)J&v0E{3t}v+1!aq|9&guj#x~N+IYc|DeTgpEW1wx&NSnOyjfeeXrUdH0K2A zxRKS`F}X(6-K3l%v37IMBObr}_J|8=iROw*cg&+B}ut@qEfTx)1$Is3@F>&;%oN1fNExU=N52t zVA;&WiAy4vnlUkEj(jUx($J53aN5P;fnaiV#is1v(^-coFX40W*pPZA$p>_k3(2rzNz|vt3W)CvyElasI4KM4ZLtS zj-DfEQDZ6sBdemQ%(?FvekICj%WL=)NZ|jRIVTbH-s#~}rz<%2JJ!hZ(}^O3iJ9l#+xs0h%p?CoA_RUlxkILh zWh;cg%Y{gc`F)2~%06Sw6MxdMY^hpZvWO0V@b*1!_L0=f;EFm-CL+emC?sT++%0XUF<;apPti_4p&?GH`DBf^gnA~i*X>Re9_DsTAR z@I+t+Wl4BG{HnDI*lqT}dZ{&yOvaF&E2UAWQuQn;S}9)Hc`qowl9-o%?WRq6RA|>AUGnmHni1K`_0=szq#?ma3u7&-Z;~sR`v0} zucubgB&~EPg)W)mS8@z__$!a$mZV^MthijCi>*|Hy!OuvT_K#%x!Z6Z{o<4J`?LOo!OF=J@ok0J@tw!#Ss(|LiG;gY^)H)0bWgx_uH#=k zpYfcDf|L1;XWV`dDJ6&5@Up;n_daqy)b-|!$yL)wahwsdqssgleuv5DMOva$t)Qmg zaGp|WcIFoa6?IVIlI(Og7m(?CjmbYx73^keWdo|%ZY(Pizx{nmDrAmo&cB%p+HAqh zZwjm__sxr+DWkT=KM&|*fo1I%jV_6mX3)yq(Ho**;D3;zb2$m4+xckfQAm!-SFsJ3 zqHREpf-Db3T>-%?j2v~)gPX!~VQ4)KdP{79=Qq1Ip0Eclf3(y_m3>ls+Zsen%vhJP zfj=*>=B#%1tKLD;sx|gM9iQuCJtU9i_+d3pS7d++pzHo3{&hq0BXN5Kj-fv{X1IY< zaI_+nz6FXR(;nuHUy(OnP{-uS-rpg0jcv(ydX-ewUo`p=92cWC!LP>sj7ec-%+!-- zM4dh>ptD?`PbmjV2N_~Gv;|hp5AQMh^|`qw^zCKO|D^E0{ap|zToh-azM@~kX8bY2 zMADBlaexA%M4dqttr)L%u0&63xst_UmFf}mQo1TsGI|7LhqCr7iy+f)4HO&{+L2I@ z#*G@|xAfpwxHa@94D1s9TJe?)t%aoZC~#70<4$XqVOtyaxM<^l6fys>&!aj5zncJT zZWowlUbmlqe6D2NI6*D3#dITtSOr7{3(rJW+Cs9(k`=rGzOt;*I4$d{HNN{7-n@Cj zxksI!LW%Jx62ApX(Xyrk0(p|p4OTQ2@R1Fp^5owjKL??EQ~#S3%Z9TDZZB{s~CXWyYY@< zrRm=t<=O^%E@W8TKFhT896+4sl`>bQrrTiq6>jOlin>`fs*lH*-{aN2r2ACVZZe~& zFS3{bYVFW{DB1Gr4IV{iARYl582YeTp3t>;Z^fa29~3x}c=BpJV4| ztdyb*e3C$RCC?_IJ#n-r!23`%-R2o5Z5+X5$WmgkVy>py`uFg|6;}$<2q!JOPL2Gu z#9Va)(HTcs@#7h1=k`QKmj96cItd=339!ITmxm<@tpJ&RyR3tOo)n5Sku77^Bd1fk z<$r_4F`H*RoV_T(SRd6HplKwoz~GHGP#~e$8Spx}_gv`C$;(1-)eEBbDksW8@S(*U& zl|%L%!0Dyg+vMT}E4)x)m|qKAHAtE)({*T)IZ$|_S z)4T-5!rU?GeT;x~P(9(o!@cqsU_!A9Fk$I|r`z&JyBwYy$fSv+d%T3&NFJ)74AKGM z-OU<~pr=gDc{o{q`l&g6>g`t1iwAb&sL*B_+Suq%1O46M4NswK<`>zps!4_(4%``q(TGRybM`XGLFl_)92LZ~YKSHwzcay||>CL2FDr1kuPlQlHC9VII9`#nputIze3ygujrxB;Y}o zd&*mHGRbM41i5wFf*#+V%$`#-+K6y*0wt; zFE{=bkIC&{=Bs*7h|>KMB(O^+H3#1{>P5r2x$PhRNEJb&G(pq4>a=|Zd78J$wE+D3x^KSjTF-zmJv6`4iyy#c~0N)oc^Kc z(1W^U?rB9cMq!5duYxPd~Qh? zRat3I+Y6QdQFQt6a8-wx>mII6%1f=ua%)IXVqFz9Xe^JIj)kO!yk~{UViIFG0tBRq zLMr4q|Nm7T*&-4g2rXKCfNT<^TEBX;c+ZdNX5FlXtu_f}NCLfKCQMzf3NI@IWRUPe zhyC8`I(D@_@RP^7JM)G8)g5}?;8sQb7q=tpl$=NnNFlb9;YZfXI`2ReZ9UboxuE}8 zkN|Q-#<E7!JyFD%g+p?V+OujbJ$g-1 z*S(DU=`@eJ4f3#oSAH6hW!gQS`NZeRBg+%p%t8-z5>?m&g-GhYEOdbz)d1mwVTCeiWZX(_`gw{w8X?N%EB6`G`&Yd`K-+|iBnC~ zriWxx%OmXk1Qe`C{Y)qkL3uO^;+_Pb0Ld~`w7hPiHedOQwQjl{8EIw!vN8{NcQD-b zCn38FoubBd)Y-e5swem83PVHAtvY4GHZnNE%I}amwRlH_(mZ+kbcURKqNd%uCx;Dz zt2T2iw`{Lu2K_=6!@>0pG5hGQE`_KY=~GK`GPDZjxO$;>^!M-7TKBd7onJ}E7Z7#b zF$0IjSL>Ug+%54RDbF%UIdE_J|Id#^Y1}>WWQU!K0T2-jqJ~}z)r{Rr-@cjE9!IQ5 z;U2Zo9>WJ);8NM>AX#*r~O*(azCwZZ;(-5+d}c)Bw|@-gR&BkTW9D|}C$Ht_H}f&zKv8xxR;mIG zkj(!4S%lB;wACsECQ9~>eo2~+r#A)8rzcD=2>$nvUJ4w{*S_kbS@-$Hce?ejlb=V- zF9x!HzwGrN?{Bh3+Dus_Fy}lV z9c*K?^}5I#10FvNQdtTK4Q33g93D|7l67g1>uK>EkTy?8=RF1mqLm<(jzY{I#DCIS zay>JXeV3`NmrW-3O8jR~mL^jfp|*NrK%+ul`W|IE(@5roGEYN?80d@Be|dd69FN%! znah3C**NVyCy)daEcDPtj3ektOkA0@&uuy9SYA}RWPA9 zf3Q>$)eXH|6^Zj|zzU$a_g;N{q4Vj4ZWz|O#bcVn#iifUPy0jnBF@)vvsSY&ry)el z5C7A_!^f#fpAgnJhxFNiE21@dI*7@%8wS7g_Oq+S5+-C3F+v%Pvz*&BlmtFB#6B25 z51!{rm)L0AAAthJd>;_1-92yRvG#w038_C^;`*u~VR`y~=%Fn_H{MFIWbr)vj_I8U za;s%&L~g3vYdbh4DfgrQ*>BeHrSca%OE>vKZ0C87rS( z%M=!o;Uzh#XA|rDt%@`WQeJ^#>^Uj2Uy8_J%-#V`v269?&DIh1MMLthq&*mwC2 zAybvFUmV{1a~-{paV8q3`DZNWuW0RSj`FYiJwfU3KKvbHNO2u&8;ZL^1klQg_d+%} z=;^&X3-}FV)6}-jMv%uRWicgbj{R^t=``xJo_He`1XEe8MM}eP9xE*7*UpM?FiSmD zF!*+bRr32X%DbLJdAS-^5!X|Zs)bC-FH87Z=VcB?`^_d{ec$tm{tV((*towuW0*UT z%@caLe}%e1CO>>1K<0=32vF=fVlbzRRHp(biAnP&LhM(VDi*`hS^MLYhpVkBvOy;= zM0^6}zC-ZLHt!AJH*{?I-b;xqeADZ$&1r>#9D7<{<;IedR9r5zwUs^sxr4F_>8ZsC!=<`}`j!H)k8*zR`wzX{ zznP$#ht9A1GfS8x%PmY#Pz9aA6e6l~FuoCw?rHdZ`YVj+s@4zw~mO7yJl{ zYV#Q0`tp-R7QDE*H$Pf()lRaBVYa=SpzbMhqJAo9J0?GImaDCBvWHxo-})lthkcjs zMv}D)O<-FNj^`apCo1ONc<|~SO9F3nV0Rv$lV#QoJn3|i`EqVyGdknG#aPgs>-mOq z`z!Bo&L7|MdH#$elkudb28XToO|BtjSK7nDm(DT2oVH!P8>;g>{_p`L4Gz<*{({JL zsZGa>m5AW7f;}$W1=ks;jv~=GiL5xve&utqQO;2|J86Ih$Jy_wi;L2s&Y5qXUY3jlm!*9vefP*bI1+f9X z0%ER8`>4J3hAGMyKdYGn?fJA@x1>6VT|`nOg0fv4chvBE;!dj(~Lt z|0mfu;u+}{1x)C`Mrq{bg6tRKvr#_vC1bcSB1da}nc?{D=^Os`$Oy9K)?;Zau?4>y zIg@qyb$^`;9Wu;Ob(1s%vqJl5x*?7YadB07rEM|!)!ei(VHpL8XFX##8wz@*@TUbh zaTp%dIb8nEm7#CoWIrBEV+~-lu$BB|y=1-Yt^hrr`>+dygiS}#m4LO;dZ64$D3`Ebg)ac_+6&#CD9`+$6yLnOjE(+pF^Yr}1l3vK*+RDpfL%!~J zFSZc}valin;D1YY$X07iAA{W&0Nb?{!2k4gVqBdVs`W^jtETveCmPqIwCP_NNW5>Z z_x?E4g}gYwvSlzWBsA;-MBgI>!OAmx>7NTo_tKq#@l;jb=oEw~;o!+VhuZ>{`1Ov@ zo!owR9T>+$Jem3zv(a>mIgl0K(&NlR>ybQ}!%_#=RAAI=*QST3{Qa9)_PQZ9<*?-B zAiJ@lrzzTCEsk-&58s$|pL97ka`##jHG+!KYvU`CtI?)C*Hg0Pyk>CRA0eLqn4s{U zK>td+;OgCq)L4>w{{Q=kF=oWcz@dpgWVX)rrq7?*uvzEH zLaesBH67x&i6KH05b~&r${W25D0VHf;c--%;aIun)Q(R!;WU%tSt*$N+OqL+WzOo+Uv z{P_bd+?TFsalpcO()n}iOO)}IhCbsq^x0dd=F6`iYoxw5kQ$hF6KM0AI;5WmGA;hx z2)vV0F=oy6Bgp!#Ud8RDNa1fUY@b21LlLB#FJnE7+1zZGBqiKXYT}nsRyLWo@KtF9 zI)_IdntMU~^5T!f-^-3uAP>E0^7_7g$Ha`hbv0$9|hC{eE!BX&`AOPy?=4paH_M& z!}(f3&HeU7{oG*{@gC~YA9haE#J#R5h%+bVt2Te?A4p`X8I8SJjGHrWm;itHF>zz* zBQ?*R-H{B(XHvso4Qnixo_#dnN*4TGrl|mTIX_Sgu0;`cT+`fZ zTIqu%=TG{HPK)SI&evsRAe$=2?Hm7&Q`C^#@){82TxCQ?nEhK|jBv>_^rjw^v! zVz#YhkP=%OkR@^hMIUGHSGAigCO3EkJSKpDfh-8gng2HR7TZ3U>UdWmr$<5)!3Z$M1Mk z7A70Axn!t+G|ZWfm&IVJ06S4iN{ND4HgsTsnJ{fbvGu*Iko`vxqOqVq4>*bc7%M`7 z&)%&f`N!4biR`;7gTh^O#Hl59u#GS<%pTsT3q@S;RBq4EmgpX;QKWkj1 zEb(an=wqXpwhy%u!htS8@nHAz>o0a3WX_L$uiRCxkWCjz$HAxgJS%qUE0%m8ruJsm zLDiJP^{ql9pHJkmtWMTMo2K4uj;7tw^^WwI=>Q#-RUsyYBktezSbb`SVPmExoWJd^ znkIA>1wMkX(VxK^Jbv58bx1b$=t(jYxkA&pN~#f5(Zrm@WqqNY;m#s-&MO)pL93td ze=d+pMPoma*cTE!>|%k`nWi`)s9UeE6j42ds@#wMEjB3d`J68^l2q4?6|K>hQrlik z05@O?YYjZ+<{w$F4rHzl9CIaSt-)oLDxzet=Hgr}P`BG$Q^roDwgz*HB20dH^%;LF4L@n)eTtDB)Km3-3 zA!}&uE3*7|+hl9vmhsgot@NxfCfN5ai_NLewU`$EMEgkkpAHS?-KbStDR=7;xLezqJ6wALKou zb5dL7OcvZ8F>yNare6w-5LC`(_}coC=HMuTs>7XIEIX1Jp^XFovv@V>zfPhMVBUSF zx^c&Dovv)k8ZK(_zD*1F_zBiApqIORPh|d9aN9-H6sQPS z`m2WF>l9wE6iv?t{?kdq4}$b}>CB)8IX+eUOmnENH3LBo{%r~^eFccN9$2n5>lGUV zqlja!|I9Wk}xWIMs*e1v8b|A^Vk0{`pOR)P*Nl7%rg|1fZw&^ zlaV-G89IpJkNB*iRW0MuR-*ttD0->)*Qg=#y10X5mcnTT;IljSqLKW47Rk}2N3*Rk~om4U2bq9j!o8xOST%geP8SI@j;I{QT zAhvf5fNv-)C#yioM3WsicbUQfL5HUL7Xvv8Q0YVupre_{vF4?qk-r1NECj8ZN$P(n z>fgP(+$Grs^t_RUik7aijK4GRiTQj_dXVm>x!e1F)t7rDSEZ{+)*jeyW1{rQxBHE6 zF$GPh1>?qQX}cH2?u}b}Kt2Sn#Oafn0n^BwRmjlJov(>j2Q%#F9bEYV(pY2bPZ6xZ z<+Ss(_~kVN_NO??{LKDh+%|Ttlp)@(tNVe8vq)Qwh*teA4LUyUyjjT$A6ZrMqhrn{ zZA&^!HK@OVN?U_?r*&} zukXdjF&}1@8SHQ^IIYk&O-D9%$M34ZedM3RYnY{Sj2Jvuq9b0Yp@W4kJABVOyh;SZ zQeBG)Cd|-*>{4IHhSqbzE7bm#6-TU7zE>B) zR%sGySeM?NTA*W}O0eG~pb(fN<%aaH8TgcVn)o4^vSE%-+?JHyVKN}6drH6*yrD!O zFo}^FnkwcC*-t;6YWKArx8M?%@3ezbII=J;pSa{bY3F)Qg$%Tn4V)U1T#`KOB6lbK zYAqO2*2nGje)e|Go@SfJtqk3`KT0dx8^ANu2Ke?HcfB2u7Ajj2@0gWT$XI-?g+h`y z4d&4Ci`70`)vu*+g+ZjbxzanHon$~CNYZo!zB52wYpogzONvP6wPz3SgRS7&L9=|*&9ISPlC4ecABw;R)`17JUq zQw!D!ElKa^ne+S;)idt%-n8}?3MNTxJ9G;-BkKX54REKpnw`HeLUQn|SHCpd9@7R& zj;7hL&0Lx|#m18Bc9Y{@#oiI1K?b?bA;;W20eL!fx5H=$}mK)@>eN zKyIN#EK4cDzquHP3)8MYlq5~IaWGZU)1r$ylq36pbe(5hQ`@%oEhwNOL{K^iK@gFq z5Q+g5kRnY$L0ae_(t8b9sFKioC>wzwBE8p0Zvs-J7wLo^I)T8uqI;iv&VA4QBA@(; zYpyltn9q3r&k)Sd8GKUN_`9gP^3GHCuV5V1*ScwI3CLBvXd-jEZ-3_I0i^L1Wm01e z<#!ut>mA;49FVvIT%#4o8w_Dzua~QFMWUlw$bcjwVc#a^IctZ7k=&=@e1q|ApM=Fw zGPY_oFN1!&_se51*6oO(Yv{3+_@`eT<(l^f5N6)JTN;^Mtz*?i+ArumD{dv(^aK}? zlDP$O%Co|Ew@^UtC2wjtv55ZA=k(r4mr>OwY5yu_>nd+OASP63^CtphIkKHkfm3th z#ayN%u&J-V6TV<~&vi)M>4JPgR_Apb;q$gh^N80h;zEI5MLq%2I*gK9;8wHJ#QkjO z1qKA!^fer3mQWLT?HofP3sT_iZlhfs5Exag0*+^qY8!b`>G}Jc5J~>QV2Ux{r0A*n z;5-m8RdnR5Nvlc zN4Hioypv}sLMu+<#(h3zPe@31&mmQyD4;9@s{ONnRQsKek3n-sCyNL?LkNdBMrm^J z`)9OON3#O^dlj$uZ>rabR|fQ^)Gi!R{OTee$iw$A9@`OYV;Uf18t?U4d}zyHZ>V|# z6jp{o#O}HZA?@rat%-TlqwUt_s_+$wkZ)6j4R?EAd#?c$pAE~<75n)Nu2x1tYaPOo z-E~1XJ~>knNY><-7sqZeIE?PsQ|0h|fww<87~|FbD%aWVO1?PuSJDZx90;cF*Xfny zVNjAnsFvWOAP`W$5t10ew$ZS?00%~p)auug%L984rLXB}7KZ3tM5Dq(olEvdg?4ey zOci;%+f;W=YT01E2X0yWZ`&`{ZqiQWP_`yPfLh z6)tF!?9}b?j8!<+>)AK$vOiZjG2p9O+PS)>_&rE+H+^QSiPEq?#Am}fP49NT-xjIg z4@j3rA=l@juKmr;b!PC>AvA+ZkM$?~WKkX87uIxT9mY6|v2vCAL3xb=bw)VPOr^)q zLEyrgKNMLuzNcX();x0e&=jEF7u~9w>Daz6i)>pr6)Vm@`Ow`1jF`_u(K&|KrC^YQ zYB#|7aiXx(Dh zGUR>uZSQk3+k`J4dX0WQsG;=U_W|w_)4!M=MSrxrOx!U@DAKwZOb_l^)%JoKQ66MG zQ*<{%4~k5wdlEc+a$>{$mAg#&IksDlg~qRqv|5&Q1sA<%E8?bO|59WX;SshRlM!m_ zCBNph?P7Cexys3<%D+ZlT)b;16zm9SZWOV9H#NWW{C<$A<5kS*>P%m_uZuO*X%Dz{ zxhry+bQa{4H}ic1KwB!hno@QFyh3!dxXEgWqTC^Zlh5^IiPKQFMRfk4_1LCK4G0{I zCSjZzWiqjm;m@cF4auov3+lSl8XQ#C&;``A4w8xjWvH@V{WeF>!a!TTd6;D8=+^Y`&$j3`4C7t%i+PF&qyteoG|fv)*5?z15XM{eB3pWqA zWV!T-xVdhPa+X^W+7Th6aqQ7vZeWSEe+Zl&>D!3n14_^&x1XW~zZtaz`5k-f&Jo2*#_j0#%Z=vv5@szCPL`GN*PZTmoy8zs zS$}`JP3_cZS8_3#Mxc!%%ZoQX(5#XFrUr987G z9L8f#7AVj_x@+rJgM){ma<7;!unfOb$2)M{GN{0-XBa3nd*-8}b4`KP_R_xz}Ij$Xq zN|Mlqzkr;)Y?svUhigNRfSEyJj>DPd{?T8oyI<$EEO5*AS$+%;4ZY`uR8Fkdcah!) z?XN8lI2>7huB;tVT#^8OgM<26=dvdD)?B2=Pwn5zYWX|j5kO#J#s3Jpz6o55$H`v> z9rw7`J7;hWgx@+qJ?5r)e{ZUwDmH8vWe*HrpnOx{5H(z|L;%j`!YQ&hoqV^@Q=WHP zdw8th?vX!qsvkMp$NTQ&wG4&uyYJ-rMn5bt>Fim6*CkFVSJ0SD9P4i^>dAGMq>rTl zMgELt8h-HdDx!owVV_1Yu(4ASG)Ga?yo8`59-tD+b-5H@L>b1@Z~aiG?x@?|ZayBC zcKIEJar)IKH!C26%Tv|rZAG*w%LRCuoE#E*W7QX_8ihL;fh;UvOn)~1HN^MZMV24M z8kr5)V5I*ZEmkqSyq<%F|zz&V^Abf&5a0IoHJ}_i%i@_b&zl}j${b&` zkFnq}12VAdcv(-bU}gNvgv_JT+`d+AHD2Y{zAbm{<(M`{II{LMnBuq|3isJ>j_>J< zA9yZO9AgO-;7N^U_sR@*2PJHCKyy}p7hn4Qmce&IepeDx{VTrmubICFNvs(+5mmK@ zT;#5~a;R^Y-qeE=AVRiV8q<1Nx4>tCXYNw~+h_HA_8gmljm66Q%gDETnIkpsbxt|c zPpi^y*>v;zxdYP$#=PIzlI#I#JEbk|fOH2be0wf(@KJB`Na{nFjF~1cvyQbbZ<&l6 z23W50;Wwic$-A3^aXo0w*&(jujSa8in(`nPi*vQW#uok4ELljEy*1<189aRpuNf$}x*)r@y=k?X-weT@ZHA^5YmrOPf`fwbq0ZxLwU{6=^x+(uKa(i-rO z)hp6knS>D;EOQI`E=s*JA)!7@cE2FA-}31vsiO`x z)%zA4ELcdfxGDn|$W)amrIazZaft~@TLf*avDd#a`92Kv@G2qQzEOta)|1_`0yjkX zxYB&Kw}6{aSvS*`UI=kC*t)@(n@&Z}_@P*9eq*-`@iA4-d<5#QU!6Q1(#noc95HG* zNoK~WWzh0TSad6?^F2mF91~Ri|1vUx8XxZuSVeM{p z<&he)K|eNzw~2w$pY?+86BZ0l&BuK@f>${@XzZH1me({$a9veNt=9A2+_UaqO1|=w zsns~huNhenuPgxrRBSmQcz+<|e`&mZ<H9V?k%uT&DFw9$}^1&0ts;7(*ggGq{kA@^mL3>BQrqk-$KLAL{C1yY(}homo`lMjG6hP- zU3K9+#v5f{l}0DHe{4VRyj#;-_Kj2CBYnEc`Zh^CFXKrBU%IY_oFu3^f4L=AMK=N8 zww|RowR~ybwpla~o^VClVj<^l?4DP-Rr2%HXZjHg3nX)oB%>_G+XfuOMWTp~b`>>6 z_)1b7u&v(Oerf+_b3lH3bHkM6o7~eodX(o&M(Y6xr*r}KrU)`9KICe;8qlWqgL*E4 zg^&`hDxQOU&v0q?OL|tYFGzavc;D-G^Yb=G??`o4w|CzdaqHR1_SY_&(M;h{$Lkf- zA0y}~8GC?ns1RG4C%WV~0t1scK!E5mg09W`M2Th>0G?*vtGCbvsy7BU>+qfUB^>G1 z=ryGZA(HQATXo@5^RINVwga7Y?bUEh8_?ezoeexRV$BBUcSV@!M;SZ%YC$0 zB5bl2@(>$hcFDmxQH|zTQ;df1ZZl-z|!G>u}?pJVq^)$HALmPHi3JQ{HzIyb>4}lAQ z;GgH=@n(C@P}kEnYh%9}Eks2g_Jr(<^z4<)Na@(j^jWg}!2N}o^l(Z~ZdyO9ug?iq z_x1KX%-><5L!r&u&VZ84Aeee%>!t1QU)MS8+Z&MS849g1HrV0k)nP-dX3OitZF7W& z$}o$<1ycMtwyuV%L zl@N@+#MjSOt($tr<x|^^l)DE zh+I!1BfB&HfJ6JDS5#6XTgi6Iz~?E5`O6>UCF_)K{Wkpy#x}FmY$6|Rnhy(`uIs&y z-yVo!Zyk`XU-@k|F{%f>;x$=&S6mh^hbW%u@c~!ZmQ7i|1HyXLDh%G)7QWCR`zmw+ z!nKo>Z0|G2xZceN<8mDzpDJg@4}|7v!mw^O{HI@eMPesar=ub8ahL<0lp2XJxD}ls zGV6J#!JJV#R3tF@-UmwdZ!WVPYS3nPjrKsvQ;l-UQBe&{dAt3o48oh8r-Uo}3YC{z z2LStK8iwAVW_4!xuDzKi(VzRINXgfFFm^B48y^dpLsdG}ls?j_T|N3z@kgPTGXlgd z(6zH%)L4~UJt%MJwMZxM4y5e zdrVkZcO|8#KV|FzZZK`T-)F3cRS>u?xt6`x#NRc6-uaa~_NU-y`rR5g<*(cAZ*X}7 z2)Z8M-aNg}#b2ih3Urld0XvQ{@ zH$7r}LZQwapui8K+s?fH zY4wuTQ-x9!C`v~ZvXg~yaDUT#)DluSdU$TzqMl=nvAJJn&PZCW%+p3ujXjd0#$w zV{p25EV}c`wlL&zgY3~4tKnmA^9(F1`qK&N>`y^S<64s|($$yS9CW@g&SMNm~4zzp#$M5rc0 zw>nu??j3gIc56|VQXTF|TPq-sW~WJhzbNSYtDBFB*mSqTTPPJy*pR*~{M+!9d;6D^ zwbFbX5SzPoYQItYIaGdP=HuDmQ;N9A8BFt8&KZm{L7uW<+%G?JF2x;IOVRcDlk)E- z!N>-c1HZ7w8p|r|4KNW!K-Q+_q8XU$TD)nP7#d{yDBW`KmKFy`982o1OJ&BHo@2E` z$B05#sLF1mWRJa1(E^Xp!@VvwLbv4*owIEEThSTWcM(5D)mr*H{qL4oDy406=PGv| zWVCcf9j2 zYz(*<`!)QWKHvfXCd|G$6F!Z8pvyFsEgPIuc?Mo+6sFD&Dw2UI6r7Cw$o4r|@&@(i zq;W{qYfLj(Bks^_Ep?=qN@;#7j?hz$qOGwI!jq+&H^qZV68Owxx%y?rs|WeRrMyt~ ziTQ8of@CXz4dd_|xs-^$Lr2WLf;azoO%+M<;Yj1k&38OXi1V>$u(O=gXpkAWot#jx ze^%8wFQrqP`Fj!9$r_hd~ueot|OG0QU1*D4)YYlY_eBOyxJ$F1pJY%Dbi8lH3Qfz^YJ#&9Oc-(MWoG(GnV@^oA|WSTV5j$OBl|T zT7R{^$>(hOB8l8m|7RlEPdl9P=X*~Mm)_TkuUWHNkq$m ze=&@;eCEq`lg?bcYI0`kU|MM*Gg>28^s+R4V}v$tSuBeyIJeXLK{9loK~NPPYbv8Q zvTL=V(5Z9P72puAA5;(5-CD7|tava7|5zM~a1(81^Q=pD)VRW;}KIR&d zo}F!K+p`b%f(q_U`G^leUYE7#7kHbByIsgCgVjQ{+B}{>bj}CD9Sn z%(29}s^m3j`zC0?8%G~q%TAMev(ziMnytP0&Tks=@gL(V`31K$*#Fq#EBCV1ddctq z{Qh^N$oATKC}21Uvu++?q;jZ3oSO@s32NuDQ)pfYpnXPd1vJ8O0rvfSW(kJunc-V( zDG!R22zjd3h{(RXGG^wBzXT{2{p;j7Vuq8E+b=j%0!zZfVEP8Q=!iNW`IWhWTi9US zS0r79+>rdAD*ZoEnr~iYzdYJlylud(p3@IaKCTA1?>FD1eGy1@42Bl*^RsFrRK*;< zPMb8FEEoEMLeb2fky?hBqgz>xR}wjSQ{^1_RHb1pqY7Mu4(0t~F{@p{ZD~+926{gq zeYa6_75jT--4(=%uyJ;B|HxARiSh_Ull^k`G>8^%oeA(jgP9^yL}wW!@20`%J!fST zJUXwA&c)A0haH-LQ}NMZ;Q*Gog8HaW8R4`Rx>=G*(0M zNQ0>7VmDZ&Jr6BTIMgOH0l+0)V0M&xY?;14+hI+^xKrU#%vCIsH)UJyeahoBettLU z8y5^Ta~PTa+kf(#{_VHax~8>ulhylEM%M4KTTgCWKt+eZf*BVT#NGP1l*LZB+A~`m zRlRB-uA*YWyJOT=r#(PA$R(Aukc1mOG8$sBs&}RQwe*iNooDZb6dW3ZS*E#B_yD#Z z;=HWO1=iw#t&{eoke~biXGQ*^BI03Cz_bJ;0yK@4S<@=qEgsvE)sM`JfF-E^x`y7j zDlc*#QVit@-70PqmWh*jAFHHa6{8azj=pDTCm|>wMl}>+XeA4|L>(WOjd;c+>w5w) zHGSDWYolM%GWA^;03YQr;9KM#K&<|sywuWHppNwdsFpWS$_nS(*)z#(U!6EzdFf6gC5Kjarfq{WQ7Snn0Q39^tkC0?b2QG9)Of7p>_9P&*kz* zO;ee8-H?K(c!mS5l==%9`2U8<#DTt@0i7vI3Sj2wLE&83Bgp$Pj0v|at#&iP;TapY z<4rKHo#MzA?|M6pEk4GQmQmbwi+(DpI-1L-dBhuWQ#AumrM?iuhZlNAe{_#bJuGae zp8cq^FY>U9yf2`vODW0EItob#0AmdI|LfW-gWnziuQ$lFMq|!{t%?m@d7Do$Du^1k z{zhBxSJ+G}cN3-Wv*xC!0l1q6on%eM0e#s}!#ozvoD#OUz=+hsR>gMP{wo8Hck?gE zY9-IRsxhdl&3-^SbyDpu0i=?c0%Tfzt+45q>Sy!8|Nf1CXM4M8j>HKA)}hwpWrwD% zR>XcFb>}7}SAchaQ3Gw0=A684>cwHR&{vk{Dwe*S;2N|fS-GcIj)+sKs+2>hG%np( zs*R7B(K_s`rGoj!gz_&)$6@<_!3u0TvwB7pQP1E&MM#O(C;_sY{#CU8y~P1P5)4Qj z6u_;kLwVK()={mbGIo*uu&6K!?{fbzSuT!Uw&6Z0cDh+KALd>z@ql`RYjo3z{h1RS3>;xqhi7nu|G#(V%l6)Y=FjDJhVKdwZGQP~Z`P z=D=a1CJnTx{}a@sEah>9OgCP{-k5zq3-?N%NaAEp<)*BPz24zEgj4L*ZZE9e>Kke2 z>fcsav0qq!#w^e4zRQ-<8hB#y;?+!qetIAfswU~>$IUtoA02F{k3ZCm&l$8#^|W9V z+_1d|`_pasU)#Dj*=>MCSuq@@*$9#X2q8RFUjTCWmuP(g)zKZ7PJqa3Ir^j~?lzOW z3tW=oD;D2h<$DcowL%06L?~w8W)8`(Sa|Nsz-Bg_96sxoJ#@IHG0B9KJPbx|!=aL+ z`d-+qChqLy{vo<-W}Le5e?8o6*xsHoJAW5!f_bn1gbn*o&m@pwns@LX?e`4iK4Kl3 zaZZYDmi@S(hhGeJ*wgZ4>T)pQA}9nMkByKBQW?BVChyoI2kp@m)5A+jx%v2y+~dkW z&z9@%8bgL>+M=is%@h?bKdnACK2`QxocKgK~bdQ z+mp;++t*Ov8y{AH+ny=4QtHgdRig_R5gTFA<1cO%-!q$gt|jhigVj7=%%dtl0;)b# z%+U1P?eqXfHPY?8)cB9bEpSY>OfAv+;PjTZCtQ+MvBLW!$n*+5p`q$> zR^%)QCuC8J_$bV=UzEYsk!=ai^ELLl!#Azc7fgiphHUx+|3NqY-q9>5-|a5><6W-H z9-JZZuGR%*Zk2#nVVrEkNjG2W5SVuDQMt@TOL4}kA;I2{55G?6Vd}!^lmowW;U1NP ztwpm3k?E|2P0|7Zjd*Lo2XnCywj689qxwna^}?M@OZir~QVnaQ!^DWt8C$F1r}^iA zRV)7DrL4KZW&31{LD8PcZ~aET^Ig`lVU00JgB9$~PfsBJpiHrvO}&+>F&%+V{xkWqNh1bQo8`(L9w((C~2@q z3bd(;?^SHo?(|p#L}V+u%!}j8_r9syi597Is}Heta~^FkJN?*sdPohVG7dxouH$SZ z9qL(%m#*CZLY%*oT)<|K?_qbB_yCuu9E^DD8KO7n2po%VU4;ff!7x!$x z1il3&`E!^@08l!fKbWt6K#~~)gMP@J@nu;lB$(kLi zvJ*h({3}?%K{Ir2;+H6U@{cP{*DaG&F5;J{UuKkSd}_lHK%6IKUeyH zy#?ptkRabw-}G+Hf|4%2CW?GNLf+VjbB~0(=vnQKoONtLpZFwO8#cr4XJ?luuruBN zcuvw2z~?Bu*NWt8B(n_CBK0$NJDe%m6du~Ox3ZC-1)iI-+{uFjlywE)xs&>!&q`LIP+UWMB|OCiHf)9z^!t~f^5+gx^6qWDF5U?r zbXf?n(lUN!;J$vP9S0a!A9@&m>2YHu(C_K&Jt01QqdkxVGf+SiooYc^^mR|)I~!bK z-eAigCCgWketjGP&$nkP?#);V<@2Qu^uLN_@1V^WjMcr|mJE3J5*YRUi=a0H=(t`$ zj-;(f)#WZy8Anmahw;K!ZuXbVNm(O8>11;LV;diR{MZn=yo1Gz3b+cR)%e}^6SZtz zp7{wAbO@cqllGMX$rk319%YU2zL0x|t!Pc!!kcfUI+m7?p7DUuZQI#)NjDt%T&KK9 z)9=t?B|Z(0>ZLNh-cRS)sBQ}e zcgBe-r+yU6%BJppvP5RAN`I;$r!X(3uo6$(=!4CQ2auOwN0;u(|4}D@pMB`}kMVZ+ zV7%q!2m9mpn48mZuPUykpU>NiK=)FN2(LaF>JpEx+@QDCb|(_8E~1$Nj{mALrbd=Sp+!(JZNhN?P^sR{@3EB3B>rfX=MLcSRutqZLQuAKBlC3_C(G~JOR zSTPE#a*4txb>3K(Wl@c2fxfW;On@EEzh{qbgKOQvmea-XiPoeg)h{Z&BY$4j{u5wW zW-MzDgP#k0G$vzn^`@cey|Rx3kJGQQ!DsuNrPU%}u?J?No@+0^rq=<3X}lWIYCQ59 zJ*!Eo5_^L{Tf{f%3H)o&H<5ZAawg9nzUlyYF`PUAYiA8?s+RM&>$Xs98B$Tz?QlFk z?VFp@x+Hl}HPcM3#&jKMEYH{hHVmy?OY2AFEN4UtcPQUtUoVMerCrph1py(iotTJ_ge04SL;*z_9S0xTvj9z<_rk8PIJb+P$~nOsA{8|P#G zvu*w+;vWSrH*+`a!zK3VPKqS1_3cd6WJc}1PAHysd$1pSMU&adkcLv*AU5b}vU z0{rmw05fd|6{#8R4$OuwaPv6vG3I(#d5&M?`|TNJdA<%*5qUD@`iOE;Z_1htr}&yu z(p0~FOFsw{tEe`{qFU2aL^WbT^}`U1hg<9!h*zU2D{)B6?UQ;!%H}m~);#mwLJiWy zWxd}|d`SLV8F3YbO#t_sw>}7V zcW&yM!ReLKRyum*16eJL>(>X2R7ac>p2M6WotlX*3_X(KUXHFUYSR1L%sJt`q5Sog zAb_7%>_ycAP92uigW9Ds3q6mp_E%eV{Z8TD6Q+j%SI|FkO7wSbDFLVek3q{v{3C0j z7VNscpZCrY(S2MA{N4I@XFqSZVs;*39{zR|ISkiKl_5=Re*~M~J<&=#o>;o>cXr^1 zdA_1{I023m*@;PJ7b#Rs1u)=QAXppHdg#(=pT@(zrdMLuVaJEu# zy0Xt#)~slo9UBpu{IH%tBbdu$j-K!TT`2Y*MNnP7`NX^JH@6260I?FDzBXIN{0CUEh0iv$Nq`G zlui)h{fo$mK6EV+(13^PO_Db-6ke!Ta z+KTEWOl*w~$f0y$aTLmsu9r8*Hb8U~8v2q9&4-x2uMJB4O!d3pQvy*N5-7?FUxBfd zF_#s9axOoQs-LTy^g~|yX2JFrMVC`*ajWm14%7KzJ=icw!Im_10CYWJ^+xKn?)bDKOpC z$D>0DRxIEYI`0ecm9OnML8cgcjuF;G3EffBMpb0~C^B-@Vu0zO5t|~5$QJ>$QXoo8 z1~xn|?r)I)l;kElUrBz~Wj1U+_e*bhfxl0r|55&|%w5W9MB4m9{SUXSxaY5AnET1+ zgt+>~_dIb=xLEqfk6%;|=2nSB@q(eJc#Mv!|T9dw)p0Tpxlcc*ap$0)kLJt)V}U(0d%Yp$%xR7nje1P zDkRl+8msF525Wd2U`Qtk=*M;rroJsaFu~e2bAD^c0E6&UoTDRhgyzR)yL*I+W!y8w z`s|n5;{_mfqHcb=*sE@M68@rYsGC>&`(IRo zU?KXk8ZIjj(NE7@cYnQP<^obr<$z%E>(i&}iaLzT%2FrD=|d#CA_Up9pqio0x$GeK z)w3)oMqPctInSL?;dfjCxzTF@AU}+-K>|smgJ$cAV$Qi zBz9|>G&)=|FdTK;n+SA|CVa7x5hy3JDYU-Syw1Ckp-o9PDAh>cd%}}DfE#ZHa7SVo zxwmShZHPTjO5o&~OCmT)Dr*zL*y)e2qq%>gc*y=rJWq7}k2(a-wFcve_;$dit*QSn zfKqwA$`2=HLCYfK^z@W(jSH-0XK258{eku z8wb9f&R+nryni)d>wee*neKn$-4_ZQ%x^diEo`0K^e&nlhKHZjgi-0uo?3}D68GZk z0Q;wRc{r>mjZ{AJ6n_R-EPq1GkBK<{A$;VHhBrI$by^v&T@-F2VqOgvZjnU(dL8ex zUy@eW@BuYa$yJSM+Fb5?5Ups^@gYc6Z8}EDe9RjLyvqjO@SM7ci8D ziHnbi19?%r$klGA$7j=V5B-;)~i^nvX#D z<`n+!nk4GyXS76u{a=FV6rB^^hbVPva^CFg2u~Z?#m8s|7OKeeFMQI(SP95!DL+w7 z)N*K*T6=a95d_UF+Xjr|mf*-BX17;hH?oqHV6G74Up8cAG*4bfYJD28Deb@eBhfOo z>iNX$86uiQDW2nI2+1x10|rd2y;r^SmFxv+9S_sjtFwzhq>veN6GnP^Uacr4!Y+gS<7OfX>0ylVbFW z0i@zfiT3j<-w3UQOq(w_iQDD*O^zm^{RUaR^d6Pp^>^rLl`{<0Y&KTK|5<~nX!+lH04#O%@)_xXtsD=6LH4mt)2wROq>tIKkN7x|$WW2Rzj_KFA_)h=p zmxS))Pum{1=@{~rZ#Od=AFmkaHk<@f4MZPeSHF8BmTZxZLj@}lUTuZf4KXrhpf1G$ zI^_H-Z*fIso?$_GD%UrWtNIZDwu{RKzlj+=u+U!q>K<6Nc`dO*@2l02T-|4_l4aF__ht&Y662oHSb)FL4hAl!ON`@8{ktECo`Rx2lEhR0*E0&#QQb1~Ch3yhxsW77TS>oHhfCCSIFK>rC11j@U!5>%he%d!{P(pjDNS&z#DlI-zs*|aK+;Jk&6yX|=eU`1)P->KG#3Nn0$HDMKf3e|zZSEtEu0qZRg=pd)pkB$>;Vik9g zJ8Ac@+;oJ$}_c2CYk+ds$HTK~u7?^7)@JdnV%K6=6i0#m4cMNB# zeOrb+IBLkhCVkfg{Z3tSGauqqn?R?yD-fWJx1;5$DBA^A65FTKRZka}5rkMb4m=(e zeX@71l>tU6cAqDKV+hM=waz-Ut3-JME7o~w2!kt>aF5OH?KfBY75sU2eNeFGS5+x?(+{$%Db+YnxPR6SXJG8&TPXfl2CfQq0D z&)?Ow%#QsT<@xxprQ0mU2@Fh55X$v5IYt9(9n-aR-+Zackh!2jf7`=|2ZZ#=ZR|*8 zSQaxbdVAYZrJUZzq@Xut`(y$3m#?G-tkObA*HujZ23w}%4f$kQ=|H_1^%f5QcvkaS zC0P3d1BQv!Se2?l)<;&FN-7tHb=%!on!O&&_LLeiwuz=Gs3jrkSX>rfKi}pG@L?M) zT$BIHdt3!%s`iFcrDk3Ji?Ya=bwQn11+sKhD0G*37)ay^jnt+zgc{u*GG~Mvd^|Kb zvh$Z4w}A=q$s^J3{Bo~GtG|T-cToztZ}YqX=k|dVh5HD(MTu6j7m)D>dnDLpOVW8l zLFa9j(2%l)V34C}XP{B&=s>Q>YCLVp&hd3N-R~ArzNwCaPH9%PZZ;yk_E8BdY1$tW zrqrm0Bg9vIcHUao*6MJGJG!~ZT~-XvV-z`QmDisGQ%>9hx90n$$Y91{<(alb>4lWE zNJKjB@$PBe2TAY@tao?0uPGIV57J{Ck16EW#1R|td>62D*yvHx#U;6eY=S(aXU``e zdl%NzY4z!jRw?YY@M%)ZqRF3VX(PSI-^zea6%YcJ7k+#FbViqEWqdaZaMYIEap4eW zOQ);~Q&r$^ZqP_8t(QtUiI`n{z1xtVCm6^5&O=b^?mx|XB(DLPQ)fTO%Y2T9LIbiu z?A3djD}U%?OOEfZ!1rLBEBK0NGsH)CJA^F24UE*x=GGt;J)tp^>eCkq0)x9~H ze={qHAN(~%t7onm1oerU-uiK3RAhn|B%FhA3+5Pee!W2U2xQxT~zw z6I`TjR^YJ1>`fINX3)tYl-o#1FVLPs2jhUJ?fS*C$T@1McHVo$jC2)-xN8aVS3iOZ zto(5#lmxv!Q-cFYnUeQ?T%wS*SrV`On8d_^(GLlslv%6toE1KjaxRixO^_*^@!@S5 zU1KU~gk^DPp`%|UYh9^FKcP&SHa|(gEl1un`N6_$TK>WK$`i!o1lc8W!PuVkzdW`x zWt=jUJiQz#5cbve>9|};NNAQs$YA=u>hPh4g;op0w_5p;>xBfd>~6WY?2O*wd6D1U zYv-8PLwBbJaViP3GNLLbHq8SE5Bbn)bT8RG4K!`yN{)t}h0|GoaP5NB6&v4(s){P+ zzOX#mXCXb(GTgpt(jPu_KzI8Y8MThh>UWxJ3*>p|*6-NI7? zbe+nn&JQR1+5sk$5GUp1kzfN^Xgu`WRRi|L~HRX)~SR)8}n> z3anQYXDYiFm9rMXt1fv46%BpQI?-f*Sxumwi4zf!vPUUuQKt>>ryJEXTzfOmQs}G7 z_PzC$kGp%?fVErmsLD%BwbU!?w%&k4l6Kyj`UF0Pb+s%xg%mvi zZmxcAzIx5N2Ww-KG)gC1F!R-njzbBP5Wdc@z{5hn1uiBshCSAFgzQB6PbFekKN(_A zt)zl&qUJGfMQ7tWubqkQs39r`slqmuvud=1)JbGvN8i%S`y$85k2U$!>==L5BmMEe z9W>I?Y9nZ0Pir|f{8+FfLk8P5vwm&``A@61VlioQWTV1M8I{=~3~2^mP#JxstVQbe z;cZ-u*7t20%<&duAl8yw7A|r%oa^T%D?~K;QgYq#`zToA7pxCx85|CE67?$W7(knq zg%oXCPrj!4&iW~A4@ldp-%DEN&I3793b%V?S8Q&n>3V23Ku32i{XK;W^nUx=g@RG?cRxTlNxcjgUnz8snfRCeW4r4NNPP$1w~w zX9^sO+Y!v^2Dxb71I=HPxi$*rBdbY7Vv`s8HgUI_a~eyGgn+=OU2KQ1I`)>(p1+{D z_UmN1@3I!b8*zNxv`97AZ9A@GnNlY39tcu{gp@R>@H=etxtI(TK}8YBlns#gEECe_ zU{-QA-9Jddcffa(*qjz%B&*!4l225%#he3|%-O3aXekk-7&@lR;|<<0?3LF0e{rvo zKX+Cl66G7M@|X}b2l$CxD6w;Fxi0kF=z#)e{&*K4@6K;SWkox#-E#H0{mSNCHz&CD ziX~0_2ch?24m3;2!EK)RES090+QKN^WW^jQ6zD0G37uTiz=_vdA{jfzDg#S2sm`zp z2hKz}>)qhV7~4|WlPVARM^v?|AlZ_KWeI(lYTtjW^Tc+bm^U_T0nh*QH{Tm{d#HrwWF@AE z_j&_q$2vAFXNPSS|Bt)(42ml2+jq@kAS*eDjYI)SO>PjB46VYTWXU<_(2WWRNY0W~ zl8BN)GD^-!&N()jCN~Y7)y&NE%*;FQ|D02GKAlgNRg@NccdxznZ{62@J)e-{f)+BC z+y)`PAIo2V4;?tVqO;IvMfxVdLM5FOg+TYR4jK)JiX%^I?KGOTKN3)!>u>? z_xuFqDm_LnKWq%()|R$vfE)|gf%1u?tVVXRPvu})*Xp-PWq9Olp#S9<*DIwrsO_TN z)$a6G6=2@doR~PuO(|vcmk+x%iVWNvrKQGIy`xg^s(JO1|D@m1IeXM}vul+CL!&2{8y7XKl6%~_&on^i@x;KmrPP&T z;b*P>#vGKi_KLQlTFj-O6shzZuh%Hg@1H|JPsQkF0^lPz^!T|8MyspM2FL<4;pOpb zpUbbmUZXv4*!PTGC2LJ;O892DuhJFIF@YVAF}VFVw!bFGh&kET{cZNWZJ*8C6RO~N z$M-!CS)`mv2N`Y+$})@&v5?lrdj_u_r@uzeDwHh^qZOXPR~6Ht!QCMlh4(3kZIz{^ zVu%3`)LxB;PmfwG-+sDM+o^lebw(*!MCRb54~Tp*F74Xhf;oNSg`6x_J1?3OAh zor?FyICfPBCPa0-GohKVbYQ?Jyx3f|zYu?2nJFBe`>9~NfIl{wFA~|BcjFqWqVb{r!2hQ@@~g{^>C~6bI2E0Q3{BfsMqo(=c7W)kQrZPBi7d+%$Q_jaDWT>~x=*HPMWv;e3 zwS@R!3wp^LnTMN0t(w2`iI8Y31i@ywj1KUGM5FZ2?`AAGX;)iwqRcp7665}+WB)vWgrDVboyP24; zEQPH1;(ja-1AYwDX`Os4f{cMY34--%c<4s(zPCz9lB?yRebW9%>;d&Y2Q7^9E*&+D z%-=4ErI*D{pxpmWkKMap^;v=e4n9!kpP`;^-+G?DFUVIAL%_VC3v zo?Qy+NuW}&d}%apD#!3Z0q=dhsm7wbY;K&AHJr8tRzxmEy8K z3*@hN$ahg=xuSPQT_%sE_p_;UTIG_Q2KHqL+2PiZ2HAWdi<|lFbu}C7C9=n7c|NV! zY2Tc#O^JO1cba^9)f@EfPWO{M?XW6B$fX9~E$YtUBNJ~0_g{1(sJ_YC?#QY(gQa#! zn3SqRiCuemtE}Z5u@P;LWdv6!=hZ6VYhE+?N^b7@^_RE@+~mbLaKPeii60?D&h473 z#WL(q9+!d5A>R24p_;8=8%tPF{m9&Pb!Y@;xC>d*K^A6)`NV%*Sirv8s4Tp}y}xMM zQKC+Lc4H>-mTFLK>NeBD5HdA{OLeQQNjc;6+7O2l-JF{gt z$fbhDAzCTZNt9an%s1n1_uLCYOipc@`|zx_yR@t!zw`|a zv0ZuE_@&<-!9naUFIt&S%)`(9SxhpAzM{>$9M-^$XJCrV9{g%ocET*k&~;pKKqc2v zY(AH0Nb6EiHH}l>)4FaM`l<;;`MwE6TqOEvJI={2_j}8G)T#5LH1;gFc0w$x+sU7! zYx?q{&;aosTgg19(D1Fhdjp#ql1>Z_8Ri+i-{=!y%NbZzT;aAQ?IkTgV?&MW3z%4G zEl8O(DsmAfS<5~wI7fQu`KxTuXGxwJPH}V)5TcWqc2hfqA38bn;+{39OBVXS z>d03--5<&Ln#yaxy32Bv-gEOxu5f&V!>vav_aKsqm70!?(K6a-GWL&nVXzt%cTCGew&$*6 z+)47|t3EB6E@4p{v#g{^(mt2A!^@v}t)^|4Gg$;3a{iq>0La14;LbGohU^E?L7I%u zk8u6eWDeTolsU+w%-;VwI;|!nl3Gv6FW=-Qglxn48%hW+k0e!zo7 z60_hr4KlV~zt!REP1{T39z#twwPBlMT+g1PeXZDvZ-xjt@G8`e{kj_jx+CfZKNhr* z%ZvE)P)#+;^2KG{0>c9M?FLZ(+6;1+KX@6CZ9 z9o%U&_S>CPW7qz^PP*z-7E^akyBD42LA@WXwOzKJE{Cn>(u5M6%qD!}LC;nk7Bvcn zu-uvovW-a405#+UC2V$u=AF`Rj;(2x33_aFT+AFPERmRo`7H314;7s8zg+W8;-4Yi z`xh|wDAHy6+ohfDo{ip2 z#hNEIA+YkHG^uPtww&4cko>TE;{|v%)eAh!OuVT#v!L|5tvI1{WrAOMjCzT9XbHGX zPQ3QkFKJbLxle!4c+&cT<&OXP+N{uAfEs{p{->F$kUxM3=PQ>EbSJthvjDO%C9RU&;KaI(z$n`EZgpBZUTiTJUjqcgDfa8)@;b9PP z3=oj>*{{+`EJ?biYtJI+PFflt()T13Fm$8k4!#t*Vy|7Zj>jAtG?@hI0@}jBm7iGc zRX$%h!NX{>P@hVBpDBC!*syPno6J$pdDG8_s2;?SwkjOAfS#wdAMPNkWRigC4f#ig z9!h=z<-wWWkMYLDo;_RLh;SK3D;dmJZf9B%Td9vn5^zWD74#A*p-dDL+MTDpt4I{- zkIpJ&Z4}Rnxub77Mt@AWI7C{KL;9t{G)5xBXFinQ)fUh$?c((o=BDHS` z&5%QHvs(#Gf_2NQEnBLP*ZBsKiv8J=p*tVHr|HWoc3ICrm}SSm4cG8UeU-Xfjcio?`BkG82U zI8?hOYki#??{zdB|8HX| zK%C;74)sH-=2~1TAEX?I@8nJ+XVA4b(gXMq=p~+b#lc8DSU?!8){igbi{k1tuk2nb z14BM}d;=EVtA1vAqI)zYIbR;uS1MwGcIE*h=0x>WbLH{{OH z@`}J@#K#Yk8FGP{PZI+p!=Bqgd#>>(esd(4$MDQ-F^48eH`3ErTgaT@rXhf4#^I)! zU`hYa_5SlFyksK&v4}1M4~)7STZ%G*cSP*cpq@`)RXphWfCpPquAN0Fy!3$~#iDg7r!uTNOc%9;s;6ynd4oWD-h1RM zCpj{IJ+0yj-Hkxi-1SMX(ptUcjO6DVok5bV2CfUdc`);$e ztUlPF4@IUTZ;trCe6(&|;PpEPGr{!>R;-n1&bpN*T@=D!y!rI@On~IwkSVnH#f(+M zO0JYjTWO;^6Z`1T^9sO=D#7EwK16VJc(DUf{zDVQF%W5{1m_MOr4 zAjaA79Td@87>J)Fd~nl7X}pCLs&Bc?;oJKe_DEF-Y}|sMNmpN&j7puY%$2RScVs-V zmvq!yLq{x3#v4K!cgr%aC>;OWwa*~_apVc4W%=4!c9mgcL@HWDv5YNs*Kl#U4!fq! z)~M;L;`e5zKh++*<23S_&Z}KgNzPRZ1%@6X1u0qhi&@4wsM*=M==rX4_%T>i^(&3q zV)n|I%sd~=k+H7bLk;DbC@jf3N=nk((Y~PxIT+SUfqbFSa1qOPB<(!3c1F&qDd=1igRz5P)Mo zxl6X<^#{18N`j4Vk+~%vcXA77?G^f{vm*_L($-(T*-Sx6SR(7coM{kiNm zNft$gjV(P(*3r5+n~-B;iv5zyJRWIg5d=<*5Ifxt)k9H#zwhnfT#?*d4}-u2&0vt2 zw>?4_-fqA4j}8gS9NLp{zh!Lb?!nFoQEI?_^ydH{RGU-$%JU^yn1zrTLkquEyrXM| z=>B=s7~xP)VJ7+8n{6t7*r9q*f+fj3-Z~mB9HOy)AR`=%f9P~kATzsf@ zT9#p3qqSmbzvH%kKHttNa5nJT_zk=yblJ&#;P&Gb$JJUP)V0w*E}KjRuBxJ7icD^* zS_!74H;#E%LHr<=so^GB|p1!d?~c0b-O(ZX-s$|5tV z|JbSwOG=z_$Y6Z@*S$iItHy2ej%;VCH~MkVVK5_bc#z}A>e?M{o;FsSRR_i^=U1nm zkwC^5!J3p7sZ4cdmg(XzgK6i2VRh)zAH!+~!npgt532=JG12$X4x#@YR(p8IN@ox| z`V7waulDD(dW-dJTFoC#^#-?z`_F37&ICqIkKR|)NUoH2(|O!H zTCLiD*TP;y4j64))V)|fd#g+8^gKyAyMbq~l8tv?HO)IHRU0H)6fu8g_|eik6Q)-_ z1nnu`EsvoOPdQS`Ihs>w8Z%u1)c)8+%})!c9+K+}EPBOqAnT#84R#{@5p z=jKlHHvS=@?hWAw61I)%9f9d1W~9o zFA;X~vjpD?_0QyvG*bP_kRPfI_jKT~l=SI+xfjqTa15fMPi1KPcg&=G|9X#aU7!w? z0Pn3<3=Ky?KCWHi6uEv{q9n67q~BPoereuvzoX-H>p~#pl`cpTd>?nVxWt#JVn!1= z<;#$d-jaZnR;AI1*pbjmuFyq=!A_VE3fu5nJA*nIV5fZ;#1ctH_;X(3Axe-RL!C*< z9|9(4_zN=Cm1-!849nGL@RZ!nHm;gVQ279ElE|Pm<{yuO;Kvd*9UtklY+M>{KfejQ zHcA7*w-#5!XSch=Ypl?zHu0VL)h1_?Pw@*mKRt6;+i1tw!zMN*P+HlPas$uY2d$|a z##`wlxwr-e#dkdMW(5)p_q!Sqt!;%va+xP&Ap#LleH#752aot4G;+(7wbV<~{g-gf zPTXXs8;#0jo&;77&?X%%yjv86QTf~RGEWaLO*dmBgWlwUfmjB-%cV9>4djCXCKb9e{CX+nTEmqIX>xU2*SkuY7rpyKPn!ko|>a9w>8h44v>_-Se(X+e^ z34Oy&DE(efhDI8}yEn(CW?pDL4DlD#?#bv76mpLc)${r0h+Y~N>5DAbu_QKdA3ZwK zip=W!+jketfnL8t#!F2qdnsY3?8K&}-yzKW&H9B~Fj1&nYr~2!>ylF=Zvn~L%9?re zXrsoff-YS1aJ9-Cx zlu!2%lVK3jPFDHqA>={NnJqv+phaZ;pHC--;c(-A3_)KSgWUlt@&0(ayXJN zA1)78L$#2@Mh+{%yHd1gFSV|^nh3ab)%`@Wo>hsv=Y|u$yzWn3i^}~M(eTH zGaQM!S1-*4GT*#L-t#zuYpg}poRY@jt!IXwwKH)eTJ@HG;*;UI8|k!LgBJ?ck%lRkGUf=Y{|;)Z&sGUvUz7GSg(A3f>t)boi>si9@9`n<@D0tNNQg6Yqz z2ZWP~l!sZm;|}%jz4@dQZ9hpgni+OvmR7bF&W-WA_%Qag^5 z2U`c3u0!C`{`*uz{^CxrGp%?-!71|Sn}-P5m(8*5PU>oY>nV5daGI6uWfftZ z@b4vp$aefttG5F@%}R>S*YNTSV@Wn33>hwo!4NZglA0=eJ^1V?I+z7Bk^ZBUEFV#Ez5|Vtc^0p?5n8b}B0yFRXK-X~w>W9qKauI8@N z*?<{bmMSG=(|gWA{h5RF_6lQ~ON9%9X|c*Ws|WArJ_%a<6Q*rs`V*%0d+i|KrMC1k z!BLkkE?Q;=-b_F9b-Gm{6S;Lzw0jDq!(sH^YpQH3ea}e-2ln;X;7@N zv`&Y)2HCG8S4!IIqq>c0WaW#Y%=7t;y<=DX7(PU)su-yk6S^ zUJeIMIbAh+72b){xzJk!kdWCTLyAiT zYjd276T0Mn{)X($2wzP9q0~q#YIT2KN_8$EGZCDm~o-b694 zLus6+EUSr*MoLABQGKx6sp2b}V_+j#LVjNKGHanT?MJpadH@3sP}BvU%`=ak;#No} zeXQ~b@}uEeb)K@@bx^I}kb)N2?p-65kmTH=t~ zS9lLHnHzD}n3u+`p193?K14Yv_Htto1!T(w6klsv0J0Bh;|eJHs!uUhKqW|l6A22? zSFh{=cUg9oTww2(yJaEX381CEWf5(i%wJ1?>XN!quWGJ>hGeJ~?vqWr=fV-oD&DLk zD_{ug2GpjQ+y%muDZ&w(?qe+QIf|1bSW6wdjLN9+5@8WDS1VEFb?KAc0n~Co4}!>b zju~}>sal(gZ@m5nn4fA9t=%<+w+<=Qi+O{=IqN%}R0PJf?kG#?z)lC@AB6**=3T3h zSKf2KG(3#}lYQU5@<$DUK%cG{5IBzn`n)eE&<;iGvHdxjwO_k#S5LG!2fE5YLub8< zXU56qZ}SPccD+8`3(HNA%Ml5ZJq&r*!(g=Ncxg}<6fqZ&*^N%`#d9LY^vN-&uq$#`DAH!d^O`kh_%kCTS2u)`2QlCdW?YOcDphPw18orn1S{=0mT~ zCwLGl7QSwO7LZS?9_>Q7{S8K&m+tT0L6E2XysGUuIJ>S*?vZMOjS!N}2!v0q+N!$F zJe@cILPb#Sbsp7x5i=`6P09vW4LwUDwwN{l3;L1F+Gz7> zVJi`DwT&IOWfVS~fM;y6)sJ+@*U&FEU}JZm{Ct<|-JPI%xgeTJQ!LV@#qpAsMP{PC zJg9+wR>!IG!GWXTr@>44`uTh%x+>fR`vC3rVWq`3$BqHvLx_qB&<0Hs8U|mbDAM0@ zN5y&9@x7q)2$p5Z6{6n$pPh-MKOY9=u0a~}PU^(5b!svq(7brpHc|w2-Gi)lF@y$15yusOMWTORzlL6Ogo$FJ5V6(p}+5 zm=@(KU-~p12SAdk?;8SetTo5z=24OKDChFFRdssdE&!@+)=zH*DOmuPGzGTNi9X@N zY8oWFkDrDJExex=>T**a{jt%Xi*#CPM(AM)OzNFhz1D?`41Y3NfDQcQM58&}&||bD z@knu5-qlZJOivJa8mW;v(-FfDrv`FIj7qUJxkq00uFmml9K%6)L5M=>pwmSW2=@ub zwjprO0#U6ldK)3{K~FK<8*7`}zX4W3wKuOOqZjWb7xbKuj4m=5Xe%GEtjrG8-{uf) zIA62bX-mG?qnpyYC*!KGt5bdY(9zSscYDJtjV58}Z?%?huA}k-aHkBUA$Kj)NX;dX z_Z_#oV~In>VZ%PE0o!`F9*?P-r>!(YLM>5!B7xHyArz;W+*3^66O&$Hl{B6=KSuD{ zWTUhLGv#Dc0!PY!BgA)weDt69e6#bO&6+P}NPU!Lj}J63NR3FzB@08#Z)prXik{V7j8^y4}9@-7*`4vyH@w{`* zeS~c!c3~jd!3@?QbzGz;gKEQZ8pOOfGCP813huk>dg4l}Cu_!YUc33B2+R1EcoekG zt^D){AD0!=&rNDx-wBOPvwDiX0XL5pZl%hHdzw`Z9M<_tCEYg$lVWLm>sRr3FHD^5 zeb-IZNj*jK!o+6ck8raKA##A|O_bP`j2*RWU2OD6Tr3*Z)U$fgve@Kab6Z#F!grY7 z;52&UZsY6?1xO>{eB_BJj*K4%J-_fWdVCdciW?(b3yejl0$XKZa7|@U+4HxJau`vQtiric*#J9@bOh29xl@2rN&^TiY3$aOr@F@vTQyjH~< z0Uds$I)+1Lhd=>i2=N-$YP|(F47>j*=vy>DiIQj2Fz0vJMQ@tgeu3lwrH-PX(o{gq z*CSm}tgDX38G2oTuzCckX{{sOQ(3I>4p%0!J?8%v-xr;gl^&JUwa|oIZPK77`hbJE zw&Sb{3v;)(dR`rz;uc0H&1^kKYZ!OAX)3P(B`;^?&I@?l?shw$+56I%5NZ?cgN_5o zm{=InAzV)1GNu+c!O4Kv^?$uN_|9VptY_jy#zLnD}mk8iL_hf)iUYssT(Yg7IK@*@mzjpuZJ?>x9Fe(+O`$%{LV6BHq3wc6@%Iklgc4?}nW>>kE8JY{kef`ednDOh# z7&CVxbj@mXZ^8sqQn!`qg~?2~j)V0Kp+tgfGb=Xf@mlzGG#>|(Ww%|n8pylMFpBk2wsaA#S&ov2 zY_>%6k(~kAjMX!K!LFW}mdoUC1vO*8KmxH1@NCN~r#q0wK>n`L$QD#ouRqALK?~wa zr1ISz^KjLG-`PAam?&|eeQq(xREbWVC#3jl$NzM)H0#juXPWvh*} zLGUIOBH>mV&Gc`XC4TS0zbnl;30_B)$gC&~5x{j+pQ|VMF)x`kpW#?|@>-$My>Ixw zq{CL<$44-e$(N`fL+_2X`N@iZvhlv>hARLcZML&yl7fV`62JdpEM^qb)oXdBkh9ry z=)JT}jPK+)o&cDU^?z1ku`*Yz6%wSGL60qiUY|!QZZx&+qIFBE!h| z`c@H;L6$J6a)G<|bUx_*(IsW^Hwgs;FHL+}9p^w*Z;nx%eL_}0UIBpsO2#i)$QriO zR)cL*5<;x=V`?z0+XuF`Gls0ySn_m0moB^W!cm25V^Wnp5S*N?giE zi#yQnK~4^Jz7oT^9xaesJSAqG$>0-u2m3a*m)OQ9-rce628yJ*Xisn&J^o%{PnFe- zfNrekLYj(G^1eOm6ra*1aiJ_)ASVW)(^&8zb z*|E_@-%h`A?ZYCWrSJq+srwzxfpK$ZJ@6t|E@1RQMV<@Bbdqm z*8$Bgc7SpqH?h*CQ@ML>EzdbUn!n*9X5N{ggiBwxvyhF!lfHwy3fR`aelymo5C2|h!{GqOpzNU_Gu_f!&? zcM(*2?-O~lzv)~#sDi(XmC!LAqK&&_AL@mj)f{88(D^YGM-iS3U$wT>=6kpt_O$`1 zZ;cpg3SE;Gj;o9`9NWAu;{+W{}2#RrLxPGL2bthiiwnJhc?uRF>tR@ryi1d_^~3 z6I%9WI&CUxucy;jr3-v9@@fAZAFich2+39gF(2nO;1daa8z2u^IENK zL=_s4tL$c)%c@*ZI416l{ zk*Jm`g>H9x&;!wD6o}UC{$=jykzl3ERFb!rZuGXS?Ebe_+X0U4i9C3jn#l9$Sm?YN zme*7tFjJx{io-@!d924!;)LIZ{kOH2RhJ=+{)d`Z^(kyJ(asYe9ANak^a|Fn$!9E zlH{2!q$JViis<1zceCBXu5i*wXO-ynRN7<2o zGSD1NY_wwa6~R}`&|@<*uc8QR;bV;>kQb-t-mB7sC`9s1=JX+|*oQqW0E?F7gkwNT zdcjN?mdB>ju=*khyYlG0`SN!dtMnUU4Oh1tHjzdCaEHTAzOC9iCYeZm0i)DUhUlY# z$P$a_VZ{bgQROYlV@nsi@+6MUuqYw;js|wvicWsV3Q=j!MhCIX5bpJ zls8_G!X5jpzQwB_!B~^5gP6n53H~ zyj?qe#1vqc@wv6otb1Ch!s7Dvk1<4+y8;h+Ro4dNa}J)LjF z4=mDxBS?@Ebfjn<|- z#{{*jPeZl>W~Hsd*BBZ{M@#xkyLNc*XCOqx7JtLle6LdAl|C=ejoUQ|Jr5}~cIMQf#qW9&QNGoh__|h|JQ}++V1`rOk ziMqSK*>+k3G&Qfz*16P4r+0v&cV9(3m|{hd`YB(>n6x@nT~avs!lsu}Ea zV8@0oaw*Q}Q;Az)mPsyzE& z`|q7XGK`Ji6V{>>m~;ug&M#@?t-=s^d{~I$?DaD zi?u_Zr-NHt42M-=MoaPMV-qiIjb|Z+u_p{SBJBOfZv)AE+J$j5_GTCSNf2IKeFWO0 zJdZ+b#g9EBJ{VsK+^{*KhiwJGX+kJ;rQe&MHgF;HIS>a!O|ZsYXu^bCMNH+Kfq;_Z zOi`VanEHmkO4gyK+^Cv+N(=Ie@JF5N6zQzEBV1ZAx|8;Uc`sHRGwyg`;!LUS_AtSF z?A@VR-7~=lgsMrtKl<^ekXLMXLdVD@HRhMaeXkY-`s}oZP9UU3&7c7{>V6|-;@V}& z&54RsKDIQN1Pu0n@=A<<%PVo-&W0cxJbJ|9q))&=T4Srhm@J*SQNb*Qn2cKQG5DD0 zNw!a*W4_n#P<q&InBfQ)(EFXJ?x&P?M{9Ao3a zgZ;(2g|IDBf{fD$U;lj1OLfwZw*zjp6|Er2*NPb%NA#>J#><{Z8pgK|JA0>Gar2*gxGl z-G8PByQT)q=9kOUW*@0EqOqGWjho-z8GT)t)tSRZf&~L_p`?``EID1?O7F;Fw$4gB zGXh8)Ix~MgGOhIc_O%DRcd=Ym=knWM8!q@3+Z~52b{Dp(9!}`ePfnCrZ6F$Nu(dIa zwJmD){Q90d19CKZ26v|1)@|vxg9OYiBfEm#Ph7V?pS~;_au7*XUSB(l3RL4wT?g(2 zao|oMKLHNY6u%pdjl1kQq2a%Zm6oDFS-5T@7beXBm^04Y3B7{Fx&K?-%&CY^=d;!$ zQE2P_)`6kH@;WFF8_uB5pxv^wx~can&;7ua+WZ#3cu0R^o$6CsozxII$2MY!*~y~+ zoaEfgc=)1!`&~}ytfX0KrM6X<5k!BsPXBk^a$+iNZpS;@pf8#zHclcg44(-P|eX>1L}7jXdL~1isU3p*wFG>!(qEOk!GY2_$mf4qjOF=#hR| zWvUTyzt}3$>Ha=!_THNfWaRF|Pej35G$&X=b{|XVc8JyK#iZ;uCYx-J&klTX!bn4@ zc6oSLD0^9TvW44l8rJsEb4Y!mwDT8JEPA?XxdSYCD<9bDF+v&~1!oM)(q?&42hQTp zY6>2~H2vIFOz3T(l-z1V)HQrO!5<(r4MNmgg7A4u)Dd=Q>t_hdeDnFI%P!+VBjHw(E-;>XiPn z_gA;{D9!>e6>1?87%S+Eedu=29`IgMZrBNEmu=qz{f3pfL0p1erjQ0VhFsmOnzI}W zwfDK?*e-rwiV7x=TB-|*DJ%SE?g%F)G{m#)R1kwkr_WjxcnVsLL==bw3*=_snt6~~ z5jh8q_WgQ&STG8}Y?>I=SF7)OiJg5okv&U&^i@0=0mi}Hx?m3L4td#;;S`B1q^GH& z^~}~BH?K-~vb%N%Z|GNN`$hdmzmA$q!iUj?)r!Uy_Fg0-u1D5on z29rEVdP`r-e18!5zJev3BvdD=8%T##VKrAg-rQp~j-zB9I2`C6$n7IOW3qy!e(;;x z+~H;DXzUFo2=8YbWV4(6<%c(!*0$RQ(satzeBtEcJv-A$wKQ9_oh@oYn7+w_?Ee@i zQp>4;;0fC5lgFfc`R~SwUOmTNUXrKJ@GNg#a1JdAkLYMZA0`ExEA&^m5kH7Px0}Em z1nsnBQatA7hKH_=cg|+eb(ELtCdj@1H7ZKDb*4+QV7`EAE91J;6cc)3QYeVc zy8rgmYtkc*&o@|0=H#_8VFZYFT)GBCk+l4vZ+7k5g}sr+Z+z0hI=6gqbzQcP_c{yRSNg4bY6L z@+9@FS#eKhrXbx%Z5mA2f=Q@@dvxbV!wI(b2A*Aa4_VHEaJ(~-m+B<$dr*AVK2g-KO&0{usEMXq=`S6EnRGp*h2;-Ah6 z%9!^4VXM$@fV6!q4;V=Y>g%CYr3Ef6wk&`}hNhAS=`8 zpL|8!BZ(BH6y;OpluikMV#8x$zs{^GGUv(Tx3l-Zj*ot}kq*%J7&eLxy~r4g59NB4 zN37>ZtY0GBgu0b!BOLisHTC*y3x*2^N$_C}s<#vs^rh>l2HsLCWeOhlGzE$yt(A3- zmWvj;A;H)K#bzd_J-hNDK3#wAt08z71quYoo`*s1D#sQjL`MQ=390muJacGrm6RB( zLf3#&)WqoHlxN)0<$p67NWOHq^J{-&=X7UnhmscKf|ut#5nlZP`5Bph@w_v|y@4#} zUn}QGOHiTK1gc-6eSZ{RJU_UAGwZ;NP)0G1IhuHL<>~Nbk1N-54QIpPbK4IWkv}=1 zEu@Vw<3Prp zMrSdlGPTlwurlqU7cj3e?vHdik85}KKLskSdh&VggG{Yxhvv>`4*$Q8@{pF6ROy~XNt&Na+l+#6utob(;3NHHN@(XJ$gyS zE87ICy!qQrIcwF#ZYAN2$VKUx>ju>HW};pJnTn27#3Wxs{tp4a1*tm-7{|t}+`dWL z1_esamL878Wnv!y$q~r(EjlQjIVlh~XxFditjYR2;91cZbRo|9t!^(JehQrQVVIUI zmqq)E#L07b8+3+s@!dQh@*pPj6Va?sE0ZqE+MQO@b9WW(XL|C};Z>6E&RCORJ7NQt z=)Z>T^A3rBbt&lDeB(;-`ZTl|YGFYBQJo zgQ?mF2pHO8f~Ah96Tp;dS0DwXMANuud`K@#s?BOud+XejwWgA7;+zlHbaRZHPXj5= zEb)@%F4g7KP?&qC4f_+XKhpGn|HGKzJWcmvJZSS)3?`_lKLVyILG7J`m(3iytwNhk zf5!2KBm2yX;(^7q_UR~HPfK8uJ!^t!B7bEu7jsG; zbImjawcBIrO~@D|D2A53uJn~5s!C6a#EBi7p>g=S$7O0W!_RFYtIXfRl;aH-Y= zxAPytSa7Rx5%JcR8457U9F`^ITYq&+UMj+K&eqPzeKK;I+@w z8)o6Mw!M8_^c6z-qDX4%K5eBxJfcs4N0cF#W_QI`2%ZesN!0;{P+dJLNK`B)k~x?H z)Vb->fxOz0rHa?c|Dv^8z4Lpn>Uhs$lDqNhRy~m#1Hllf_E;z_VrJUE=aCNl?O|L@ z6X8>s6SU!g+3Kf|3dlZhbI4zoRk5~Wd6s<__&{5k#oW>Z35^cqg?qCMa_=AY)#>P@ z?Q?NWa>Ia5$AZmC;>+LN6u%QslmN16r<$c6o4WEX+ELJ`G^GeKr{-^SH(QY50*!uK zNZzzm{C|X>Ia~?$JBX?o@X`M^!}o+mN;buHC-E0)+VgoaN@Y5a+wcgp`JrE=P=tn1 zggtD~aX{UqIIC}K{N_KxqJM^M0c9i=FOT?f{_0JJMyh}#ASJgGK`m(-V!d@+4Q5|P z63N`OQ%35ZNj;bSyZY#>zj$stwcLvhf}RRAQMV{DT=^rP^Q8cm6Oq=?Yl{3!JO|i- zaSEEg#ds>le?wU&EKk}Kl5L*f78Ck1?51#Hua{;7!Gpt;Op}OzjA~S)(uFG&?*g~~IyQ~4K9a#X`z6{DqO`8|vdCJ+j z{=XD<{u?H$^!l8#Y4BDIhvtZj_qS^qbywx^ER~tu8LZz!P(zPX9?T!qK_bbTgiu?Z zUv1Pvep$fN4l5330vGuZO#1SF^oe7MH0=K8875d>iVw-6aH;0MAcSXs1Cq2ePiM{P zN!@zI224gWyg!+F=AEVQPHoTylLy7{!eH7<5oFKFrj0@^-ro27_j9=av!}D`4^QXc zv)F(6dUdHAShDSc?*0K+I_pIVhu1t1V*(6 zD#_Xj^0Wqqr7kR;uirlA>U`>$xI6#Jglipd^f??)poXD-hY^Vp-lm<^F!1D;-u(_< zi2nJ@tAhmkQAN#B#q^Jhgfze$8!P?f2!7vpY35xiy)rAKm^yxb1IIO7UvJzer4;n4 zzEmawtWHzK1?>||aTJnYYoWyp zsepJEqov}V{*TSa*;5whh(v$^W&Kc2pP-JcwLdGTze2>^v=5lS>@JiVxEi%?dZ&>5 z*(_UY`$BJrwd;9ylj^die>y`N^H)0(`-GxeN1Aup=fZC@AC5)71=Y}hKT!w~UjAH0 zYEJprg#~)=0!qQu6GM}HG=sU0!AIRl6AvR*@{|4?`tdXj>HpxE=syZSTrS+>(wJ9a z;{h)5GmCIsADs@ST*GIMnxxl2l}R);9>cnV4#Hy=H?c1RUwDM%?cbDhJ6RfPU4+bQ zijiwOcK^n64^8wgQgDV5M_Pv7jwAv?&j2nrwtk9ozS2SV1p6#;XW$4-0agCqS$&qc zocW(}qV2mM#3g(}cGxQ!2Te*lhs=hJ7PT9@JXU*z1u~{ku|y@%dBY>nmE>`-7d=UL z;?jp2Tf#$$=k;&ch5>!wpBssR%jfrXAZLVfibaHTmrE#Fxy?SVWOQ)?F7t_$1QWKh zmI|9?nD28X1o~?l{fGNC_V@-hSt|`4+F&?Pb2xPRUMHE+5OI z_hQ=1T~g2DfXTs9@MyKrVw>aKe=+m~iq|{DKB$X#%1_1iNS$kbuGfLg@N-CMo6uv% z!xh~c(^BlaHosGWJ)?pcr5Z``yG{0OWGH==7+m!t|6LuwK?M6OR7)H5-*Kuj^ z5@%d0GA~wlAMv{zOrtS#;iMlYT#`fVYj`RH?%Q_C95YkJtf7!zFOwmpRvy5h@q9-A zTEd=g(kcwyn0C&_4)+8WGb!>@S&GzLhK|k$IUKHn!gX{KHJL^ zy%Caeh?1@L%j+sMOC4e3U2ANh9_dsvohoFNMcid4jsUtu@k>w z&<*}yFldhSwEE5e1%vh;Y4NfC7o%g&dsKRkC2>I^z5MoOw=H($3b-^7*0iL zBdxXiQfwmv!!dHd|IN2v_LslJ$v`lMQByKZT19UFCA^1#PI5A z%d9KbsVTS&nR=8Z@RqN)iyFjxxmXGOv6nt5*%Q81pC!RMcJcME@WmDC-{FgK+}UL| zq^U=c@$m%${kLGNNA8<#{|KH%y$q}1vvt9D#ihPDsL|@XLa^h2Jx)|GK`j&o`};kC z-!#FlU9pOU#em(&md=H+Vg^^y^_AcUU(xg(BR*jhp@G=sF|3e0p^*-6&N8b?a4YM1 zR{co-Ly74#rknEOezu~c*8c(V{2fU6KM>DvlQ+KQOA`)bx45&44T>97E%Pjs#jmo} zO(nUb=Avij)>)Ff?;i;4L80?2c`$owvH zW;^yet6E%P^1K=pN8c6SHlS#eeha*pyfMGfsKm)f{r{?)|eIgk|w*2=!np*FP)s9oLP-y7-oYL|$Bn!g z3-<3z78+^Iz19^}ArrJ*R}yJA<4LtBnb`6@Ogz$*oez~fQzi9AVpQr*Os36x+R)ky zPDpL|X}b4~SFJtoYeU|c-}Z^1&{xIe{i_pGQ^cO>E$i90Q4zFf`Y*^%GM};V?h>>W=6J!E0T? z-E~=<7*Jbct31eJ+YR@i9s3X{`FW<}-&WJ7n>6*dLqh$^mKvX^!Az>f;4I=!`UYpP zq11yp1yzR@(f6tkOb+f?scU50MliHvpG6VuMwLW@P@v*+W$+`s(_7kcUG=~Oao?8m zep^m9w>{OJ$jKznv0ASn(TG?N#(P(IF1~Jh1)|VqUooVP=7uaC4nMvINy0pk^x|SJ z{n;_KX0ik1E#SPkP4#wP`}Zagyzn~(PL%}F4=uyQm^N8(=diDl8$im&%euvzJE*!Z zS5XbBf4|P|SJ2?VYimFgrg~nkd!10qw`FZHcZ8;eEfF+7HJvj z8+nZQ;)Ju_=_l?kh-pwkx60PM5CMDx0ZemuW^9vXg?{z^Nq2@X?Ke)6=0<;?u!V4y zQYf8**$jcI&(w*VvDQ`nNhGop(X?bjo@%0NzdqFX=RvK z!u@%7wnNTg8+`vNO4pvsp-H_T;3w6kBqG7vEi-W)zHe9DY+)%Rz0($iITyb&pD>!1 znkb1Rt^p>;+F$Dw;JXGG%-^bxk|?@k7NUlefiAktgo^E5Ah{U<`8rIbdEV2G#Z@e# zUnL&6v*o-XcN%m>xnhFiTnhm+=YX)&llsfdSv)a$KHu~wz98cwNIh&WIt@Zuz5{-S zd07!l!FE$yh7ZlrqqnGzd3N53at%>orRN_PIcEWHvBi(6r ziGgH8$q4qW%JGgm`Np*zcA2;gMqZcRoMHIgF7u_#%r4veAA&KC&JM{>iBd!%&uHHdz^M)R(T;Pe`9Qe{ibR|QyZ?4fg zJ46dPwADOr>b6orH0yRo^7e5RESWbyGfcmCux6RxIvT8NhNhNY{sx|YZCV_RVjPuL zO35OjyLmM5`P-Z3Z^E3{6XoW|#Pk)4gLy-dBWfw?O~cVb)L(?J&mkv-{!bC?Z)%#1 z6fwWnNr=X9e@`B|8lq-$^VJEPz4$5V)N<7%ekpP%ODXBP0oN=kI_wdILw=9xQ(Wi)8fSG(I`{1>T1Mlk z#7Uv*=p!eORa3~HY`x4IzVsF-Wcxr66Uc6pwu$rOY*K9EY)nR3JI^-$t>5u`xVso2 z=d^}gfFu#o|71qH7HdF7+M6-IQt43T76(4G6x0ViiLLS`kt|1K$-9*%Qc<(1Ueuu5 zQ1yMxkwX?t17!RhIIT0NKnNmq2Netfb;M@j2q0bRM5p|J0E~0X6vB@BpzC$16|it! ze_6QveUkEIBn?nqqDDBOl^M9Z3owsuzu9yS#SG$oR*WUGiP{h8hNjIbDWga>DvQ`) z)7>nRnk|z?d@XeD6rcEpt5;Awm~>rTNHhs!sR2 z7H~g4>#oP_m@1mkYx`&j;uihDT33yOI;!rrG54St3c1m7&*d~AFm?^M~ zcsv}ED1(atmbiq~KcAvxLRrFl|K|Gq8Mt%d3N|rWZC@&MZ<|iCmuc+Wc}lMXNA6l8 zBPSfhw;ur!iT@iW)}jQmV-iZ7_+3^;fEZVSj~fAIt?rbFmNk-2$D5&S_*fOEEWRPq zWTBI!(JTzKXC8Z?W-d(eXrkk>h9gPal{Z~9*n|ZT=xGq#yc^qi|HU|{ zFl>+{Fhy;2`+X!<&f=uoDvld@z!jLpr0HMV2Jfs{4++R>C!u)Ui_xMsoM&1}(FMmj zk-SN<@gkte%{WGu8kD?!81Z${YQ_->Vjnra1XgyJJlbe11ZEHXqE%-R-}x4|oy00# zv9I4h+3;)1UWExTGSEAy z+pOtO!f}JST(#)<>Xp6~g5unL!V+ndvpJTSty6yS=5q6keRpQviMk;mIEs7l6auMW zony4KE7bgg|X2HAya0jJs&V(jD<5;7ON2w14I!GP8~C0j*IC<=tt_vuNpH6&THt>8;%@x3O{TfspV5$y;PbZXOD_iQV`HgT}_$oQ) zh*UmKyQ@_XE3W?waGv%^`DHzh(sh|()cto|n~9@2M2!^?&J(8pmvDZ)2|$GsRUIRt zro8(G^B3#}Gvi>>J^>*lp8RbM!5Qoe`cfu(!>7kXeB^uC8vu}DH_@Xn2f+|~H(=Dy2E9OZLin4^r_AuLo4bKLkC?U)Wd-Wr zUxqAt!8B8uk!5p54+m&lJLMHps4i`V8m9446mn_%n#qtAp*nf1CiZ32SSbZ`x$msA z(13fpMFCv_)n0i|=(Tmr{H*1xw-rSiuU?plQ;Q(N663g6w2VNE($hNmZv+UEtLcj4 zUcN5z{OBQvkD_-&L~0lFPix=#G=$}KgKil(ulssKl+HNIoS!s#qPrcqnkHltveOv{ zQ0_Ryy=%dZ?RWR>&RW;My36)ng^34EZ4?e?>KTP>rhRw-?ahs1m?1PZIii7ixZ9Yy z^zo^v+voyWsSZB~C2W;_6t+Wi$1DueCCBEM@>1?KqFw%?^LW3pa=k;n?dlnJ4$0$3 zdqj0e_u^2PTR`h4J6KVuFL?zJP$E3fvlZOy7VgP2QihxuY+YXk5~g=xK4>EvPD3z} znR{$2>*BC4vUv4H!qT>Z$qNC*vNjr)7zI%{FQ_Q^z9&llTd?(eDwuF;L)FF2oXt@( zV+R&p#7f_-E4Dg(Ff?wpY-h+P0YlKcQnNG)UJz^{A!`KPh0#6Wq_D`FUM9JIt9&^V zov7UCyIxj|U*=QHD}NcA9Y~D5`?LfT(SYBfN6%4@1gOv%R=i`yhp?LVv@}bo`9(>K z+SpQWhSuzCfk&VOdH;^5j(1aqKVuM|TmWNs#55~CIGJ|824Bd@oG8^et{X`2%N~;j z7@b)jMFLR;G-YnPi?Er8Jcy?`9H|Cn9Yy9$dGjz!vWExCN?Oy&rpcP>OR0Q(Xno34 z&~x2a9?Kb5W~q$*uu0%tlW#!1V5r&s4i9r?oTmojZRIW7N>eo9f35VqKHY*bTZp$SXuS5phxs5F}hAV z#f`bUU_xrxd8K22Gtx!XJP5H6Ev=W&qtZttF72awsz_Y)xt%eTH(Kko6)+vTI|1HI zDk{n+=1kVvQ6ulRje`>{y_lTfy%q1EYEZUu4|742vd^abFHN_JTr0D7-#leQ{j2=( zl!;8{#LB$GbWp}K{NNWC2aW{S?uV@Ux_oXad-%b922w9;nIkj8A0b>%C)s*>2M?`(^JYnkX&j;;Y?kPh`?8EJ%OOd0K~RuY0G4dOLksT^ausmvsn5UX zkT6erIkD~W&rIDTnQmdvR2>WR^9l~pE_6u9E7&grnvVL488h9>`#XWQsHbQe!RnXP z&$@&c6yTR=6hGLOGpb4f=;658cl2kYwW}6#pX!_Rh^w%?9UFqe9%8Q+acVy5S_-Qc z<%|0un?P~pb*cIqHKgzueXtVmn^cR;WqZ_-An1~rWnGlh zyW!rToFdD(?S(f_cgjmG`}sVf6sOjMJ!I2EX((e zF8b&$Q7qAx!T6j#n zQMt&Eeni!gD(VeHC82tSym0kbHtTk!*o=!{JTy6He}9=RK`>XDkf~;d4r#k8f`0eo z!Zo^ZK9NvFA?gSMuKs*aq(Mp%rD=BFIyP6KYQf+d{efDiBL8YpZ5>lb}TG;jQ?S6Cj zNfT5`P4n|*GGld>5rIaf?!IZ>yjGE1x*-C7^A2=F&8vqBxwV!h+VEE^UtAu^&lb{N8OUS__(-oE+5FI8uVRdH6QLuBoZU|Ft}2=@y-q!6WPZ+z zAf>ID$d_o*k$7{iGx0O2H)za!IG*EmaLDfa_Wv|yK&o|S3pumL9BcQYA1-Q)r-)Dj%u6yi;@2tL|-lWXz{(xJ*|G7^PAXrWQ) z_!h;EVqiPbg^2wuqpBi+TgjCYP|u}bDgDwG*7|de)`g|RKi9JrQJ)38Q%v_gk(9hcg8-&W(Z@+46c1%cTTU{^k}j))bs zU9l-=Tme}$OTG6~lV#tkESMtOuPOi$kzw!oH#JY>cx0IMEI?MjO%P*YA)Sm}qc(aNJ+z+i%xZxg&dC4d7ZU?ED=^ z6-C~B1@tW>?${0Uy>&39Z}6neYckAhl4nZBtQ;s_*wSr!266MD?$<(<0zi;DDkb)j+t9^ z_3_ddS>nOO{z`nqEnKw{lFtESOV!QfJgbq^+jYD2gp1B5QAobn*!rFj2V)!7r821?}i=i96#qrLD1M0cD z+`O%*ySNXc>L}jOViQ|oST47db-ZU&&|hu?RJ*&K3sH@wSjVp#aB{G(I9py*e(7aa?`IJyX=q1~&aB z+QQsOQt;-(;K+{(@J~Hk8iu>8u#2?U!J#$+)A75i>`SPsHQKw$>!h5d-GIJo(_Zot z2gYM!2`&Er&2?f7-DE>FgSx(M>u-KH4&sOKXJF<9MF>E%qxN zD>DpVuRI)e&0Txo$meW5KH(d6m82_$eIsE@k*TG*<>f~L1*HNl}5Qy-9B}WjVY*ik_u4V7lJmJ24!W#hsp>W+Yk{sW5R3XpH*CDvBV)o831IGdL z_yVTtX!p6=f||feQM#s}yzE^FD_)^5{KrqL4mU-Gsq!mO>&~dYL8q?X*suFjAj$(g z_}64HTPo=OCu@>iP>~7SJI_{`zlIggMd%*vOn6}QMNy1fxVWL57`mpAgYAayJd(37 zx_QR@VkGvxYVZB8G~L(9lV#shk34?n>vx{HV{wVuT5ac2qLlG%qqPfer~fG`vJGQC zyBl9C*vBR1^V8wLy#QF&GK%=ZnbYj*=Gel*84q| z?bQN_i6Gp~V(LXgx)hi?TCkO#b#D(#6qbLI>XxM_6>!TPl(JrEe3D=OSp-ARaLA2qsDy+i;dwdg+mezCVpAbsnyYgOgJf`~J?W9{m@;yjfg*8MWT zspR#2HOm_&pY5|mmEX2tT&f@}-Z@!?`?$3c&}8H>{&RzY%- zYj*kO3n>|`{q(h`9Js4_I?0f9IW$&we{Zw$i0N8I5${&CVW8=p4ICs0i87g;cy53j z31+Gu@(;~+TQFPL!dG)bt;G#EPIb}eyEiE73L@tXS6rra}|GN_Jjev^s!# zf7Y|->n3r(9snp>xs1D z>U#}VOtC{E7I!2_lgYP+pS*s#Yu3d`O1MN2oFvOGmkE3*pBZafqQ2{#*qUoS6zNbM zR4nanLZwBp*$Z>SKEQu4u~2z6m0saWG);=RE$DC9nY&FI#crSISz)|)Yjwe;v{kL4=W@4}MRE$mTu9Pt zc*gz;;g3bv;+hvXKGApnSCy-p&*lC z?h~!-MC5HhJinkNefQN9uZ1Mar8c&8c6qa~S`+TU(q^dzP5Xuqt55fmUZ1pV_X<-~ ztD;KIO%-$_l83gND5-IZd@0phOgHvWZh;vLEC{nrLTw&C9$CRAMDv48d_JdYhuwCi zCd+q$w2rkrfWicCe_xz{a!(pVxmtQuj`Dq-&l!XdBz?)WW8>#0FOHJx*FgVd5-Fry zhYc_^|NOdKN%_kG=WT~EK9>JN{#S#aj%+cvIAj-dQ`8iD?82>SXuooMu0AW~=05{j zx5_SWD2_$it#&e0Aal(?R^w&qZ;agZ-gaE!C(ow9k2O%=RD0~;nP`Fhc$2Mio+N#C zZqx?zd;yG>Ud=^W(7ugbN=S0gr?fUb4i~OUUGJg3IMeDjdZUi`5GR(H4LXgl+=KZ59?()5<1r|@V_F&-<*o)neRntxXnN?N2jvu6!)b;0C`QF`-#FQEK zr#>6TQO!=ei_E&S&r509_zY~qbmsSS!NpBCwAQ(RGO-XATzc~a<0{iUNXfjVAhr*x zF8P;+dlq}GqX|aF!E-j{Chf(1(f0Z}xl@TmwYft9*w{arx&=3HxDV<|FXBtKW}EJe z&!vtC{hIw+?6mtm`t{g3cVm7;Gg|sxUb)*WxQ;{pe&za~1=`Qwx&EP1e&b==w4vLS zcq4{=5Dgzr>(YTXGT#_WmGGG3?kCYN5 z+aXUJGQJj*pg-OnN|A5VrH;(*ZfAwmh@u3>-Y-Ry{vpXE4CojsGN-qMs670+iwaRR z4D<(cVQx~Sxv*kj5=Q?5RpW(`!lJ7hS47h)B3K>U%dZ9g9SpnsUo8QuUBV9zlE_@x zp31}`nBppDg>F0^`>MO4DI+CHCTi?j4Y}BsGNi>_0oun)-JIGcj^H&fA2iNiUFfSi zEYUS0vA0~+*PGvYv>rpAwbBhhxc$hklQbu@V(*^v-QM z7e6&$zG;mO_N?c7H@7sm+H>Fw@bpZ~QDq)q5MDgj14DN(Qt4j`Q@aUV4~V9Be}~6Z znE3AV0q7xx2IL{-;iTGj>#fzAEq`zU zv9P?7UXz(Cza+04aIsITaz|+Q*|clMooy%>jp)-o0&O!6@Al%`xiqsqt@n34LWXRy z+*q%d9!KaVh;2FV36}ALnKGUx1%U+D-2KSu zzno#ICP?nB?B_f3Nj$u)N$-_*h0f{Fr5lN-EFbue);F* zFNO4u^7EQ^vT7xASIhhYx+g2h5VCtMT)i<^gmz{rel~12$`$NJLtpC*lq*}tUC&eU zZyRTtI@2_GR1LLbe&>RIx|+Wwao%Q6v&0158GGs#8~;(SZ#0Z#6})5%XX57)aOKfW zB^SSUnunJ?Ca#RR_g@rqLh5WRa38Bd?Gv;6IwzNKVxbExH2TeF4RS@LHqT8NPvhjw zxmn3>KPBIDAr~j2wwFhCyiJnK{OWhiF3kDbz8Z5thN<$>V%;Z=Qt_X|WCj&+pIN5p zxr55_e8gElfe$c7Na;pG@j6fFIW2TNxf$wA{Kk_@?gisU4C%b4iKG2W3&)tUb<4l* z?Vcxn&cXLaSsZOy!^n8pLSLtsxS$W2%`cqTtJ$O#Rfr7;pS+e!6 zCnAqt$S&8INGf9BkyNW=m4Z1U&&jh_j9$PdFjp@#Fvp0Tlh4!f=!0)G-V-A>I_`8n zH`l?PH9Q`e&t-X&M_slJA>e4MV$N2>;7B(_WE7wsId>fctvK_6yOvK6Q#PNe@AB)T zz#-i(pq-9i%6^Wx2?Cu9ymRz&y>ni*1(BO*q%sm3z!4`ME)jC^bB;CLEHbrE`de4x z#8GCRLo0)_GH@<5AG-3 zzwplD`|R?XPS~JbNsS10MiZMak1?E|(8>&P6Z~~rb#Rp(oVp4YvX+enIS@jX@BSRVDxbSX{p&JJ@_sqCRu{yYU8D}F4V+WpDn&79 z1}Hv@T|> zgZc@Nc^L?!DzlF>R}>qpw$*5IGM7R_9DDJoIa}2$H?2&^3vPrlC2gLAz$&D3&3n=f zFR-12%vU17qDgA&a(gMgO_N&;meS7HU11ZlXWX8BpqKe#i$?k z*U%pT0n6>n8uRa|84lbD7{d!>b3Cl?O$zKinI}c``?0_&* zmHj(yuZBN^@>pbW2G(wfxKYnW28A=65*;^(K^a5_+ib$SZz~sS}f_0V3>m zWHkB)xwFg+O@n2^rC`>j)(O}m!~U!%|NLkIz$9Gvi3B;cj3JWl5qD6vpZ||UZF<&m zf8}#$OeS!j09TUwLv%gtIc zVOSbx@&mpdSMg}gk$WRf41ww@r`r_zd!hgHbGLq>eu*-!n{T5KB_fh2->ndzG^myX zlHVphQku&B2X7$?Z!i`ys%ZQ5iR!8*cc6=mq4^~?kQp;fR|7YQ$KIm1c(o%U%2TNw z=rYmj35PUe8T7%jShs-|Fo<6`If(srBmeWMq=PJV)arZbkbrR&+nC>q;&|k+CsM}t z!i>=vx0-GV-m1%KE~XA%eP%3wBw;kWLq$w9M#%AN!&O>VTDo}3AI~#NRF%|YIzi-+9@$(5c56Q1ToaKZkY8R=Gc{mw( zM${gLzxUtu1-4ar;VVea^AD%?@juyC?=t zS&0U2Es^n0oyC1={!!c*=jye~CT3|Z8LdQSX)}N1e^*eOBN2oUFqRiKa z4PF|x1av_?Prz@yFZZl`^(Xy|!0zH}?(qd*%}p$w=cmec_KzPrw7-uL`26ZmhS&VS ziEaz|2he4=dn)8d=@iI9D^>4)r9V5vq(m3`^3E~2k001C$<18qzC?fTyBC#QFYCQn zx=@;r45sYY$U}l}(OoLPM^;H#8XCtWfl#8U(jmfZiI|xT7All)+#K7pBw>O@ZH1T5 zK9p0J5yNSnb_UKAXmrh;K)>!S!%rpn9g7Lp(d@)Ne;0$ z$+w@Lz2qi2{=mph`?8{cksnNNPbrmlmVG@fObvQ(akYt$6$7jZr%9NFsJ)oS|I(WN zrl+F0k1iK$s7ZXJ9W&G0?G2dIS&PMK55F4mt~V=A64yPidsQ`gCQQDL0iy_Xj;I5j zqg`V)??#a%AHWrO>Ys-*)!sEeeY)eR^SlWAyRu319~v=sOf67J7i;?(_^r)Vmb4&j zHV7RLV8r=Ydwc|XXHZ1>pY&F=*-@*qFgUaXd<~tsCjsH?DaE=@CU9-*n?^o4vXy6c zS68iTro+#WoQ@*MhZo(7pZC7IV7kFpd(t!5kNa8d7bm8g5^>*5r^YKktqR*E!snWN z>XM`#n9jQ+k!x{7<}N^)1O~rILv+t)jPJ7^^n3pIIkNRV1a$-gVk++oHVObp)AjkC zCY&|mu{skG!l~xzn_3nugW`fN`0$C2rpeB1cZa9_L<_@?xF{Z(vAGq`kpSa(hIMYw zrJ_}XGJo9;Q6r?u>!zp=0qA$YOS|a5T^gF?!;xUjW7H}vuKyXo!S#eTot1w%9&P@U z<587C54m!V;!Q|5saX;XePbAPQUliePFn$CJ`*lRH-B^o>708elx8|sX<+zM(EmB^ zAgPezsMReqv>0Mg8j0OP!nMw*9AvG=tE}JZ=a+BK^@r*=u6WB|;R&>DA4_;Vl<_NT z)tgbi&4fM0b1nG3+Q&1E)bGw}{;v*$zR#K%W+h+*3}St1E_w;Z1%Dsy40f^^#}azS z=?`yqOx>(^?DhF}mM@gxTcFv6^fGTd(YWGiIw?8g4WK(8O`C?%8~DW=x0o3Kz7euG&kN1?g3kvN%pL z(>tkkP4UAHjqgM_FGxu~kH1EKFOZi?`8?i~KW@8;qU}vVlX9#(OD64@iw>YC{~Q~j zQGoP1(8PLFn$O-KCO*-F?_b|?u)6cbU36>NM2FMcB{xxH{7Z~v2H+@L(ND(~5rD(#jI zvZh$xpA`1I+RBg;hMPN^GR7Yu_pC-ycdMFD#+O>O(Uksg6*dzRByICf^}tB~=hk`J zK)z0J*+IBvFb6XaZP!{DhF+G^di`$qB_JJB2dK4odvTWF;RxNLpokj&tnz!Ya}YSH zJ(gc9?ska9(&xyi_ix%#?eUOY9gLL@$|MWym^-3{J0irME$s+d$--5<0{$UZjzQ;( z+@B(5h+RtN@*@EXV6}|d4oy|3N>=u8EzjeM0#Yf9Ya0v|+cn?szbO23h)77r8u_$0 z%Z_^TgZ-~q%17gf(a^z9xH(71OMyc{J)aIr<@>`LefRO zY#;DyEF@mdDO(_3mhRb79&l+~^wDJb)tkLQCF*^RuP zXL>yF**}rDUjXCTm~y&sM+#MSdrY}!5cEWSWzDtbh~09j2d{{^s<|9U*+a2#zHo731R($u!DA&pFCFmtIvfC{cf zDmzoeHh+{@S^nz4mPl&pY~A`+z#;&he(TX|jAqMh5%d%%+-Q+b)W2R$Gq*Bm{-$pKlrcK%-%^B82aCQ?+p303Cqp{p`2=Jnf2C> zQjd-_b--oIokcPw#l&`Y|CB-pP8=TZnA8GK+WN}5-AaP?E=Al0w?rtn=*|giqyXEh z@^m|*;bh`!gp7=7Jb~M-Z~ce_b47YEX|i~W|N7v z#~jEnZ712P>~g7cRZ%pdNf=%?pVd2(m@7@*9kuR_maAW{yb*7nUgRi=NWD@2IXK|< z~7jsPVnYCnPV6`5ST*G~7XpSSVHah#yM}Uh6V8CtyZAr6Qe5}4JJivDJ2IIWa zZkCkpmIQ{syvpn1J~D~ux|XGT9b9o;%!i+?18pdfm-8fiC)|2gP*adJom%E7jto=# zkMc|Tq<`F(XgYa?8WHvS|D?W5PV5HLG>x4kBf;w2hkv$_=j3lx%(k*J^I*DkU8zn4 zX8(xhl$h$b_0D!*FthmCEhA_7bTTcVGxGN>F~Rn7E5T{h*Fq0G*!yi?f!y*lIAmp@ z=iY2-@IwLvGd`CpCc;?$y_xR{gsAQ{w5;ju24z(&Le={Syg?I(wLRJuR(zb8gdW3c znCN!9H>$-rtFGJ;r!r0|Mw*3yyA|YLs3wWd`@IW*@9|GQ)&)Cj;UAhK&bM_-ei)_K1Mx|j+ zZwo+(+;tZv;D{Po?kd6*=mcNfY4t8NYkq(1T0S@?k?0#c>V)a-LuHvfgKh3M4K11t zt@fj&Zf*|P1b^{fSd_DYkfZ8Joq#V8_^;opXwq2}+^giNm)083!9abLK=Dpj%@_%@v`{ zs(Kv`5Vs&O&Gc~pfEfbOm3>|XMkd!_n~Qd-QU%Oyq+$2-iy+q+q1lhvF97Z3<5S86FNto(T&hg!gSX@a?*s(~fcmMD|t<9hOj zBf!BoLi%5xJydornj)!+zWWehO|AfY_Q@jpl^>Fp<{XuyJDAOMJ;JP2^U9U+;FXa+=|+$= zDKdBhnGV1==C}QZKMeoO>d})a-#%0!1*RzbUS2Xlv$B0$A3d*4#d#{`Z2M)j8+i_t z*ZE0%lp#bGdL~aX!7ZLww3)#mUJZ=mAG#M{XnjnAebi3Tq~rR3P@BR_%d;AQy7%T6 zd|MD|{pAn2MJsQqQ?MHdyARA%Bv76Crs(H$q(+W6iSFy0R8(B;l8R?A*dtK{7GDV9 zwzP+6&jnQ3%nDVyCGGa75+X@5S8Cav53*kq;z;x8OyeQ9>l}R#e27_Mi}e1NCdF($ znET%nU?dBnr6x*-9%iGr{F>nun0XUo)b7Aaz?-@L+obnEJ5e>sm-X5x3J)- ziEXTeHmmQ)7=#(%&W##gBs{^oh{k2wdNwWfG>OZTEdzo;y;e=qgDukg#?F00=3`AD zJ6X!vC+_lLdzhkDhnwfGQ6C#{6}Lg;);@^ZJy;(cm=5DK$9bh@m%ezU-#d(30~G_K zZ#?Fh%K^nO@aQR!O@0V%M>FSH=ddlC$a5y?n1^zr-S+Ot^Qnc;ZLEq;*sET z^9GP#VjCAjjfr`20)=B=PiB#UuFr}~($`h(Bgumn0=Cr!|q( zNX?WJEr70qIpv~&&q|QiI#zdNUKh`owuBQ>F|{c0%AK6KFXSTY&$!=@C202r>OoXL z7T&o87&%ZAn)?1JVj}=p|2TV(ydS3|tqO%U%d0o4JzkNXk&mEcJKAoaFzfBgd@Ljw z7$zOHWWAuozL-Q@PwmT~730r3vUv74=Eixn65&}b(sf%Nml--kUL4tnY${LoPU5fP z)W6EHTy;XmJoq2cYygIx*lv=1eSZ|6)qSlA!#=(E)PkG(uWL z&z_tagG}I+rH$Tq_yj+-|Ah~ik(5Zp$;Wof2V>S}To(44hxVFBNTw)b(H_YT5wCbf>Qfi14u$D#!hJ%^W0^73)`; z56ukNh=YPTf?ifziG_QEF4l4VKiCVpT1mdM+qQ@&E2JSKi_hwt;8k*rzh(3}$Etg6 zfuoG|V69UCUDp}Fw)2?}9wXbnv-9JegdWRM*8`vSZ5`u6kPU>Pko zcejf&dUh*ucL^9VHXZP`3^J-ntnsmS{)88vxzcCblsWH<;(>Zo@dyoj=$WWM9=F-E z?fGM}W@yJ_2IgN{Ke64s25>Io`x=H_Cy)j$+MVp%-Tl1x^bgova0E&8YFeCQ9~QvGdgc+`CjTHpC&*Zhb3HfhwcFZ_k;v9d+`?7l^M)V8;~lel60 zc^hz}BAhylxq5^J{49if5MM}3jxl67_7im%HV~2c92dVnm#=K066nyY_pRPP?(#ys zgGGOI*MrQ1J-T_&%eixbqffN*`wQzhnYKD3PqNn@uXZ78s@=HgHSf7PQ%SLLY_;;T z;gS9Ivon0jisqwHJj^HdSDGIJv2X?cl)&W6TZgSHeaY;6DJP_+AG}|)XsMN!G*Ta= z<~$3J42y(^D-uRme@3MJth-?QAAjp`KTRiz)~U7AI!{V`mDWqA%EGHw|UG zQbsq8NTwE%JY!+&$VaI!PMB`XMQT|x3BcH04Wt9sdsMDT@x!ySH(q`d)~}!n9lG5+ zi#1p;b1$H^@!@beWCe7M)nDG|PI%r3$Y&{R+wvvN%2#CreeLFFm?x0_?K>0$;%tZ? z8#`!$uC1PIj`JpQ(|s0aWleFZNnrC*AW~w7=}%gz1)rcnOKeL?b#j5Piv&)WH6VpA%aZxSusx@$nS~oBxLVO z6_->{rk+Aj2u%3$x@@j`BDokYGRgE+Yb0h0u6Bq0oH=}55knLNFW#mB*8b>Yw+%kt zHV|hBsv1v2cL?8=K9K6BXCL1~+dPS`fLN=+ zBob1aOVFQS8Q41tw6~og)a@zp1YkO|g^=g4=~70}Hcdp1nE;UkR|~+WMC=kpHCH7e z%vqO|Qf78AnYTCi*#!L=<3uesU)rwst=~PQXrnK9ZDFA9ynbSQq!|;R!3Df;(zb75 zi`K5R!VOIDlhKR24L<6x&M=2HfuHk96%G4uvb=;{lrq8Fc23&afrq_kEz z-@X$VGxVR0iC1jwol6yId0xJ;$qS77m8gu9CP=r=BL=$oB^k z>qp6U?&CUX3~}MkiAom7gHf3Qx2oM<#3$LEK9%ScO*L$674 zKvQT{%yemuJ~Sk%u{Gc!>&4H#X?w<3rX0QA#?4wVtbGgA&yj^X~*8G>$CB*yjuUh^T-UXY8Z!$6T^Yv!N;kZ)lNHGk9)zhx!dWewx%z? z_uNCD-r6E7;*;S)BB{&6%-EFmbL2HF(1S}S=!5GT6kE>9d_tyg`QF#y=hk$XYdja- zOQz~nHDulAx6N0q>ly{h{K&b#J&INEeyij!e@j=Q9dDx)6`TpuH^UurMl`#b_#@9W zDia#QVCVokCN3kP?DrPV<$;Ba}(mRdk|Ba%b;Q9N0rPXK>c` z8V$@PN55Zq@WiJt!;uOe86sLaQ*fs~yA7*|Co!WVq<{nsW-jdXN^-&%?+d6Cx@$&p zy8)3kJ_6>X$oubAEReeVYT=oT-NeG7%1Q}vXZpHO6bL?|;muC7osjx?Y->v5wvLJNVArVt1R&IyG6I2CI$*7GK6sm7hEBs_|%7w98 z$q(f&*j!5fn<>g(cWY5T{$CMZ&Z(jcLT2uKYL3P^}BDhkrl(%l0Xq%t&u457pzQX*Z0 z(%qfXUBgfV1MfAcyYBNo&-**xe|C@E!($ij`?{~|yw3Cc`F`Wv`d0-O^xpcUn4~~z zs8LAVdG@P0+SoCWoV)!^pU+!!Xsus4t)s^p5v2U)VMlpggACbe?{_1MYDKhdVr%6P zw1gGL?Q7h^PTrS*EOkFFm!i4a0K0djH@81X)7{timwLbbASuz@8t0_o$oT-@Sp1?2 zMhktW9>oVbQ_A(qWuB*;n+9p=5+QBqz3qV_k0}5B3p+%4SYJWwdnLy@SWsl%J+0ji z8pzE`3))N7xD-$OOfcd-=39^{e~xTs1oOfDMiQ=>dCi{?Cl&*c?mLCEs8HUuvIk zP3-^7U(-7A(^r}kNNBtxI?z7Bc{tNl-Bm{wIbmM5P|U2mqic^!e%B-xdM2{6ohx9dYhtq4Ep5QtZ%d*yp(1>}z3 zWXVEloX%%o8q>kyzj2XXD``@>pwAJ}C`@WKE8|AMWxeHUN<-4~mnn`C&AKC~I3obz z#rt(-OXV;F5{Q7DZx31f?r2Ublkf8AW^^%Ln%%>A*7f=W{BW*W{@a#~#)hS&KC{LQ|IZ_{6k><4}`HzHK32j%5?va@#; z8+1{uTN?|CLI&lWLDa(>LaeYc-~D-ca9M6PU_v&rFxEUbhFrJj&vT2r$AzK2zJ}F# zbF)YrwiZBr3?_;B)JuMJ%F}I>xu(}oiSU7FRx?n-WqiZw z$oARL8rcXL_0*ehOy9~k;3gq1UCgw87=t)vCBS~QoyX#}~xS$1`e zX1q1dUp&GJeS?o~8H1?Vg5UzM_~>`icT{-2<2N*Uhxa11b(wa5PwowAysO>;x*|tK z(c*2`)R3!%)A~)G%^+)*GtQ^uDU*>3c72pk4~fu%cM6QW!~A5kyVNxw?zOtBQILY>ydL0=}xBRO9q<8G*wR!%Ym zaLja`LKT+N?&`7kvPS#tX(TAaTUkE}^iqDzC+Uqf=nhaWx@#E-4+uI?LHX5{YLlL} zoIk_5B!D;TC{*dT2q^EH?NNnVNn$(uKso=M7I@LgZ5cA{$2=b}tc! zlY@NydxpFQnH&-mMK9mET&8=^Cv9wYdyJrhdJxKB9V&6NX+P89vopr;+{Sn#=eKY@ ze5M$7U9ks97F1F59aEUXbs%A?6Q9yw6?{l~m?k zivc`m$sCj@iK;ZQEzEH_2^wR6;G6UHQvId*t=E5RErcZR>ULn>2XH*pP`HuSb#7+I zNNq30Ve&>`&aOTy*6 z*vyGf`?4ZmKk6Ab$;#cevhf(Ug7=Bc=wPxvK?v2-4^g4y&z#`T;G1qTr`Ioze3SU_ zJ%40}HDeM@N5io8nj$UDkiuYzu>??_@w4n)*_o2Q6^ANuOdt7z{}F|d@Dmg16YoXM z-a11O{Vq-WMp6WnJ%lYtawdw|vNzEc)@7EG-Xk|aHWg`B=WsaDSRR&#cQhkPuJ??n zh+SYNbyHxalvARj5F#H_-3MNK7AH>W73;{sSvL8V->J4)1P9&3(7miJ+R7bzIWi;0 z&xh?vlPstxqtUn;QPbgK-fzVERwDP&t-ZLFI^7wnOU{x#~nT-?!r3o=tc*C|x4`E9hO7^-%uK7-=Q4Ow3<5$lYQpIr@v4 zmY#Li6x6*d!mqz#)yYc!dyq45f^yfVvO>ha-yV4@xQ5DToua5VGl(3~g!TJHmrq|k z9y+bG+~l~0UG`4q!a1(21S#RgYeWF|*k;=LpfNtJ$-i_|{J<8@lFdw|ZF`4~Yx|3` z-n;z}!Oveuz@_yVod4@&_DUZp3Rb*yX^R}Lr0w3B#C}ewG0)zw!jPj?o%tA(5TOio zAT}229f3{Vx3{|C6yy|_et-VK?dl{d7nV-DzUa3J6~)zxxy;hUz+mjNv1KbFvs<|^ z*il`>FwQ|S;Fg;NJib7g>+ac#dkuseZ7QbC?iK^1AZ0mz&pfUt-nL}skr$t%gYn~$ zZl=>+HqX+-2^gAKa@&lrhC6H`FgLDPJWyYBC|PL~^CV?(@oLTAtcAIKdv>FI=8P9b zQQ7E9p#R zlaU=p(j3up8!d&y)SW6~@)ZU&iE zy=pC7rsO4&ZL*~f8B)3(RB`8`I;3{0WX{V>Ti4N@jzjK^MRgX(m8j3h)74SJ6Xk77 zv7jW2qCFyNyacM2Vm8GD)IBEh)rOGYu;cRp9#2P(h|=i|x?|e0j=YF#kW5J?;AC)( zFWS8VIGQ7K12TnqX!~Z)e9TAu~)}}j8vddoFzN4RIx%Lxzu~t zVPKlrsta%0SokrH=mYUgP~mZDKXm1TUN7lVVoveo8;HH7YD2-{xSL)sF$J8mOa$$y zmze1BqCjLAt%=`l!8-~g{NbTtxcu^yg(QRZ^TukdQfO;PbQZW9me38xeJ&##SOHeo%a#80!xZ21&4sSL+i{JrGkb1VT_*Mt<;Su_RJ zQ@py{HjR^Pq;1}xAZd>6;C>KYM*r)gk17wCDig@No zQh_8W%gVDB!4+>uz3s17Rrb$ns9H*$ORiBULXe>taJZU#i=V$9Zw{0vHv?ZRm8be* z-z{@??(m?uh_FGSk3}JlDPg@?rSme59(tBhQSxiw*!PG@;W-KYU8!CZ$S_yybB)UW zGzQIAqU`S_CSPKtyZuNXJwL5P6j=Ah|KM7PH=vxF2(2){Z@;Y&{ig=S7~HV?k4yj! z)HgR&(_z9P=jtLCblW2o7nK7`waR}*X&O1us%Wk0TxUA?YY$rn$Q8(Ugm~odsVQXS zodZ_qgLemhcr5VGrw-O|pH^qoDK@VfXq;m|;G3CbYG1|`x|10)uzkG3jO-Gjq=Y6o zDp)&mKzXuXZYcK)33&BJlZejj=L^<}YObN-|F$~cBb;~G8po=6=Hn!TuCNx9ba$6q zxUN;?h^_Kfy3lPESih~=2C`%(c?1s~Ui2dOD+S8>o;`oh_^F$fy-&U#f1uLO)NlVq zn$PJ38Sf(KxY|Pyh)-qAU^?F(nI;uR(&#G#>)O1;cN5BhHe^jy@OMETs*Pp$*!A43 zC&lM7s@JD~U}aPPq>p~&7c!>TRPUk(ar&}$^{@vdYN%II^ZscG+$(ciDo#@P^dRBa z>UrLi%N;Ia2204QR)2g96uB+M6d`k8*GOolZbq}}F%atet(^78kj-Y+p_B52*DkAm zL~?sKQ|(zM%Kjs^o_exUR7hBR0zQW@S~3WLY&bLo4s{z2u%k_8zF^eFp&*~MWF-=r zC`ULbIA^Fm_jyBlhGjDMAu6Pvoen`AZ&ycS1-Ba_XTrBuf9Fp$kt-y&M4;3(srl&R zQL)o96hvfmgw{lyjCfQ{qu+r&cx%>j}h? z;)>6v1f4~C%|zJL4A4#i(d~zfzeTstTFDfSvR+9hIO^r1#JjAo7b5pv(VRDb)-%QK z04i@-inXlz)NYIM5j-vIMs^+;o$q_y_448IjCw7hh;oD}zavdk)_UX|(J#nRqc7(| zlO|&n)AZZvJclREu7R7$>@P8CDk(F^#SmSZrTG6;@_3x?O5{mJ9wH4nwvAPPZIT|W zAM}J5QX+;PoA0aq@M8YjM$d80HE~9G0^!(naT~pF-$^u63;kERUWiK}K3#92(Rz}m zw^u>5kh$i+rR(uWVKLoMCVXhcJH0<-b$=-1H{Sx)^<*GBi9e(J^WoPl2ju>2u2=Ns zfi#afYnSb(6o;fgC|iU^YLdrzm)JY1e{M4@-?@O?@H`Ffd&$|$rzr~>&-#b9$GIQh11?m#+>H4 z5EvCgKznEP>dXKzpeEBi;Qg2K<%|J6>pc<=`=NUwOy^lL?94GjD*Wd3bA(p3Eom^f ztS;XBg9BT#u{sBCIZ1-YK?hZVDH4CI&|eD`|F;&ZldjKn`yE#-^gLctu~baFoQN;h zlM9c(yK6vKJKA(C2ANL$BZjUBA48|yj>4-!Hr`R2D-hZT++YYa45qx68zvv=q>!hG z5-+94EV3O0)esYx!X=tlzMF zQgQU2njzCk`UH_Idb+(vrG_+Y?_m9c!KrV`KjY+N1%qoZO$P*YUyWDJn^#2pkQa6} zCY!E3fHrmI-3?l(knhCb*#F!@{&?^I# z`%?DbU*W&VgA$p)=JNLXl&$R}^w%nOtVc)^YlwVL+tm`l*`~aj*q}rCOY61sgFoQt zh2Iw5&J*uA*h3_@K!LDx+D8Aj`$;9Cg&398fQ(yvn2oTy|FrP_IfMT>{Qo!f0LmSz z6Dj?)Q!*qXDR632%;j@+#DTZsF202Sc*EvXNIIBzX)+XyqYo9RD$mJO`8tM86AeE$ zr=fT7gCX@b<~S3`kot|FQ{zr~2PIfdaMYr)w)uLx5)ie_8-%y#eO1(1abHT z^i!q`V`Y_q+;yHUb|@_`KwR?t@g26|odm>a-kXoajE#{1$UKGb2$49OiN6|10`U#a-*O|9kO;A|Ek1 zcHEH($d#M)YRH6*sEA@O(@3o=xmnU%UYrbIZfgYTRM5R$MTU*{*lP7C8x(iRba?0N z(X1^wmEJ2jEd_jw9_yZs|nPg=vbJ`>BU`=ewRIeDvFYp}@Xr zv%aX0w{PNr<8M^`&BrZtJZx25zAkOXqMRsR8g#9D%P0oQk`l7c3{Sp6Q3e!0`E}GZ z@JH3uO)cN`X>W!|_@A2*G&M|UO6j)U?(BSVizBi^K->xW*=X;Z4N0RQ)Es#%xzLOM%WWQxb%7+ zq*&L=iEpuI-S0NOA;=1Uc!$UAO1wA$`!6>?M@t!>h;~12uM}19#jxn~9_Q5H9JNpX z5G>NqM#&YJ;`dK@@+a*BcYw+rr)@@S+t*7%ugds|Wx~O@HE9CP$<2iFDF1#ZWi(oN zglT$!Cec{ySNUZ}SnM?%g}o+J(zqLn(Ohv4K3L?px009Jx>`~v4`p9fK=Cj9*_p*V zQd2XGEpgJLb|*1LjW&9f7v|ch(QM4(Af4 zv{Q*1j>B%IZw6li729)HY+~ zB|7cD!|XK4D{l3}^t*DGHp7{`Co;Mwh11;E@nLq?wudOpym(N%lV_9@)2mr&DZ-o5 z9i{gq-aq*R6BCkJR;|2M13uf&twkUHIjJ(GPI?|?9`%KI*usn5gREkNqC~)90(Rt$1HLxh6?D49E#s9K`-{#cT5CIvjqP@vq~AW zPc5rTx=ANx+6Sf`Dd4&|+OvVj8ZY077^V8Z`(><_dJ@bd2YzJT5xWaNQLv3C)V)9R zcEE1`C4q3hok4-+y}rhn2Gk~ ziv9e_{6TOY^C#)9h+Z-+9GQN#3-+31?E;AEvz+hwZt7~WsFLu7+z?^I5hu6BoYcgj zgE5QbLq8!)qGy=%yo>IB2HA+FNHUDz1F?B4;dt#}}!&H9yr7QVF(j?r&*tS|b3V4B>p-x{X?qV>`x&qlK~ zR-fbQKId{F=RS=W=9H|s_G48bvmv;!BL2*OuCqcF9)IRd zkF?5(Rw?O8q=%7YBv_r631HZ zXE^5oIO(_B$t^wbBhvBW6%tzKDJ18IvZNY6*=WY+murvv`UJ0siJO7IJj|JN`2ba< zq}fO~_f|cRUTcm{I>*(}0nn}?nSTUQl&dmcO)rVpszUxq%QNMH{!GgQ^^f^x)(eea z?+mQII)KZSq6R4!t4YKxdtDO82D@)nUl4&{f0#5>5G|}ho%>7&e}5Q~C$pP%`=?va zWDjQd@9N4*@&#=gPru{Vj@0?D*?3)*wg2L~f@&R3#&yj-_m!s$KOZ4aB_(~)o4L|* zDlu3#nok;<4yR_at0CvAr0M&)=#Q(zOq!Dm?J{q2JSvumh3G*z)N9xtrydPA6H}~d zMeaV)-?oScSALWNtOHaIR-0L&YFr=-kAHv3MIq;4eoKB*(f$y;dEn$EHlU1Oy$kzb^IL@u-N?iC(aILq-%%yw`i@#ynx; zCG(i_$cf~gX!OQtv@*l8N1&9``+J^X-_0kV8beP0Q%rxs63!zSum-B1as*M{=x=s6 zM#LLM<`TqUI14?C#?o(YHSknEMoT?6Uq z=nh}Zy=K#PD$lN5qPY}y%kH!PKwcPC1IFK80RIj6+R4|L%2RT35b#eeSR8NA0& zQd^n)+mQ;$&6xoHTh^q!8)E(Duk;ozu&xa^bmZPFjC9|Brz9#F5iEs^#ztL54~q66 zu=}ogjRCn;*0=uEfyzr=105*&fGqn-+E6~)7;F?2MQ#WL$-e15M_YPFf(IbR$X7M~ z1_7h%k98TqAFT|yjC-aHMcQkfE-yplC-VsO-%Jb9*`3n<3O~Ga@bd+{bi8_W)w#&G zJj26Cy>1pnAWW>|1D~qF@4qyGCqt@gZ;huf)!;1zCZ6QD_pak*Llvv7cXtwiZgm}# zCRI^kC|F3x!1AcA_R}yZoDsy=EX+Hoke~*;HB?NMWi5#D~az-H^*c z&KnA=Cotc)cZ==C=MYvEXWNI<t663VloHVoq z$m&}M4!mBwO~nt%>^8l?I)PeM9WS&rh`CDC(b^HNa{IOsfMn#J%ed5+=qaU=`9ZYOBk1zTx|?A2F`75Gm&{&=UpYlI zCH9O+A39v{l};Yd1tluf!93@I)M=os0iev0L^(Pt$CC9eUh;mF^PtvG=Mvq~xuayf zqigl>_~G^ns___=83XK$5bopD{$ujwC3x8k3uk~p$#-JwTjgt>Yjk*ArV!)qP5lJ+ zok;iA0mwI5sB(Hh2mUXd5;;-t^lXCE9*skBJy2rs$2|zfkMIdmQN^0h8l*NVz?gIb zZ?o$kU3oCmyq%YDroDKYwwg$4SErhwt+dW|PbjB!VqjM`+4Ag(`0^;cjfWmCGV`oL573UYl(n1%&K%Ir92Ff z3D?dU3=18976kpekh8*^hgnu|h%h{Jda#D$I& zZiAQ}@I<blEp*sfWW)b${CDzB_l0R74l3e3G3#4A_ud8*ZkhjVCZ|MST zE1xaN^7=dXn3fI>zUy`MW&k@#+2# z80%W{VESyeq^{M1{z{c*dEsHg5VY{vMdMThpUsuV zTNJ^>ZSB`$A`RJ9l4PEHN}XGnvgs-kIFiLR)go(o@MRW#O#q+S2AMVqWn{2wa;aVH z!zp3;=iSe|rkgFIg7ur~xVJESi#;1O#uC{1WU3(rsgSRf2AQLM%98VUNX^sMGfgEd zT$@xA_%TLHXsmNvY(Dxp3b1dE6YdEO#^ecMv?PNTFXIZ=P_*o{xNNhx&$0cCj!Q4_mTm`Hem{) zhFt1qN{1z9eb#7H4h~#5o#7h;0%H#>S7hWA3aOeP2I3c|a`XhW4_@K?CFU%rvIK_i z-z4=DhuQOVjbErm{^bAFPMz>1Bws9AzswqCk`;Ad{+l3;kbUJMO0b-4ftb|CG}05{Y|wt_&T1a*`6J)iB{cy-wvBy7xLZ&PU zb(b(`vvuuEm}i3wBj0*n9vXUtfm$tcgfrX;-YW(Bj@Sqc=6%iWux3`P%lcjzlhEg| z0!gaM*5jxt0D>Hve<^u1jRiXSb>QxwWcAk!>9Eo`@;FvWzX4yaT)?A;{D$7kx%DJ~ z;C!2wts&6;10RNSmag0_MmBCIL;z8p&UF8Oy@)lm&@+C!I;tVey z>#E+C79oh#@<=dEuHqd;n8?^j&ieRUkz(Q(@h53sG+it6F#yLiUa zxwR?QoPp^8Ure~}0;&tO@_BIZC=5;{!FFHoyS}Jm$`<~Fgg9NfkIXOg+qMVY!-|!) zZ+bitb4xp^D~tzZ<4f(hk#;W1J$y)4q4+F5!gBqy9c!_ffx~T5SGB3{69Pv{y`$Jm z9wgC6YsK$4Yg}_*VI69AhsQzsv2XPy9@K`kcg53OctiKm)47$2OuG1y5ldOE&uySj zRE)jyV}c_IRd9QcAizqY)@8u<&bGNgbHwxXh3a!#WnER;?Y<-+X0-yY zhM5__NP3K?M|e(F4G8G{9ES)o+1<>(A}<@qyLAO`$n-*Mq_Gn}t z-?6n+{SNW?R3&n7RFfO^lqNiejYNGtk^?@fL3C5@ zDP3m7-7D@3!_#%*OZpyk8?6W-A^QO+b8dHuS=IOJQ~{Arxw%UGuPER9!Vh|P;mgY+ zDLQ%5$rWDG*K&7HRNF)@Uke1VwwUS=$*Ef<@KZBn{q+w z?z)^@i4YYc_<4V7y7;0^55^|UHbiD~bkAFbg0xk8DyVP!Yu*tnn@67$!5HDA8p{); zy>-(-EpP)uj#C! z5o~+5p!OkGjjMLQag8gl9nS;sSDza>;If`QOE~YbMOwvDm*;%}00AJ2cH4FUd~I$Y zvL3s#d7`W2!%TL++BLAF_dZ0lb3^_fEH!PpyCHx(Le!OFX+7r)n=?CD0YA8FQ*P>8 zNiWdPw6(h!Z%<1hWgVQ%PfWt=oE&bSwNCGKGm08<4QmJxv6Ty60Ol*T>Wb**Wic2k zUhue8R1!*e!&^MrZ)_OR+1bbe5eCJ%eAoH}~`&sp|tM}2YUDjfGu|x2YLu}5G zJFB2vFig)YKo|&H=fW3IFpp3A5(_JU zfuF#Gy~8dMh)ocXG;S_-F^xE47oXNDJ6v23-@{8zoGGk^L>HRfZ`IT-pUgXBiJAKD z`%nZrald;@@BK)o`DI?+*71f%?ab6SFAo`G@x&p&T`)v&vG(ym&^iu}rg;c=&#_B# z6Kh-%!@G?8nTk)*G!A{SXz$Ccqqmw8`ibT zH5#f67z%IXuLN%NdAznl+#LkLS0R-X+R#+Ue(mGMAnDzNpDK~3R;O*>2kdkEdyL-9 zRn+x8@_(_E>)(OZ%4>Tz>&5g=`lQT3o1iv|uMsRf5g4yK#MSU%rZn;E#K*n1KS5mi zt3|ii=u_-V73&>uIH@wFXtb!k??DD>9@H(8;!0SdrbN*zwa7;OP+jR5%%pAV+WFa zUzc^6zsWRq$;#RRVbpqI^aq}9_H34)zCXTNtGs1b&(QB>gK1{2%W&gHN+9Z%c5dWT zeAPL}ilV4gmF;I5fxF3txx?ZkI$K~iO^Afxkiu>=B@pnlNXzs9Ultnf{t5@RPAfdzk zPnRiAmhqnyK1V)lyQ0x_yJIz|*HE3Aei`v6;+s+Q0D0+kP*tu8KMiKEEWq~`gh3u{pD7o~w&6F6)oQgiBS&0hE zylgvDWO_SGUB(vO;CqJ{@pdyaBPvB^JiuPKx7L9J4FM;uGA`>B@#Olh2z!v$l&WlX zH`|kdjtgY69M^|De#%hFGzlYHxO^n}xW-e&!c?qj-|MX@qpL@(GcK}0I*3f3gaYqV zOn6g`;hUs|*`_H{>X?ANw?2O;OJ%63t!H(vos* zoxqvu7#2@zsgK%fJ0XMy-#oOa*%h0@mgMO1!6wgnTqqiXRVyZ!DA0xN*izT6D%&Ru zP{A|g@NHmg-@kM(-dVmN`$Onz9{G!q?{rG(7iPDn)zU+sIy2`cw#-Qbd@5xCYiZjw`Q`)H4x>psf9Uw#9xk_%+kUzoT z#PlBP$CE{uVyZ*DKshlh((W&b`DlgBrl3eF&@SnVsH!1+?(d@+ zVHv+B;5JE-IDixxR%Ud&sw6T#rY;2^jdf9iI1_a4EL!Lw;8^c|S3|pQ>(&GD_$jlg z3!iO5cF3}+?gq^*Akqtu2jRB8&vQ<&#+~5pD=PNCP+8-z5RfjcgISib)|rZOm`_VG zMYuNQJyFwLjZjVVr)AsQxatVxb6k9ClovU(RN3O**6X7m*ZtSQ|DcIj!0BHQaYBuT zjY+Fc4OUp_(KG-du~qZxXkWrK!J?Y%`i4yb-incKs$$>A*(sT#(j%EgGWP7L>~#Tq zcL*5r;f-w9w_s$BZo@8Ft5rP0adGf zM%DE`ML$uc@)5B`AI`*?4Hr3}Q8*?MOwTRT{M0}$~y?9~S(BtE=O7Dpi{f0Hvro2^*NwE*ScG>KeFn2K73%k!0c;d?k zIHJEcR%=vi?c1aOB#jYm518%b&R>O!UWik5FO()2PT5C`s=Kir`W!H~(Po$D+rt9t z)7bm^^tP955qTm9^MScLS&XPHIbBt9aaHm7JaS@$z~D$~bm~Q_SXVz4F%F-|)7?9N* zb+w#e6Zv}4KzwDVcI{p}vlZepz6(Jc^o3%)g#B#=hV*s9!8Ci3@(1ieO$C~BNqV1r ze;P^zr*;?4i+S3_YxQ~Az&O0<*8v6_66VrA|4^HRSGVyjv_gtBmz@g&miTWuyL@0RW(nDfHsri<2IW)ggmyP{3t zkdqs>^0^cw;^L=D*}!gTuuF_zc8gh9xA?ocaj1|$83)ih#}T6*SILK}Ly z8BQh~_p42=R`NJy&Wfz}zdiCjB6tsBeaU#vj_au<&h&^Wu8{en)Dk#V46QVd>w=r& zeQ&69roB_Lz`yH{0#}hDullv#>=mUb{0h!s$^zBw(Pm$^q_=wTT*B?~)hKoA=Ohd+ zGYRau((Jutm!^8?0MXap{TUg?pD%Po{7bK`7Ioko(gU&O{`Xch&my!LDW*&fsBVsKoNj zUH2pO$UL=G0dE-K>AY1XMZh!El`zu$;?&(&In>)5aF=J0(nJJdla;a@tk4d)?YX$t zBFhv3i#K1@sf<@9VA&TGHm;R?=bHCwmi_8}j|p$|6{l?gsEk$q*){Y$EGoXOv*aoL+cR(#G%H zXqYpp$On{z?o~)Ar~IQf3jJgUYuBkVnwAN9?`k19wZ&I;+LlT4Mr+E3#*VO!wXm0SzT*n$K2C)Xj7{Ie@Rs#h0vPsy3UQTQ+` zhWp9aaGY7O1_xgnyOZl%69SBhoMDLsfPMT~#oi2hCrt^mq}9<Ok(9G_oRF(R-%%8FEysJ)|cbEMNW+Y-hXu?Qkn>-&<6(O_%rfx}64G(q26r(`*v^ z6l!Hu=-pij2jWK**)7 z$thUfnr@Dz-{X7IQ{qnS%hQUKa_%n(Zo+6xH!lx0MHd8 zadI~*?w!qL@e*oxYjf}u8`}t8IeO(Y+|X)c24)%-$wpqPM&JV4JRabl7JmvCT(h&R z|9a_LCOljGO0L&{GVjZDhHuJdLQNOa4s>UYX$zcJK`c6^TuoD#F0JuVz@&XZZt1&y zsYiV_V|*tkzegPX_&6n?N6@MF)O`~#_SaEQz@z|2=a8Dm^)TRsRX9VY%Y4_QqTaR7 z#4xL)F9ep;$H6?vsJmrA1H|eeAkN39PCdHO%zy?5*uw*f>=OxzB8h-(QuD`TPZuY3Ez^OC?qsN%}C&VHhVSf zBD1FtsTuu~_XDYiYH5H8K>ZBcrAK~84>-g;&~<>!rr#GOHf3U{C@!63XZF|&?x|<5 znvgSfq2YD5#))aARXnQWPDci7DTyi}vmTn1jr{st3U+kX+|^lkyr{aTH$uE&!%y#x ziGzAUv1VoM=x`0xJqu)ltR+ZCIdFKEnWc1bH_JT&)<7Zky;a^%v;yd!_>53?H{3M1 z>7C`p3WJIfU{eG9S)4ibEc5$I+xEwg4p&~%B;pF#oLYvqB=(jV{BG|hh{wcSJMR1^ z_8|+{>Y8y(W^)9R>n|sYr-Fx(jbmw+GS!5W(=G;sO*idU3J(6tJuV!h)sY(gYdUp! zSEqi{0@pq-C2>5|?*kJ{7E#|#&_+nWHvUo-&ohC1UT|jIscavb)IJ6IEb+wV*9PTy z+E!fYD!HM@lPjqt+U*5e0~GxUnKy=+CIUU(_OR*m`O#3R$}i$(uydxrbQF zRSlXEpw~{kbomh8=;CYQnf36LShRc}R{KEczW>gbZ^2pQ-gSl{5`}PSk61;4!I07*uW_>v>Ar85%zf=HkPd`WpG` z^rqSPJ;|%$qekOVL%^+9D<5U#yx50rX5kw0HBPmD%AA*!G{uWq85MTdpcMR)m@K5n z%IC?UWik7h@5U9mn+47D?r$uz2wwMH+DDD{OxKx63_o=G%?%Qtz$F^{;g(`Y*ry!O zBh{tBOQtmpo!xTy6kYV)i#OyaWv)ZLFH1Ex;~f8|HqhE2{&r#_)?kTEAlB;` z+CF9(VW(TjzAOyoUp?Erqj{C+W$)c9Wr;-avumqKdj0H6m0OLBXBpk+^`}}s(q%QL zCwi<#`vIXv1)Oq@IRHVoLx}&c;FVf{^+HwCPPI26YPYZ~S&=|ke49m^Kd+0<8Q%thj$M@f~UgLXYc_V?2PKdvRJeD)`^G`(vo_Z}-8IBsVawjv_ms<84qQSz$1H_<+Jfze_KRln!PW2u{(r z>QtRaqTc?J!z#TEyh)2so`(mk?$>nXMx(QO3jmmiv#hDf31C_)g&xI)O^%WV_#E|3lglYX>=4(aX z1m~f&G0U|K`unt(s#rELM zq$iz_n{U41=jPjsSL5gM61Fnm)77+E?5huDqxAaqmJ;EN9xtp~b4S1H=UudGf5s|j z@dkd2`f8gsvV_Avgu>f#qyC!lfWoGYazv}2vv0qknai(K zYM@RN1K#sGO!1wD(*s@Xbh1O#9rNGX0?41+P^}-D2|ZA-lM5X6FP5^c{4JvUVgW>8 zD{u+9Ac^UkBWZh?`y1c1ha=KLa3L#WpJ#?oUNzia5HxqjNS^BS;0Ceaf)U6mUK%W?zP9Mo%1C{ z1ECRFzjs@_mFG$(Z=sz*_6(3eE5DX?Z&wzDI3UT3|wB4M%b#M7>DgC0QVv#fyyWu;Wz=_~}94k@jl( zZwvZR_eWGec~_SQvARzXHfLJT|2l!rzudcXJ29vIS_vuHV)sJwTlk^w(JD$tTvk}r z%Yaq)7tQfyiTOwDs+02ehlc$*oncnA&e0YzKE1I^PvC3m6Do;#ue6<7Q!JUgKgwTE zAMG=d)%g#{I(N;e$5rwVrRPeqc&2E$-Gzx)7D< zb;lbdGdA!^Il@AHa+8TB>Nr$`D|^QGt+uYz1#tauXth6LwGlMkgeDjv#4&d={@i zG^R_$Gy#YCx9tNpHjAbaSgk!J?h+#<`bM@cGs^}WIp0epKjnvtdynJLtsA?YK!Dh^ zebE~h^Irvse-JI3{(qs(Ho0tW0D7_tw=Q3GO+L||s16XO^;8rrl|Cwa>neMbuugV{ zGFuh*D#%vzu;W5%bRqeafSe3ux$UZ{dFlg*;k9U`eJ2a0o_m9vf}@jgZ!UA zg7064E>-8)FAy-nY=KDJ%ir+gue8H|8N>^858w0BbUk^Pt!Ne-PD zgVaFwL>y4-as>O5dOz*okz5?Zy8V=Wah;=z_K3fk(GV`r8@HWn7YP4hMsqBhXbn-n zKgHu)&fnk~IA?x4yH_MK?hu9bny1A4@YEd!`9Ntm^?53Js45=l9>_9{akP++PsCY9 zB|~xWO5o|@NY)fOTEqW2Bh1m#F!?^A1^P+HzS60g`e^&kyqRc14>8qrs1yz}fhSk? z{uDU>BRjIUsGfP_S+y)>0DDNSeww&d@Ot3o;I&%E z&xp5zEE_llxSJinxs-R;;|>3&!ztk^0MHDUz}5f7VEQ{N;LkVh5lf1#+!)9rZMRn8 zs^cTnqa@>CAinu(NU5=a9MZw~Wy?@%XDfbi*D%`oP3!JPliuUlXDa7}~M*py(X%a}}O(!bl&A8-7^NeNz% zfCKs$mDTv@@akoiAs*(2RwlQCz;VmT;D%^lPh1;uWht)*O4Rkxd|8{hxgb2fveIhkU1UsG~bou(o0wwtz4D)V3m>;H0snsJ%%Y3ZFU0oyRuPLfqRj zPzHOPw0&Cm-yzqkKHR+y&N|_WBsz>Z>T@?D7uQWM(yT-nDp9!a$@`KNQb0P`Gj6ZE zzAWbmBDaJL+KMv?K zHmXfEHs{VLU0)vAwzF0daEP+1ki-M|zRwp*?ut6EWmbI`fI_yU&Za{0?Zbm+9=t6* z9}Z_=F#UgK(%86pzNx%l2@`+VVx=B?klu1x;5+iCAZ(1SLLU!>5TMve`v`L7rH*5g ziTZzbV1q$UGB1mcJcR->pDQiu8=pzN33Ze^5=YgfcHhrN$|#&C!hzK2<_S_Z>ZU4t zps>vgNuoRKH`D=S!oTke|1NJ}h88}xH5w{M-|tr-iI(*Gj{AG2cWx5Q^w<&}A~}%W z1*A7@c&&i3JxsgvZ} znXuy7Hr3hFL?VyBS#jJu4rBYbKsmm-03USFw2iVWctatm63#%Ps@mP-3Dwr)dM^FO zvSrM4KU)&c9L3Qe-fdbO#{xsv+#jSjB>YRtAdOU~#u<(X&tObQ_Zlyo)?sXBN9i{b z_)AbI?Bk?j+F*x!#TZJypj@h6rQ?J1Pj4#zgTJ5x#l#T#UevglEMrNia-GLDNZJJi zzN(Z(DATu6j|@bI!~4i*4r;{vOUf7cWZhVG&J#*M4u{a4ZDp6#ey{YG!scXX|4n&H z?E?~%OYg%~_QwlWX|dQ~n8$Ky`hPn?K=C7cVrjP)0_`9gZOjCrsK!AnP$`NU4m$2Q ziM{YZrPz>>3168e2;Sed0%0jNo&6a+eCo*TDm#2fM)M@PQ%39z@T`*I8t+%>$E;46 zUi6eQ(#36EN#~Pt&V)I4`mOjwl0^3K@-6E147xv@@cEi&_|Z>z78^@Znzf~O#59(A zOIe~#1z+?uYGHyH zK3=q-iGf7&J!F1zQWOoK62p(mje7ogMM^T)3=s%v1mL7`m;QJafR?~&n)og_Qo`>I zzi+t?QqYMk_EM;e(JbZw@3HE$+6uGU8oh6F&uHVD)AiRmh)go>f>1Humz3q~&U~u)!(`weVT^qdsn> z%!jn6-(O^OAMdbJgoo%wZax(O$UP}(*WbcCF@pPmc44KIiOrzu{^S1;AX81r6kXtR zp<{o^M&k1d}^SX&V|!CHg}Iw<=#{m z`@DpM7|Q;L?aR&?8adxD(-mdOlN^W6G` zYw5*H`3H1l?Ab$xE{73$J$$(~6ViKARn#Vu1uhX7#gi!eF`zv|MQmF}R4EeX`uZ07QVrq`f`de3 zcjRKWP`ai9o+wy!<;B@oXd$ZAkC>Q@<4xD%J zT@Hx?9v=Nsdb+!HGuy;)BXV)P$(A|!PF5bwP08og`I(`*uIsIJ3iVkcG&A1Rt?FXY zw(e9bTj3ZLW^6FAqwNe=n!{F)$L>OJXUj*u-;Wqg;!{+a{yyAcL>69`P73uVI?p6N26Z4+-La-vZ zq~1DG5w5f{^NrBjqU8~AIzrn}Y>St}cf6;1)#rre%!Ao1z4cEy3=ysKxlZ*Tk&lM1 zNG6tYY>((CGw2hB>W1ADC1a3sJ|G{5IM1>zJa|s{hP3SuP-5CIP$K#KrL}FG0fdFI zy(psm+x_2;hkW@n{PcY3ydxqY*2|YecSbQj@N!0M{R(?VLMKrY-$ujZ=F(p;G!pUB zqmLf@JxilxfulILeFoq8;`Ku=K~N04P_>FG)gYL=N9XvCuFK)+{!v=}HDHp3VpLpj zcm0M^)W{6Do@_r-syNQ!(dUP8Y)tofFD6gl`@q*qP-OPEdZEYb7MhI8Ow+koGzy@< zRHGi|Ju3Qish$5>(+_j?vd$w{UA`dmyF9xa>j3froj&Xo{uPy1W-z{HZ@xArm5>jj z^61>cu4-HzGYU5I;q*Pj5nXD_UP!`l$jkku_WE&8t0({RU7bfswl{1@{}Z3M<~wDh z>}S(>6YGM{@B4e{K0f7zP(Z+jbfN*bu@aIkWQ7BB0kbQQ)Gh8ACtz z%%}#E^2_a@byXQUEwb2jr%i9@N^xEiiKU0M-;BcE+KVYsbP;BY2{BvrZ;6%8{CNI0 zLJh&r`F;cdYJ_%Xy1LAgbBY2liaMwkO}bHSQ7s+g>+{KgIqS$>YL<`G+j#SvxXtF;Q)S*O+1Qq5|*4?F2zeJ}RqLR3N3s_@RiQP%HQ38=PbuArRojXr6RGT7h8Az*QLsSw{ zrB+BrNS>6FOhlwHuQj4Is4p`$CvmSAMrSnlV?U>W5)4T+T29cIGrNv=H!TA`RgQZQ zv2(rjRpgNN_xNe*Iq_}c!)0O=UhqE_B27eo;y}Wa^g=%S-TFY-mY-8)A3X`806gKL6#w zh3G$$ALp46cHZj>omQ2dmQfHu?=F<+H(B}E?YtsD0^mh*zZfPGFLtx&1##*UU6yH2 zE5@(nQQ}Q@#UJ%uK&b*e2L+p`Ji5iF^0 zX{xK}U3&Gj$pLfO|LWAq zSepMKpv}7=oS`OAEuGdgvubm2_BLWaG-R&;?-W-3FHT{ecr8;-L0*D1&jw-1z zDji<16m|oDR;MY4c?EA>&3!T8dXX4li^c@=oLi`?P!n8&ZUE&ad<2VnP>>8{Qx*>1 z1;}v~$MUWpY@K*q;<)GOfKwk4_`B+B(t64or<&5SFy@sZvo=ZLzNK{Q<<(>cSWxnT z*^{$%G4B`{EZ&MW9Y+$xgN_x6aO0Tvj%c~}&cd4KTBlSPw1aNUO8OP~g+*dXocR<%a0I_i0d~g1UIJGmN_TcYi}hZ>dG6 zbwd*ERpa>c@^D_RP;1(dMbxFh!Kn_I~eizd5x z*X$Uu(V1=Fi$SQwf+<`(W!{zy#F$Ml;~@_y?yvLwIzVEbJR_xzcQBSzvhqpIG61dT zm)E46mquML!1Qk}0C2Bn1Hs;Wv(iPLz0ReJ`Vt3ZC{YTXo6Dt6ck`u2Hbkn+tZ9|@ zmYh=d_X>Tj=p8c023&P*xJL)`&|R5a8G4{cuzT3{(t?{tJMacLgat{ebwdO*IGG;< zjcj{K?1Nbb;J)^SkqMRUNa*kip~J?}V}!3Ibw_<0kGZ|J;(vdmhw`PkR%BZ6MOm-BdCygU}REgA_N0V7L%tgk$BLE(OTnTfMqby9E?S zOZiL4-Q4fBz$ARZLMzKCcLMMY^?kI5XVuO6bI#O(4^$f`P>`{W2LOKUe|2UzaKnI2 z`=>N#nydsf(hO;6e1E=V7vM7ZbhaBcR5m`>;PnTu_iG5Yn)Eh4vu@uS$rDVvoFzGs zS$Q z3;px4Tm*UV%ZQHZ?mRbK3+13;MG;q8(j7$QA@G<9pzx2SL&(+Ss#TPTR+nAElkuPc zSf?^8%_E9a#y*|z9}I{FP!{e^@_35&*$uaS;@NcnHWi_!V)|mKd@k1_{7}_xJLpkv z@JG|H%p<}+%Rk?7)74zbwSHstb?s{@=o$`hT!qcv52hx9?JWzs#X6VPaanfQ8y5h2 zFi-CH`}kkzgG9#tj0^dU1G#*K0`?;^B+_)vZayRR2QDKR4G=%Awpe-Ck+L@8&)leh zYDT$(MeA<3tg4&;%7A4>rqIE;@PauV(eaiqRM=3;!;Q5u1jRi6JgJ^W5v z#KnfzqsnKk!kYkNU}q45{_Ult@Y^HY!cdM%fWFx&mdItVr93we+}ymC0h=S4D}QGJ zcwgKsc89UUYNFd}zeh(O8N1zmSS%F!H%bBEw0WKz>$ZGRO$$#rRRV<5^~nd%?zPEL zSO076#>Rcd#N;_g)iqO^!4TOchb>$6XO#@N0uwKL#_>3PyFl%~xXKw^B;3!a7wRiH z|70Nu(OBd9u(U2MZB&D z1TI$vZUs(ZBt~+vqp@N&amifilj}K#?RvR^5rc9qU)$~6;R!Zj)8s?lMce2xAYFA` zGH9@A$`~Hv)vkzfUk|?mwERn^lwF<&tI7IXP~`!}QOg^p{;K#cX_NF1m%RQbB0sBm zwmoZ|oGqumcK5Xj8|=X-5Vc#qs4}_vVqO%l)g|HL?OxCQUZKIK_xgzYrgCz=CxJJt zNprGl?Cz9BeJy4nNh3;jbZU==+*N$B)DU}t@$*RLLGX|3=+XZ-Zc=B3uC+m3bf-WZ|YT&I6BVa=M2H~?`4QuSjd9O<7AO8w(FpG;>l|$7xgHb-`GSN zK`gOcy^*#VE0<1cxQL-gg*+iTvI=O?}jX>9;9s1Eb|+P-U)2Z)#u z1XMzJjPt!K@kgZ5Ge$PAbargQO#qc`;e_A{J@L~=U!}fGZsJOS$Q*@-R#1>_xhp^c9%vi ziA0_%VSI09NXJj=iGwr-?UH$g1U2-fYrb!0%t)MFv+;JP$1?;vOGV;DKldmMBu0#c z4J*j%DA5QT;Pu#=>2bYrX6pP&ow`yD&041oIYUmrym`qaR_tXDtel}3#kbQ6Xar-` ze26+_VJO33h}I0^FvYA@42)Ou+TKd)XYxS9dUAyf?|v(-66t++^D_iGZrc2m>Ppu2 zje-i)>R_?=BE1?&R5tooNKeetZAr`pGQFM##Bj=f}bV@(j=x{A^8#uSn zA>>FMom11zY}?$<$YPwp1z&!BGkhjgVuK45E{-%KpimSX-49^R1K!%hZYW$Jt^T|1 z?06yMRVQ+OquM2cq;v7yV}E;?VRP$UZt*3I09)u6d>s0M-8yt$tLTdZpTTwx=8E&u zB0uA|y+@x`%G%sP?BqOlDi4CTEZzg)A3awF ze2v}K!r>F(>FB3~EnHtM_1e~MqO-+rYla$*?(g+TCU+?l6)qNTw4nxC7@Icne{0Fo z)KhH`B1ZE?PNf63>_tp_u()(!*_qmjuha?75Q*CEj(s%jWkX{}mm5i~(wWgFw8%Lf zp0o{y^t^6jn$z1=zmBtOhO}HaeQc=U7L8m%s{!coN9k5ghyskA;@4NKdwvHz?(f|C zR4mQziaLz5hTqXWCdF%F!$es4_2NFU!{Pc=p zd+j*uG%X35413ykZDdT_)G+HAk^WU_1YBaJws@_Z?EWjwwZbtx^|0SBR-!4K&bC`A z>9o@31O(>%7*6ucS^frpFO1=;C0IM_K5B5uqEJg2AI_58BuZwds5%wqTatVme+h>V z@SFsR^?1+?z!*z)u!b@;ISOPAam2P`bG3wn>B?(_ZWhK4ZQ|%!bupJr91cWN5+`qKR0e&-A+v5@wQ7dV5jU zmK0mI=lALUo9agdKOizOO;#ckmN}==o=LQ84nG|M_r96G^!&)Z&(-kD^f>WI1q*k+ zfwAe+4@F{q^>iq!*t>R3UX#x_8bT6xw4KmYCOVYTfrQ%^?=R5Q2jTI+A0w{MHOAuu zVRhErNRJ16XQ*x?E`3mgH^rc$!Bgf#5|9d?s0aqUWU~uR=AjDS*PK2-Y(|;r$-XR}C7pBj4#K8l=;GzJ34C^Lb_n--k=?auXuyQ& zZT+CYy{)_TY%ex!%8$L`xdf+wi_Vq)JvvwQS9C5{WRXNSZrmBXqP(n}<)XIk>{O}} z0vzqBms>_X{M&>Khg+Bu*7PLC01*;RaOD>^Q_AP!b0AP-5kSrEfC$juD2TbdE*QkV z>o%lcjd@Tc+edEb>Oxv#`s$`@PmZ{}mK3ywyBv8?wG~iB$w`{Tw%_vV1*u_M!&Fz2 zr6cZ*u~S1h5KlYYirzBtvw^2Z`maIcc#M(@M&HPB5OOJdfNLT}^o23JCAC*%B_-%u)={h`slF3WnWmr!|Z+f(VN_DZJ(n&;JevivgYa|>XqhR8y?2`V?$=p zPUmO}TWw2PFH%E^QY;*$G9k|uvh0nK6Wz#w(H)r3VoPmey!6m&t9>KSk8{PFZl4$x z1t}eaCqJpjD9)`i&1_DGXYfGe3k!H?qK}h<=MBOop3Gw*VlFlxbn>EmiAKjYSqXC6 z8I&$gD*O+Fx4e!0#x*81k+Wi%x)YJUi-EaMvtAbg?#)`L)zbCO=DhXV5dK zd}h6kV-#C7{?_qC-f#5VIR*)QsFCTSaB6N+%%?Wn3DZt;L�>eABoX-HT;Ku)fbr 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 E0mO +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +class AudioWidget : public QWidget +{ +public: + AudioWidget(); + void setFile(const QString &file); + +private slots: + void updatePosition(); + void newOcclusion(); + void modeChanged(); + void fileChanged(const QString &file); + void openFileDialog(); + void updateRoom(); + void animateChanged(); + +private: + QLineEdit *fileEdit = nullptr; + QPushButton *fileDialogButton = nullptr; + QSlider *azimuth = nullptr; + QSlider *elevation = nullptr; + QSlider *distance = nullptr; + QSlider *occlusion = nullptr; + QSlider *roomDimension = nullptr; + QSlider *reverbGain = nullptr; + QSlider *reflectionGain = nullptr; + QComboBox *mode = nullptr; + QCheckBox *animateButton = nullptr; + QPropertyAnimation *animation = nullptr; + + QAudioEngine engine; + QAudioListener *listener = nullptr; + QSpatialSound *sound = nullptr; + QAudioRoom *room = nullptr; + QFileDialog *fileDialog = nullptr; +}; + +AudioWidget::AudioWidget() +{ + setMinimumSize(400, 300); + auto *form = new QFormLayout(this); + + auto *fileLayout = new QHBoxLayout; + fileEdit = new QLineEdit; + fileEdit->setPlaceholderText(tr("Audio File")); + fileLayout->addWidget(fileEdit); + fileDialogButton = new QPushButton(tr("Choose...")); + fileLayout->addWidget(fileDialogButton); + form->addRow(fileLayout); + + azimuth = new QSlider(Qt::Horizontal); + azimuth->setRange(-180, 180); + form->addRow(tr("Azimuth (-180 - 180 degree):"), azimuth); + + elevation = new QSlider(Qt::Horizontal); + elevation->setRange(-90, 90); + form->addRow(tr("Elevation (-90 - 90 degree)"), elevation); + + distance = new QSlider(Qt::Horizontal); + distance->setRange(0, 1000); + distance->setValue(100); + form->addRow(tr("Distance (0 - 10 meter):"), distance); + + occlusion = new QSlider(Qt::Horizontal); + occlusion->setRange(0, 400); + form->addRow(tr("Occlusion (0 - 4):"), occlusion); + + roomDimension = new QSlider(Qt::Horizontal); + roomDimension->setRange(0, 10000); + roomDimension->setValue(1000); + form->addRow(tr("Room dimension (0 - 100 meter):"), roomDimension); + + reverbGain = new QSlider(Qt::Horizontal); + reverbGain->setRange(0, 500); + reverbGain->setValue(0); + form->addRow(tr("Reverb gain (0-5):"), reverbGain); + + reflectionGain = new QSlider(Qt::Horizontal); + reflectionGain->setRange(0, 500); + reflectionGain->setValue(0); + form->addRow(tr("Reflection gain (0-5):"), reflectionGain); + + mode = new QComboBox; + mode->addItem(tr("Surround"), QVariant::fromValue(QAudioEngine::Surround)); + mode->addItem(tr("Stereo"), QVariant::fromValue(QAudioEngine::Stereo)); + mode->addItem(tr("Headphone"), QVariant::fromValue(QAudioEngine::Headphone)); + + form->addRow(tr("Output mode:"), mode); + + animateButton = new QCheckBox(tr("Animate sound position")); + form->addRow(animateButton); + + connect(fileEdit, &QLineEdit::textChanged, this, &AudioWidget::fileChanged); + connect(fileDialogButton, &QPushButton::clicked, this, &AudioWidget::openFileDialog); + + connect(azimuth, &QSlider::valueChanged, this, &AudioWidget::updatePosition); + connect(elevation, &QSlider::valueChanged, this, &AudioWidget::updatePosition); + connect(distance, &QSlider::valueChanged, this, &AudioWidget::updatePosition); + connect(occlusion, &QSlider::valueChanged, this, &AudioWidget::newOcclusion); + + connect(roomDimension, &QSlider::valueChanged, this, &AudioWidget::updateRoom); + connect(reverbGain, &QSlider::valueChanged, this, &AudioWidget::updateRoom); + connect(reflectionGain, &QSlider::valueChanged, this, &AudioWidget::updateRoom); + + connect(mode, &QComboBox::currentIndexChanged, this, &AudioWidget::modeChanged); + + room = new QAudioRoom(&engine); + room->setWallMaterial(QAudioRoom::BackWall, QAudioRoom::BrickBare); + room->setWallMaterial(QAudioRoom::FrontWall, QAudioRoom::BrickBare); + room->setWallMaterial(QAudioRoom::LeftWall, QAudioRoom::BrickBare); + room->setWallMaterial(QAudioRoom::RightWall, QAudioRoom::BrickBare); + room->setWallMaterial(QAudioRoom::Floor, QAudioRoom::Marble); + room->setWallMaterial(QAudioRoom::Ceiling, QAudioRoom::WoodCeiling); + updateRoom(); + + listener = new QAudioListener(&engine); + listener->setPosition({}); + listener->setRotation({}); + engine.start(); + + sound = new QSpatialSound(&engine); + updatePosition(); + + animation = new QPropertyAnimation(azimuth, "value"); + animation->setDuration(10000); + animation->setStartValue(-180); + animation->setEndValue(180); + animation->setLoopCount(-1); + connect(animateButton, &QCheckBox::toggled, this, &AudioWidget::animateChanged); +} + +void AudioWidget::setFile(const QString &file) +{ + fileEdit->setText(file); +} + +void AudioWidget::updatePosition() +{ + const float az = azimuth->value() / 180. * M_PI; + const float el = elevation->value() / 180. * M_PI; + const float d = distance->value(); + + const float x = d * sin(az) * cos(el); + const float y = d * sin(el); + const float z = -d * cos(az) * cos(el); + sound->setPosition({x, y, z}); +} + +void AudioWidget::newOcclusion() +{ + sound->setOcclusionIntensity(occlusion->value() / 100.); +} + +void AudioWidget::modeChanged() +{ + engine.setOutputMode(mode->currentData().value()); +} + +void AudioWidget::fileChanged(const QString &file) +{ + sound->setSource(QUrl::fromLocalFile(file)); + sound->setSize(5); + sound->setLoops(QSpatialSound::Infinite); +} + +void AudioWidget::openFileDialog() +{ + if (fileDialog == nullptr) { + const QString dir = QStandardPaths::writableLocation(QStandardPaths::MusicLocation); + fileDialog = new QFileDialog(this, tr("Open Audio File"), dir); + fileDialog->setAcceptMode(QFileDialog::AcceptOpen); + const QStringList nameFilters{tr("Audio Files (*.mp3 *.aac *.wma *.flac *.ogg *.wav)")}; + fileDialog->setNameFilters(nameFilters); + } + + if (fileDialog->exec() == QDialog::Accepted) + fileEdit->setText(fileDialog->selectedFiles().constFirst()); +} + +void AudioWidget::updateRoom() +{ + const float d = roomDimension->value(); + room->setDimensions(QVector3D(d, d, 400)); + room->setReflectionGain(float(reflectionGain->value()) / 100); + room->setReverbGain(float(reverbGain->value()) / 100); +} + +void AudioWidget::animateChanged() +{ + if (animateButton->isChecked()) + animation->start(); + else + animation->stop(); +} + +int main(int argc, char **argv) +{ + QApplication app(argc, argv); + + QCoreApplication::setApplicationVersion(qVersion()); + QGuiApplication::setApplicationDisplayName(AudioWidget::tr("Spatial Audio test application")); + + QCommandLineParser commandLineParser; + commandLineParser.addVersionOption(); + commandLineParser.addHelpOption(); + commandLineParser.addPositionalArgument("Audio File", + "Audio File to play"); + + commandLineParser.process(app); + + AudioWidget w; + w.show(); + + if (!commandLineParser.positionalArguments().isEmpty()) + w.setFile(commandLineParser.positionalArguments().constFirst()); + + return app.exec(); +} diff --git a/examples/spatialaudio/spatialaudio.pro b/examples/spatialaudio/spatialaudio.pro new file mode 100644 index 0000000..80039c1 --- /dev/null +++ b/examples/spatialaudio/spatialaudio.pro @@ -0,0 +1,3 @@ +TEMPLATE = subdirs +SUBDIRS += audiopanning + diff --git a/licenseRule.json b/licenseRule.json new file mode 100644 index 0000000..b5bc728 --- /dev/null +++ b/licenseRule.json @@ -0,0 +1,149 @@ +[ + { + "comment": ["file_pattern_ending: strings matched against the end of a file name.", + "location keys: regular expression matched against the beginning of", + "the file path (relative to the git submodule root).", + "spdx: list of SPDX-License-Expression's allowed in the matching files.", + "-------------------------------------------------------", + "Files with the following endings are Build System licensed,", + "unless they are examples", + "Files with other endings can also be build system files" + ], + "file_pattern_ending": ["CMakeLists.txt", ".cmake", ".pro", ".pri", ".prf", + "configure", "configure.bat", "cmake.in", "plist.in", "CMakeLists.txt.in", ".ver", + ".cmake.conf", ".tag", "ci_config_linux.json", + ".yaml", "BLACKLIST", "Info.plist", ".cfg"], + "location": { + "": { + "comment": "Default", + "file type": "build system", + "spdx": ["BSD-3-Clause"] + }, + "(.*)(examples/|snippets/)": { + "comment": "Example takes precedence", + "file type": "examples and snippets", + "spdx": ["LicenseRef-Qt-Commercial OR BSD-3-Clause"] + } + } + }, + { + "comments": ["Files with the following endings are infrastructure licensed"], + "file_pattern_ending": [".gitattributes", ".gitignore", ".gitmodules", ".gitreview", + "_clang-format", "licenseRule.json", "REUSE.toml"], + "location":{ + "": { + "comment": "Default", + "file type": "infrastructure", + "spdx": ["LicenseRef-Qt-Commercial OR BSD-3-Clause"] + } + } + }, + { + "comments": ["Files with the following endings are Tool licensed,", + "unless they are examples.", + "Files with other endings can also be tool files."], + "file_pattern_ending": [".sh", ".py", ".pl", ".bat", ".ps1"], + "location":{ + "": { + "comment": "Default", + "file type": "tools and utils", + "spdx": ["LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0"] + }, + "(.*)(examples/|snippets/)": { + "comment": "Example takes precedence", + "file type": "examples and snippets", + "spdx": ["LicenseRef-Qt-Commercial OR BSD-3-Clause"] + } + } + }, + { + "comment": "Files with the following endings are Documentation licensed.", + "file_pattern_ending": [".qdoc", ".qdocinc" , ".qdocconf", "README", "qt_attribution.json", + "config_help.txt", ".css"], + "location":{ + "": { + "comment": "", + "file type": "documentation", + "spdx": ["LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only"] + } + } + }, + { + "comment": ["All other files", + "The licensing is defined only by the file location in the Qt module repository.", + "NO key for this case!", + "This needs to be the last entry of the file."], + "location": { + "": { + "comment": "Default", + "file type": "module and plugin", + "spdx": ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only"] + }, + "coin/": { + "comment": "Default", + "file type": "build system", + "spdx": ["BSD-3-Clause"] + }, + "dist/": { + "comment": "Default", + "file type": "documentation", + "spdx": ["LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only"] + }, + "src/": { + "comment": "Default", + "file type": "module and plugin", + "spdx": ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only"] + }, + "src/multimedia/pipewire/qpipewire_spa_compat_p.h": { + "comment": "Special case (backport from pipewire sources)", + "file type": "module and plugin", + "spdx": ["MIT"] + }, + "src/spatialaudioquick3d/": { + "comment": "Special case", + "file type": "module and plugin", + "spdx": ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only"] + }, + "src/spatialaudio/": { + "comment": "Special case", + "file type": "module and plugin", + "spdx": ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only"] + }, + "src/resonance-audio/": { + "comment": "Special case", + "file type": "module and plugin", + "spdx": ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only"] + }, + "tests/": { + "comment": "Default", + "file type": "test", + "spdx": ["LicenseRef-Qt-Commercial OR GPL-3.0-only"] + }, + "(.*)(examples/|snippets/)": { + "comment": "Default", + "file type": "examples and snippets", + "spdx": ["LicenseRef-Qt-Commercial OR BSD-3-Clause"] + }, + ".*/doc/src/images/": { + "comment": "Default", + "file type": "documentation", + "spdx": ["LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only"] + }, + "config\\.tests/": { + "comment": "Default", + "file type": "build system", + "spdx": ["BSD-3-Clause"] + }, + "util/": { + "comment": "Default", + "file type": "util", + "spdx": ["LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0"] + }, + "src/multimediatestlib/": { + "comment": "Library only for Qt tests", + "file type": "util", + "spdx": ["LicenseRef-Qt-Commercial OR GPL-3.0-only"] + } + } + } +] diff --git a/mkspecs/features/ios/add_ios_ffmpeg_libraries.prf b/mkspecs/features/ios/add_ios_ffmpeg_libraries.prf new file mode 100644 index 0000000..9036904 --- /dev/null +++ b/mkspecs/features/ios/add_ios_ffmpeg_libraries.prf @@ -0,0 +1,23 @@ +# Copyright (C) 2025 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +FFMPEG_FRAMEWORKS_PATH = $$[QT_INSTALL_LIBS]/ffmpeg +FFMPEG_XCFRAMEWORKS = $$files($$FFMPEG_FRAMEWORKS_PATH/*.xcframework) + +!macx-xcode { + return() +} + +isEmpty(FFMPEG_XCFRAMEWORKS) { + warning("The project requests linking against Qt-provided FFmpeg libraries, but none were found in the Qt installation. Expected location: $${FFMPEG_FRAMEWORKS_PATH}") + return() +} + +ffmpeg_frameworks.files = +ffmpeg_frameworks.path = Frameworks +QMAKE_BUNDLE_DATA += ffmpeg_frameworks + +for(xcframework, FFMPEG_XCFRAMEWORKS) { + LIBS += $$xcframework + ffmpeg_frameworks.files += $$xcframework +} diff --git a/qt_cmdline.cmake b/qt_cmdline.cmake new file mode 100644 index 0000000..42d2da5 --- /dev/null +++ b/qt_cmdline.cmake @@ -0,0 +1,4 @@ +# Copyright (C) 2024 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +qt_commandline_subconfig(src/multimedia) diff --git a/src/3rdparty/dr_libs/0001-3rdparty-drwav-namespace-implementation.patch b/src/3rdparty/dr_libs/0001-3rdparty-drwav-namespace-implementation.patch new file mode 100644 index 0000000..18c6d64 --- /dev/null +++ b/src/3rdparty/dr_libs/0001-3rdparty-drwav-namespace-implementation.patch @@ -0,0 +1,80 @@ +From 6048f7252c4dacdd6cb49b10ddae798fcc66b01b Mon Sep 17 00:00:00 2001 +From: Tim Blechmann +Date: Mon, 9 Feb 2026 09:35:02 +0800 +Subject: [PATCH] 3rdparty: drwav - namespace implementation + +Change-Id: I0daf6fc825e2cabb8123fb7fa4c36bc423e96169 +--- + src/3rdparty/dr_libs/dr_wav.h | 11 +++++++++++ + 1 file changed, 11 insertions(+) + +diff --git a/src/3rdparty/dr_libs/dr_wav.h b/src/3rdparty/dr_libs/dr_wav.h +index f2d861b08..903f653bf 100644 +--- a/src/3rdparty/dr_libs/dr_wav.h ++++ b/src/3rdparty/dr_libs/dr_wav.h +@@ -148,12 +148,14 @@ extern "C" { + #define DRWAV_VERSION_MAJOR 0 + #define DRWAV_VERSION_MINOR 14 + #define DRWAV_VERSION_REVISION 4 + #define DRWAV_VERSION_STRING DRWAV_XSTRINGIFY(DRWAV_VERSION_MAJOR) "." DRWAV_XSTRINGIFY(DRWAV_VERSION_MINOR) "." DRWAV_XSTRINGIFY(DRWAV_VERSION_REVISION) + + #include /* For size_t. */ ++QT_BEGIN_NAMESPACE ++namespace QtPrivate { + + /* Sized Types */ + typedef signed char drwav_int8; + typedef unsigned char drwav_uint8; + typedef signed short drwav_int16; + typedef unsigned short drwav_uint16; +@@ -1338,12 +1340,14 @@ DRWAV_API float drwav_bytes_to_f32(const drwav_uint8* data); + /* Compares a GUID for the purpose of checking the type of a Wave64 chunk. */ + DRWAV_API drwav_bool32 drwav_guid_equal(const drwav_uint8 a[16], const drwav_uint8 b[16]); + + /* Compares a four-character-code for the purpose of checking the type of a RIFF chunk. */ + DRWAV_API drwav_bool32 drwav_fourcc_equal(const drwav_uint8* a, const char* b); + ++} // namespace QtPrivate ++QT_END_NAMESPACE + #ifdef __cplusplus + } + #endif + #endif /* dr_wav_h */ + + +@@ -1485,12 +1489,16 @@ DRWAV_API drwav_bool32 drwav_fourcc_equal(const drwav_uint8* a, const char* b); + #endif + #if ((__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8)) + #define DRWAV_HAS_BYTESWAP16_INTRINSIC + #endif + #endif + ++QT_BEGIN_NAMESPACE ++namespace QtPrivate { ++ ++ + DRWAV_API void drwav_version(drwav_uint32* pMajor, drwav_uint32* pMinor, drwav_uint32* pRevision) + { + if (pMajor) { + *pMajor = DRWAV_VERSION_MAJOR; + } + +@@ -8535,12 +8543,15 @@ DRWAV_API drwav_bool32 drwav_fourcc_equal(const drwav_uint8* a, const char* b) + + #ifdef __MRC__ + /* Undo the pragma at the beginning of this file. */ + #pragma options opt reset + #endif + ++} // namespace QtPrivate ++QT_END_NAMESPACE ++ + #endif /* dr_wav_c */ + #endif /* DR_WAV_IMPLEMENTATION */ + + /* + REVISION HISTORY + ================ +-- +2.51.0 + diff --git a/src/3rdparty/dr_libs/LICENSE b/src/3rdparty/dr_libs/LICENSE new file mode 100644 index 0000000..16dfbdf --- /dev/null +++ b/src/3rdparty/dr_libs/LICENSE @@ -0,0 +1,47 @@ +This software is available as a choice of the following licenses. Choose +whichever you prefer. + +=============================================================================== +ALTERNATIVE 1 - Public Domain (www.unlicense.org) +=============================================================================== +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or distribute this +software, either in source code form or as a compiled binary, for any purpose, +commercial or non-commercial, and by any means. + +In jurisdictions that recognize copyright laws, the author or authors of this +software dedicate any and all copyright interest in the software to the public +domain. We make this dedication for the benefit of the public at large and to +the detriment of our heirs and successors. We intend this dedication to be an +overt act of relinquishment in perpetuity of all present and future rights to +this software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to + +=============================================================================== +ALTERNATIVE 2 - MIT No Attribution +=============================================================================== +Copyright 2020 David Reid + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/src/3rdparty/dr_libs/REUSE.toml b/src/3rdparty/dr_libs/REUSE.toml new file mode 100644 index 0000000..6be852a --- /dev/null +++ b/src/3rdparty/dr_libs/REUSE.toml @@ -0,0 +1,6 @@ +version = 1 + +[[annotations]] +path = ["**"] +SPDX-FileCopyrightText = ["Copyright 2023 David Reid"] +SPDX-License-Identifier = "MIT-0" diff --git a/src/3rdparty/dr_libs/dr_wav.h b/src/3rdparty/dr_libs/dr_wav.h new file mode 100644 index 0000000..43a71b2 --- /dev/null +++ b/src/3rdparty/dr_libs/dr_wav.h @@ -0,0 +1,9116 @@ +/* +WAV audio loader and writer. Choice of public domain or MIT-0. See license statements at the end of this file. +dr_wav - v0.14.6 - TBD + +David Reid - mackron@gmail.com + +GitHub: https://github.com/mackron/dr_libs +*/ + +/* +Introduction +============ +This is a single file library. To use it, do something like the following in one .c file. + + ```c + #define DR_WAV_IMPLEMENTATION + #include "dr_wav.h" + ``` + +You can then #include this file in other parts of the program as you would with any other header file. Do something like the following to read audio data: + + ```c + drwav wav; + if (!drwav_init_file(&wav, "my_song.wav", NULL)) { + // Error opening WAV file. + } + + drwav_int32* pDecodedInterleavedPCMFrames = malloc(wav.totalPCMFrameCount * wav.channels * sizeof(drwav_int32)); + size_t numberOfSamplesActuallyDecoded = drwav_read_pcm_frames_s32(&wav, wav.totalPCMFrameCount, pDecodedInterleavedPCMFrames); + + ... + + drwav_uninit(&wav); + ``` + +If you just want to quickly open and read the audio data in a single operation you can do something like this: + + ```c + unsigned int channels; + unsigned int sampleRate; + drwav_uint64 totalPCMFrameCount; + float* pSampleData = drwav_open_file_and_read_pcm_frames_f32("my_song.wav", &channels, &sampleRate, &totalPCMFrameCount, NULL); + if (pSampleData == NULL) { + // Error opening and reading WAV file. + } + + ... + + drwav_free(pSampleData, NULL); + ``` + +The examples above use versions of the API that convert the audio data to a consistent format (32-bit signed PCM, in this case), but you can still output the +audio data in its internal format (see notes below for supported formats): + + ```c + size_t framesRead = drwav_read_pcm_frames(&wav, wav.totalPCMFrameCount, pDecodedInterleavedPCMFrames); + ``` + +You can also read the raw bytes of audio data, which could be useful if dr_wav does not have native support for a particular data format: + + ```c + size_t bytesRead = drwav_read_raw(&wav, bytesToRead, pRawDataBuffer); + ``` + +dr_wav can also be used to output WAV files. This does not currently support compressed formats. To use this, look at `drwav_init_write()`, +`drwav_init_file_write()`, etc. Use `drwav_write_pcm_frames()` to write samples, or `drwav_write_raw()` to write raw data in the "data" chunk. + + ```c + drwav_data_format format; + format.container = drwav_container_riff; // <-- drwav_container_riff = normal WAV files, drwav_container_w64 = Sony Wave64. + format.format = DR_WAVE_FORMAT_PCM; // <-- Any of the DR_WAVE_FORMAT_* codes. + format.channels = 2; + format.sampleRate = 44100; + format.bitsPerSample = 16; + drwav_init_file_write(&wav, "data/recording.wav", &format, NULL); + + ... + + drwav_uint64 framesWritten = drwav_write_pcm_frames(pWav, frameCount, pSamples); + ``` + +Note that writing to AIFF or RIFX is not supported. + +dr_wav has support for decoding from a number of different encapsulation formats. See below for details. + + +Build Options +============= +#define these options before including this file. + +#define DR_WAV_NO_CONVERSION_API + Disables conversion APIs such as `drwav_read_pcm_frames_f32()` and `drwav_s16_to_f32()`. + +#define DR_WAV_NO_STDIO + Disables APIs that initialize a decoder from a file such as `drwav_init_file()`, `drwav_init_file_write()`, etc. + +#define DR_WAV_NO_WCHAR + Disables all functions ending with `_w`. Use this if your compiler does not provide wchar.h. Not required if DR_WAV_NO_STDIO is also defined. + + +Supported Encapsulations +======================== +- RIFF (Regular WAV) +- RIFX (Big-Endian) +- AIFF (Does not currently support ADPCM) +- RF64 +- W64 + +Note that AIFF and RIFX do not support write mode, nor do they support reading of metadata. + + +Supported Encodings +=================== +- Unsigned 8-bit PCM +- Signed 12-bit PCM +- Signed 16-bit PCM +- Signed 24-bit PCM +- Signed 32-bit PCM +- IEEE 32-bit floating point +- IEEE 64-bit floating point +- A-law and u-law +- Microsoft ADPCM +- IMA ADPCM (DVI, format code 0x11) + +8-bit PCM encodings are always assumed to be unsigned. Signed 8-bit encoding can only be read with `drwav_read_raw()`. + +Note that ADPCM is not currently supported with AIFF. Contributions welcome. + + +Notes +===== +- Samples are always interleaved. +- The default read function does not do any data conversion. Use `drwav_read_pcm_frames_f32()`, `drwav_read_pcm_frames_s32()` and `drwav_read_pcm_frames_s16()` + to read and convert audio data to 32-bit floating point, signed 32-bit integer and signed 16-bit integer samples respectively. +- dr_wav will try to read the WAV file as best it can, even if it's not strictly conformant to the WAV format. +*/ + +#ifndef dr_wav_h +#define dr_wav_h + +#ifdef __cplusplus +extern "C" { +#endif + +#define DRWAV_STRINGIFY(x) #x +#define DRWAV_XSTRINGIFY(x) DRWAV_STRINGIFY(x) + +#define DRWAV_VERSION_MAJOR 0 +#define DRWAV_VERSION_MINOR 14 +#define DRWAV_VERSION_REVISION 6 +#define DRWAV_VERSION_STRING DRWAV_XSTRINGIFY(DRWAV_VERSION_MAJOR) "." DRWAV_XSTRINGIFY(DRWAV_VERSION_MINOR) "." DRWAV_XSTRINGIFY(DRWAV_VERSION_REVISION) + +#include /* For size_t. */ +QT_BEGIN_NAMESPACE +namespace QtPrivate { + +/* Sized Types */ +typedef signed char drwav_int8; +typedef unsigned char drwav_uint8; +typedef signed short drwav_int16; +typedef unsigned short drwav_uint16; +typedef signed int drwav_int32; +typedef unsigned int drwav_uint32; +#if defined(_MSC_VER) && !defined(__clang__) + typedef signed __int64 drwav_int64; + typedef unsigned __int64 drwav_uint64; +#else + #if defined(__clang__) || (defined(__GNUC__) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6))) + #pragma GCC diagnostic push + #pragma GCC diagnostic ignored "-Wlong-long" + #if defined(__clang__) + #pragma GCC diagnostic ignored "-Wc++11-long-long" + #endif + #endif + typedef signed long long drwav_int64; + typedef unsigned long long drwav_uint64; + #if defined(__clang__) || (defined(__GNUC__) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6))) + #pragma GCC diagnostic pop + #endif +#endif +#if defined(__LP64__) || defined(_WIN64) || (defined(__x86_64__) && !defined(__ILP32__)) || defined(_M_X64) || defined(__ia64) || defined (_M_IA64) || defined(__aarch64__) || defined(_M_ARM64) || defined(_M_ARM64EC) || defined(__powerpc64__) + typedef drwav_uint64 drwav_uintptr; +#else + typedef drwav_uint32 drwav_uintptr; +#endif +typedef drwav_uint8 drwav_bool8; +typedef drwav_uint32 drwav_bool32; +#define DRWAV_TRUE 1 +#define DRWAV_FALSE 0 +/* End Sized Types */ + +/* Decorations */ +#if !defined(DRWAV_API) + #if defined(DRWAV_DLL) + #if defined(_WIN32) + #define DRWAV_DLL_IMPORT __declspec(dllimport) + #define DRWAV_DLL_EXPORT __declspec(dllexport) + #define DRWAV_DLL_PRIVATE static + #else + #if defined(__GNUC__) && __GNUC__ >= 4 + #define DRWAV_DLL_IMPORT __attribute__((visibility("default"))) + #define DRWAV_DLL_EXPORT __attribute__((visibility("default"))) + #define DRWAV_DLL_PRIVATE __attribute__((visibility("hidden"))) + #else + #define DRWAV_DLL_IMPORT + #define DRWAV_DLL_EXPORT + #define DRWAV_DLL_PRIVATE static + #endif + #endif + + #if defined(DR_WAV_IMPLEMENTATION) || defined(DRWAV_IMPLEMENTATION) + #define DRWAV_API DRWAV_DLL_EXPORT + #else + #define DRWAV_API DRWAV_DLL_IMPORT + #endif + #define DRWAV_PRIVATE DRWAV_DLL_PRIVATE + #else + #define DRWAV_API extern + #define DRWAV_PRIVATE static + #endif +#endif +/* End Decorations */ + +/* Result Codes */ +typedef drwav_int32 drwav_result; +#define DRWAV_SUCCESS 0 +#define DRWAV_ERROR -1 /* A generic error. */ +#define DRWAV_INVALID_ARGS -2 +#define DRWAV_INVALID_OPERATION -3 +#define DRWAV_OUT_OF_MEMORY -4 +#define DRWAV_OUT_OF_RANGE -5 +#define DRWAV_ACCESS_DENIED -6 +#define DRWAV_DOES_NOT_EXIST -7 +#define DRWAV_ALREADY_EXISTS -8 +#define DRWAV_TOO_MANY_OPEN_FILES -9 +#define DRWAV_INVALID_FILE -10 +#define DRWAV_TOO_BIG -11 +#define DRWAV_PATH_TOO_LONG -12 +#define DRWAV_NAME_TOO_LONG -13 +#define DRWAV_NOT_DIRECTORY -14 +#define DRWAV_IS_DIRECTORY -15 +#define DRWAV_DIRECTORY_NOT_EMPTY -16 +#define DRWAV_END_OF_FILE -17 +#define DRWAV_NO_SPACE -18 +#define DRWAV_BUSY -19 +#define DRWAV_IO_ERROR -20 +#define DRWAV_INTERRUPT -21 +#define DRWAV_UNAVAILABLE -22 +#define DRWAV_ALREADY_IN_USE -23 +#define DRWAV_BAD_ADDRESS -24 +#define DRWAV_BAD_SEEK -25 +#define DRWAV_BAD_PIPE -26 +#define DRWAV_DEADLOCK -27 +#define DRWAV_TOO_MANY_LINKS -28 +#define DRWAV_NOT_IMPLEMENTED -29 +#define DRWAV_NO_MESSAGE -30 +#define DRWAV_BAD_MESSAGE -31 +#define DRWAV_NO_DATA_AVAILABLE -32 +#define DRWAV_INVALID_DATA -33 +#define DRWAV_TIMEOUT -34 +#define DRWAV_NO_NETWORK -35 +#define DRWAV_NOT_UNIQUE -36 +#define DRWAV_NOT_SOCKET -37 +#define DRWAV_NO_ADDRESS -38 +#define DRWAV_BAD_PROTOCOL -39 +#define DRWAV_PROTOCOL_UNAVAILABLE -40 +#define DRWAV_PROTOCOL_NOT_SUPPORTED -41 +#define DRWAV_PROTOCOL_FAMILY_NOT_SUPPORTED -42 +#define DRWAV_ADDRESS_FAMILY_NOT_SUPPORTED -43 +#define DRWAV_SOCKET_NOT_SUPPORTED -44 +#define DRWAV_CONNECTION_RESET -45 +#define DRWAV_ALREADY_CONNECTED -46 +#define DRWAV_NOT_CONNECTED -47 +#define DRWAV_CONNECTION_REFUSED -48 +#define DRWAV_NO_HOST -49 +#define DRWAV_IN_PROGRESS -50 +#define DRWAV_CANCELLED -51 +#define DRWAV_MEMORY_ALREADY_MAPPED -52 +#define DRWAV_AT_END -53 +/* End Result Codes */ + +/* Common data formats. */ +#define DR_WAVE_FORMAT_PCM 0x1 +#define DR_WAVE_FORMAT_ADPCM 0x2 +#define DR_WAVE_FORMAT_IEEE_FLOAT 0x3 +#define DR_WAVE_FORMAT_ALAW 0x6 +#define DR_WAVE_FORMAT_MULAW 0x7 +#define DR_WAVE_FORMAT_DVI_ADPCM 0x11 +#define DR_WAVE_FORMAT_EXTENSIBLE 0xFFFE + +/* Flags to pass into drwav_init_ex(), etc. */ +#define DRWAV_SEQUENTIAL 0x00000001 +#define DRWAV_WITH_METADATA 0x00000002 + +DRWAV_API void drwav_version(drwav_uint32* pMajor, drwav_uint32* pMinor, drwav_uint32* pRevision); +DRWAV_API const char* drwav_version_string(void); + +/* Allocation Callbacks */ +typedef struct +{ + void* pUserData; + void* (* onMalloc)(size_t sz, void* pUserData); + void* (* onRealloc)(void* p, size_t sz, void* pUserData); + void (* onFree)(void* p, void* pUserData); +} drwav_allocation_callbacks; +/* End Allocation Callbacks */ + +typedef enum +{ + DRWAV_SEEK_SET, + DRWAV_SEEK_CUR, + DRWAV_SEEK_END +} drwav_seek_origin; + +typedef enum +{ + drwav_container_riff, + drwav_container_rifx, + drwav_container_w64, + drwav_container_rf64, + drwav_container_aiff +} drwav_container; + +typedef struct +{ + union + { + drwav_uint8 fourcc[4]; + drwav_uint8 guid[16]; + } id; + + /* The size in bytes of the chunk. */ + drwav_uint64 sizeInBytes; + + /* + RIFF = 2 byte alignment. + W64 = 8 byte alignment. + */ + unsigned int paddingSize; +} drwav_chunk_header; + +typedef struct +{ + /* + The format tag exactly as specified in the wave file's "fmt" chunk. This can be used by applications + that require support for data formats not natively supported by dr_wav. + */ + drwav_uint16 formatTag; + + /* The number of channels making up the audio data. When this is set to 1 it is mono, 2 is stereo, etc. */ + drwav_uint16 channels; + + /* The sample rate. Usually set to something like 44100. */ + drwav_uint32 sampleRate; + + /* Average bytes per second. You probably don't need this, but it's left here for informational purposes. */ + drwav_uint32 avgBytesPerSec; + + /* Block align. This is equal to the number of channels * bytes per sample. */ + drwav_uint16 blockAlign; + + /* Bits per sample. */ + drwav_uint16 bitsPerSample; + + /* The size of the extended data. Only used internally for validation, but left here for informational purposes. */ + drwav_uint16 extendedSize; + + /* + The number of valid bits per sample. When is equal to WAVE_FORMAT_EXTENSIBLE, + is always rounded up to the nearest multiple of 8. This variable contains information about exactly how + many bits are valid per sample. Mainly used for informational purposes. + */ + drwav_uint16 validBitsPerSample; + + /* The channel mask. Not used at the moment. */ + drwav_uint32 channelMask; + + /* The sub-format, exactly as specified by the wave file. */ + drwav_uint8 subFormat[16]; +} drwav_fmt; + +DRWAV_API drwav_uint16 drwav_fmt_get_format(const drwav_fmt* pFMT); + + +/* +Callback for when data is read. Return value is the number of bytes actually read. + +pUserData [in] The user data that was passed to drwav_init() and family. +pBufferOut [out] The output buffer. +bytesToRead [in] The number of bytes to read. + +Returns the number of bytes actually read. + +A return value of less than bytesToRead indicates the end of the stream. Do _not_ return from this callback until +either the entire bytesToRead is filled or you have reached the end of the stream. +*/ +typedef size_t (* drwav_read_proc)(void* pUserData, void* pBufferOut, size_t bytesToRead); + +/* +Callback for when data is written. Returns value is the number of bytes actually written. + +pUserData [in] The user data that was passed to drwav_init_write() and family. +pData [out] A pointer to the data to write. +bytesToWrite [in] The number of bytes to write. + +Returns the number of bytes actually written. + +If the return value differs from bytesToWrite, it indicates an error. +*/ +typedef size_t (* drwav_write_proc)(void* pUserData, const void* pData, size_t bytesToWrite); + +/* +Callback for when data needs to be seeked. + +pUserData [in] The user data that was passed to drwav_init() and family. +offset [in] The number of bytes to move, relative to the origin. Will never be negative. +origin [in] The origin of the seek - the current position or the start of the stream. + +Returns whether or not the seek was successful. + +Whether or not it is relative to the beginning or current position is determined by the "origin" parameter which will be either DRWAV_SEEK_SET or +DRWAV_SEEK_CUR. +*/ +typedef drwav_bool32 (* drwav_seek_proc)(void* pUserData, int offset, drwav_seek_origin origin); + +/* +Callback for when the current position in the stream needs to be retrieved. + +pUserData [in] The user data that was passed to drwav_init() and family. +pCursor [out] A pointer to a variable to receive the current position in the stream. + +Returns whether or not the operation was successful. +*/ +typedef drwav_bool32 (* drwav_tell_proc)(void* pUserData, drwav_int64* pCursor); + +/* +Callback for when drwav_init_ex() finds a chunk. + +pChunkUserData [in] The user data that was passed to the pChunkUserData parameter of drwav_init_ex() and family. +onRead [in] A pointer to the function to call when reading. +onSeek [in] A pointer to the function to call when seeking. +pReadSeekUserData [in] The user data that was passed to the pReadSeekUserData parameter of drwav_init_ex() and family. +pChunkHeader [in] A pointer to an object containing basic header information about the chunk. Use this to identify the chunk. +container [in] Whether or not the WAV file is a RIFF or Wave64 container. If you're unsure of the difference, assume RIFF. +pFMT [in] A pointer to the object containing the contents of the "fmt" chunk. + +Returns the number of bytes read + seeked. + +To read data from the chunk, call onRead(), passing in pReadSeekUserData as the first parameter. Do the same for seeking with onSeek(). The return value must +be the total number of bytes you have read _plus_ seeked. + +Use the `container` argument to discriminate the fields in `pChunkHeader->id`. If the container is `drwav_container_riff` or `drwav_container_rf64` you should +use `id.fourcc`, otherwise you should use `id.guid`. + +The `pFMT` parameter can be used to determine the data format of the wave file. Use `drwav_fmt_get_format()` to get the sample format, which will be one of the +`DR_WAVE_FORMAT_*` identifiers. + +The read pointer will be sitting on the first byte after the chunk's header. You must not attempt to read beyond the boundary of the chunk. +*/ +typedef drwav_uint64 (* drwav_chunk_proc)(void* pChunkUserData, drwav_read_proc onRead, drwav_seek_proc onSeek, void* pReadSeekUserData, const drwav_chunk_header* pChunkHeader, drwav_container container, const drwav_fmt* pFMT); + + +/* Structure for internal use. Only used for loaders opened with drwav_init_memory(). */ +typedef struct +{ + const drwav_uint8* data; + size_t dataSize; + size_t currentReadPos; +} drwav__memory_stream; + +/* Structure for internal use. Only used for writers opened with drwav_init_memory_write(). */ +typedef struct +{ + void** ppData; + size_t* pDataSize; + size_t dataSize; + size_t dataCapacity; + size_t currentWritePos; +} drwav__memory_stream_write; + +typedef struct +{ + drwav_container container; /* RIFF, W64. */ + drwav_uint32 format; /* DR_WAVE_FORMAT_* */ + drwav_uint32 channels; + drwav_uint32 sampleRate; + drwav_uint32 bitsPerSample; +} drwav_data_format; + +typedef enum +{ + drwav_metadata_type_none = 0, + + /* + Unknown simply means a chunk that drwav does not handle specifically. You can still ask to + receive these chunks as metadata objects. It is then up to you to interpret the chunk's data. + You can also write unknown metadata to a wav file. Be careful writing unknown chunks if you + have also edited the audio data. The unknown chunks could represent offsets/sizes that no + longer correctly correspond to the audio data. + */ + drwav_metadata_type_unknown = 1 << 0, + + /* Only 1 of each of these metadata items are allowed in a wav file. */ + drwav_metadata_type_smpl = 1 << 1, + drwav_metadata_type_inst = 1 << 2, + drwav_metadata_type_cue = 1 << 3, + drwav_metadata_type_acid = 1 << 4, + drwav_metadata_type_bext = 1 << 5, + + /* + Wav files often have a LIST chunk. This is a chunk that contains a set of subchunks. For this + higher-level metadata API, we don't make a distinction between a regular chunk and a LIST + subchunk. Instead, they are all just 'metadata' items. + + There can be multiple of these metadata items in a wav file. + */ + drwav_metadata_type_list_label = 1 << 6, + drwav_metadata_type_list_note = 1 << 7, + drwav_metadata_type_list_labelled_cue_region = 1 << 8, + + drwav_metadata_type_list_info_software = 1 << 9, + drwav_metadata_type_list_info_copyright = 1 << 10, + drwav_metadata_type_list_info_title = 1 << 11, + drwav_metadata_type_list_info_artist = 1 << 12, + drwav_metadata_type_list_info_comment = 1 << 13, + drwav_metadata_type_list_info_date = 1 << 14, + drwav_metadata_type_list_info_genre = 1 << 15, + drwav_metadata_type_list_info_album = 1 << 16, + drwav_metadata_type_list_info_tracknumber = 1 << 17, + drwav_metadata_type_list_info_location = 1 << 18, + drwav_metadata_type_list_info_organization = 1 << 19, + drwav_metadata_type_list_info_keywords = 1 << 20, + drwav_metadata_type_list_info_medium = 1 << 21, + drwav_metadata_type_list_info_description = 1 << 22, + + /* Other type constants for convenience. */ + drwav_metadata_type_list_all_info_strings = drwav_metadata_type_list_info_software + | drwav_metadata_type_list_info_copyright + | drwav_metadata_type_list_info_title + | drwav_metadata_type_list_info_artist + | drwav_metadata_type_list_info_comment + | drwav_metadata_type_list_info_date + | drwav_metadata_type_list_info_genre + | drwav_metadata_type_list_info_album + | drwav_metadata_type_list_info_tracknumber + | drwav_metadata_type_list_info_location + | drwav_metadata_type_list_info_organization + | drwav_metadata_type_list_info_keywords + | drwav_metadata_type_list_info_medium + | drwav_metadata_type_list_info_description, + + drwav_metadata_type_list_all_adtl = drwav_metadata_type_list_label + | drwav_metadata_type_list_note + | drwav_metadata_type_list_labelled_cue_region, + + drwav_metadata_type_all = -2, /*0xFFFFFFFF & ~drwav_metadata_type_unknown,*/ + drwav_metadata_type_all_including_unknown = -1 /*0xFFFFFFFF,*/ +} drwav_metadata_type; + +/* +Sampler Metadata + +The sampler chunk contains information about how a sound should be played in the context of a whole +audio production, and when used in a sampler. See https://en.wikipedia.org/wiki/Sample-based_synthesis. +*/ +typedef enum +{ + drwav_smpl_loop_type_forward = 0, + drwav_smpl_loop_type_pingpong = 1, + drwav_smpl_loop_type_backward = 2 +} drwav_smpl_loop_type; + +typedef struct +{ + /* The ID of the associated cue point, see drwav_cue and drwav_cue_point. As with all cue point IDs, this can correspond to a label chunk to give this loop a name, see drwav_list_label_or_note. */ + drwav_uint32 cuePointId; + + /* See drwav_smpl_loop_type. */ + drwav_uint32 type; + + /* The offset of the first sample to be played in the loop. */ + drwav_uint32 firstSampleOffset; + + /* The offset into the audio data of the last sample to be played in the loop. */ + drwav_uint32 lastSampleOffset; + + /* A value to represent that playback should occur at a point between samples. This value ranges from 0 to UINT32_MAX. Where a value of 0 means no fraction, and a value of (UINT32_MAX / 2) would mean half a sample. */ + drwav_uint32 sampleFraction; + + /* Number of times to play the loop. 0 means loop infinitely. */ + drwav_uint32 playCount; +} drwav_smpl_loop; + +typedef struct +{ + /* IDs for a particular MIDI manufacturer. 0 if not used. */ + drwav_uint32 manufacturerId; + drwav_uint32 productId; + + /* The period of 1 sample in nanoseconds. */ + drwav_uint32 samplePeriodNanoseconds; + + /* The MIDI root note of this file. 0 to 127. */ + drwav_uint32 midiUnityNote; + + /* The fraction of a semitone up from the given MIDI note. This is a value from 0 to UINT32_MAX, where 0 means no change and (UINT32_MAX / 2) is half a semitone (AKA 50 cents). */ + drwav_uint32 midiPitchFraction; + + /* Data relating to SMPTE standards which are used for syncing audio and video. 0 if not used. */ + drwav_uint32 smpteFormat; + drwav_uint32 smpteOffset; + + /* drwav_smpl_loop loops. */ + drwav_uint32 sampleLoopCount; + + /* Optional sampler-specific data. */ + drwav_uint32 samplerSpecificDataSizeInBytes; + + drwav_smpl_loop* pLoops; + drwav_uint8* pSamplerSpecificData; +} drwav_smpl; + +/* +Instrument Metadata + +The inst metadata contains data about how a sound should be played as part of an instrument. This +commonly read by samplers. See https://en.wikipedia.org/wiki/Sample-based_synthesis. +*/ +typedef struct +{ + drwav_int8 midiUnityNote; /* The root note of the audio as a MIDI note number. 0 to 127. */ + drwav_int8 fineTuneCents; /* -50 to +50 */ + drwav_int8 gainDecibels; /* -64 to +64 */ + drwav_int8 lowNote; /* 0 to 127 */ + drwav_int8 highNote; /* 0 to 127 */ + drwav_int8 lowVelocity; /* 1 to 127 */ + drwav_int8 highVelocity; /* 1 to 127 */ +} drwav_inst; + +/* +Cue Metadata + +Cue points are markers at specific points in the audio. They often come with an associated piece of +drwav_list_label_or_note metadata which contains the text for the marker. +*/ +typedef struct +{ + /* Unique identification value. */ + drwav_uint32 id; + + /* Set to 0. This is only relevant if there is a 'playlist' chunk - which is not supported by dr_wav. */ + drwav_uint32 playOrderPosition; + + /* Should always be "data". This represents the fourcc value of the chunk that this cue point corresponds to. dr_wav only supports a single data chunk so this should always be "data". */ + drwav_uint8 dataChunkId[4]; + + /* Set to 0. This is only relevant if there is a wave list chunk. dr_wav, like lots of readers/writers, do not support this. */ + drwav_uint32 chunkStart; + + /* Set to 0 for uncompressed formats. Else the last byte in compressed wave data where decompression can begin to find the value of the corresponding sample value. */ + drwav_uint32 blockStart; + + /* For uncompressed formats this is the offset of the cue point into the audio data. For compressed formats this is relative to the block specified with blockStart. */ + drwav_uint32 sampleOffset; +} drwav_cue_point; + +typedef struct +{ + drwav_uint32 cuePointCount; + drwav_cue_point *pCuePoints; +} drwav_cue; + +/* +Acid Metadata + +This chunk contains some information about the time signature and the tempo of the audio. +*/ +typedef enum +{ + drwav_acid_flag_one_shot = 1, /* If this is not set, then it is a loop instead of a one-shot. */ + drwav_acid_flag_root_note_set = 2, + drwav_acid_flag_stretch = 4, + drwav_acid_flag_disk_based = 8, + drwav_acid_flag_acidizer = 16 /* Not sure what this means. */ +} drwav_acid_flag; + +typedef struct +{ + /* A bit-field, see drwav_acid_flag. */ + drwav_uint32 flags; + + /* Valid if flags contains drwav_acid_flag_root_note_set. It represents the MIDI root note the file - a value from 0 to 127. */ + drwav_uint16 midiUnityNote; + + /* Reserved values that should probably be ignored. reserved1 seems to often be 128 and reserved2 is 0. */ + drwav_uint16 reserved1; + float reserved2; + + /* Number of beats. */ + drwav_uint32 numBeats; + + /* The time signature of the audio. */ + drwav_uint16 meterDenominator; + drwav_uint16 meterNumerator; + + /* Beats per minute of the track. Setting a value of 0 suggests that there is no tempo. */ + float tempo; +} drwav_acid; + +/* +Cue Label or Note metadata + +These are 2 different types of metadata, but they have the exact same format. Labels tend to be the +more common and represent a short name for a cue point. Notes might be used to represent a longer +comment. +*/ +typedef struct +{ + /* The ID of a cue point that this label or note corresponds to. */ + drwav_uint32 cuePointId; + + /* Size of the string not including any null terminator. */ + drwav_uint32 stringLength; + + /* The string. The *init_with_metadata functions null terminate this for convenience. */ + char* pString; +} drwav_list_label_or_note; + +/* +BEXT metadata, also known as Broadcast Wave Format (BWF) + +This metadata adds some extra description to an audio file. You must check the version field to +determine if the UMID or the loudness fields are valid. +*/ +typedef struct +{ + /* + These top 3 fields, and the umid field are actually defined in the standard as a statically + sized buffers. In order to reduce the size of this struct (and therefore the union in the + metadata struct), we instead store these as pointers. + */ + char* pDescription; /* Can be NULL or a null-terminated string, must be <= 256 characters. */ + char* pOriginatorName; /* Can be NULL or a null-terminated string, must be <= 32 characters. */ + char* pOriginatorReference; /* Can be NULL or a null-terminated string, must be <= 32 characters. */ + char pOriginationDate[10]; /* ASCII "yyyy:mm:dd". */ + char pOriginationTime[8]; /* ASCII "hh:mm:ss". */ + drwav_uint64 timeReference; /* First sample count since midnight. */ + drwav_uint16 version; /* Version of the BWF, check this to see if the fields below are valid. */ + + /* + Unrestricted ASCII characters containing a collection of strings terminated by CR/LF. Each + string shall contain a description of a coding process applied to the audio data. + */ + char* pCodingHistory; + drwav_uint32 codingHistorySize; + + /* Fields below this point are only valid if the version is 1 or above. */ + drwav_uint8* pUMID; /* Exactly 64 bytes of SMPTE UMID */ + + /* Fields below this point are only valid if the version is 2 or above. */ + drwav_uint16 loudnessValue; /* Integrated Loudness Value of the file in LUFS (multiplied by 100). */ + drwav_uint16 loudnessRange; /* Loudness Range of the file in LU (multiplied by 100). */ + drwav_uint16 maxTruePeakLevel; /* Maximum True Peak Level of the file expressed as dBTP (multiplied by 100). */ + drwav_uint16 maxMomentaryLoudness; /* Highest value of the Momentary Loudness Level of the file in LUFS (multiplied by 100). */ + drwav_uint16 maxShortTermLoudness; /* Highest value of the Short-Term Loudness Level of the file in LUFS (multiplied by 100). */ +} drwav_bext; + +/* +Info Text Metadata + +There a many different types of information text that can be saved in this format. This is where +things like the album name, the artists, the year it was produced, etc are saved. See +drwav_metadata_type for the full list of types that dr_wav supports. +*/ +typedef struct +{ + /* Size of the string not including any null terminator. */ + drwav_uint32 stringLength; + + /* The string. The *init_with_metadata functions null terminate this for convenience. */ + char* pString; +} drwav_list_info_text; + +/* +Labelled Cue Region Metadata + +The labelled cue region metadata is used to associate some region of audio with text. The region +starts at a cue point, and extends for the given number of samples. +*/ +typedef struct +{ + /* The ID of a cue point that this object corresponds to. */ + drwav_uint32 cuePointId; + + /* The number of samples from the cue point forwards that should be considered this region */ + drwav_uint32 sampleLength; + + /* Four characters used to say what the purpose of this region is. */ + drwav_uint8 purposeId[4]; + + /* Unsure of the exact meanings of these. It appears to be acceptable to set them all to 0. */ + drwav_uint16 country; + drwav_uint16 language; + drwav_uint16 dialect; + drwav_uint16 codePage; + + /* Size of the string not including any null terminator. */ + drwav_uint32 stringLength; + + /* The string. The *init_with_metadata functions null terminate this for convenience. */ + char* pString; +} drwav_list_labelled_cue_region; + +/* +Unknown Metadata + +This chunk just represents a type of chunk that dr_wav does not understand. + +Unknown metadata has a location attached to it. This is because wav files can have a LIST chunk +that contains subchunks. These LIST chunks can be one of two types. An adtl list, or an INFO +list. This enum is used to specify the location of a chunk that dr_wav currently doesn't support. +*/ +typedef enum +{ + drwav_metadata_location_invalid, + drwav_metadata_location_top_level, + drwav_metadata_location_inside_info_list, + drwav_metadata_location_inside_adtl_list +} drwav_metadata_location; + +typedef struct +{ + drwav_uint8 id[4]; + drwav_metadata_location chunkLocation; + drwav_uint32 dataSizeInBytes; + drwav_uint8* pData; +} drwav_unknown_metadata; + +/* +Metadata is saved as a union of all the supported types. +*/ +typedef struct +{ + /* Determines which item in the union is valid. */ + drwav_metadata_type type; + + union + { + drwav_cue cue; + drwav_smpl smpl; + drwav_acid acid; + drwav_inst inst; + drwav_bext bext; + drwav_list_label_or_note labelOrNote; /* List label or list note. */ + drwav_list_labelled_cue_region labelledCueRegion; + drwav_list_info_text infoText; /* Any of the list info types. */ + drwav_unknown_metadata unknown; + } data; +} drwav_metadata; + +typedef struct +{ + /* A pointer to the function to call when more data is needed. */ + drwav_read_proc onRead; + + /* A pointer to the function to call when data needs to be written. Only used when the drwav object is opened in write mode. */ + drwav_write_proc onWrite; + + /* A pointer to the function to call when the wav file needs to be seeked. */ + drwav_seek_proc onSeek; + + /* A pointer to the function to call when the position of the stream needs to be retrieved. */ + drwav_tell_proc onTell; + + /* The user data to pass to callbacks. */ + void* pUserData; + + /* Allocation callbacks. */ + drwav_allocation_callbacks allocationCallbacks; + + + /* Whether or not the WAV file is formatted as a standard RIFF file or W64. */ + drwav_container container; + + + /* Structure containing format information exactly as specified by the wav file. */ + drwav_fmt fmt; + + /* The sample rate. Will be set to something like 44100. */ + drwav_uint32 sampleRate; + + /* The number of channels. This will be set to 1 for monaural streams, 2 for stereo, etc. */ + drwav_uint16 channels; + + /* The bits per sample. Will be set to something like 16, 24, etc. */ + drwav_uint16 bitsPerSample; + + /* Equal to fmt.formatTag, or the value specified by fmt.subFormat if fmt.formatTag is equal to 65534 (WAVE_FORMAT_EXTENSIBLE). */ + drwav_uint16 translatedFormatTag; + + /* The total number of PCM frames making up the audio data. */ + drwav_uint64 totalPCMFrameCount; + + + /* The size in bytes of the data chunk. */ + drwav_uint64 dataChunkDataSize; + + /* The position in the stream of the first data byte of the data chunk. This is used for seeking. */ + drwav_uint64 dataChunkDataPos; + + /* The number of bytes remaining in the data chunk. */ + drwav_uint64 bytesRemaining; + + /* The current read position in PCM frames. */ + drwav_uint64 readCursorInPCMFrames; + + + /* + Only used in sequential write mode. Keeps track of the desired size of the "data" chunk at the point of initialization time. Always + set to 0 for non-sequential writes and when the drwav object is opened in read mode. Used for validation. + */ + drwav_uint64 dataChunkDataSizeTargetWrite; + + /* Keeps track of whether or not the wav writer was initialized in sequential mode. */ + drwav_bool32 isSequentialWrite; + + + /* A array of metadata. This is valid after the *init_with_metadata call returns. It will be valid until drwav_uninit() is called. You can take ownership of this data with drwav_take_ownership_of_metadata(). */ + drwav_metadata* pMetadata; + drwav_uint32 metadataCount; + + + /* A hack to avoid a DRWAV_MALLOC() when opening a decoder with drwav_init_memory(). */ + drwav__memory_stream memoryStream; + drwav__memory_stream_write memoryStreamWrite; + + + /* Microsoft ADPCM specific data. */ + struct + { + drwav_uint32 bytesRemainingInBlock; + drwav_uint16 predictor[2]; + drwav_int32 delta[2]; + drwav_int32 cachedFrames[4]; /* Samples are stored in this cache during decoding. */ + drwav_uint32 cachedFrameCount; + drwav_int32 prevFrames[2][2]; /* The previous 2 samples for each channel (2 channels at most). */ + } msadpcm; + + /* IMA ADPCM specific data. */ + struct + { + drwav_uint32 bytesRemainingInBlock; + drwav_int32 predictor[2]; + drwav_int32 stepIndex[2]; + drwav_int32 cachedFrames[16]; /* Samples are stored in this cache during decoding. */ + drwav_uint32 cachedFrameCount; + } ima; + + /* AIFF specific data. */ + struct + { + drwav_bool8 isLE; /* Will be set to true if the audio data is little-endian encoded. */ + drwav_bool8 isUnsigned; /* Only used for 8-bit samples. When set to true, will be treated as unsigned. */ + } aiff; +} drwav; + + +/* +Initializes a pre-allocated drwav object for reading. + +pWav [out] A pointer to the drwav object being initialized. +onRead [in] The function to call when data needs to be read from the client. +onSeek [in] The function to call when the read position of the client data needs to move. +onChunk [in, optional] The function to call when a chunk is enumerated at initialized time. +pUserData, pReadSeekUserData [in, optional] A pointer to application defined data that will be passed to onRead and onSeek. +pChunkUserData [in, optional] A pointer to application defined data that will be passed to onChunk. +flags [in, optional] A set of flags for controlling how things are loaded. + +Returns true if successful; false otherwise. + +Close the loader with drwav_uninit(). + +This is the lowest level function for initializing a WAV file. You can also use drwav_init_file() and drwav_init_memory() +to open the stream from a file or from a block of memory respectively. + +Possible values for flags: + DRWAV_SEQUENTIAL: Never perform a backwards seek while loading. This disables the chunk callback and will cause this function + to return as soon as the data chunk is found. Any chunks after the data chunk will be ignored. + +drwav_init() is equivalent to "drwav_init_ex(pWav, onRead, onSeek, NULL, pUserData, NULL, 0);". + +The onChunk callback is not called for the WAVE or FMT chunks. The contents of the FMT chunk can be read from pWav->fmt +after the function returns. + +See also: drwav_init_file(), drwav_init_memory(), drwav_uninit() +*/ +DRWAV_API drwav_bool32 drwav_init(drwav* pWav, drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_ex(drwav* pWav, drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, drwav_chunk_proc onChunk, void* pReadSeekTellUserData, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_with_metadata(drwav* pWav, drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks); + +/* +Initializes a pre-allocated drwav object for writing. + +onWrite [in] The function to call when data needs to be written. +onSeek [in] The function to call when the write position needs to move. +pUserData [in, optional] A pointer to application defined data that will be passed to onWrite and onSeek. +metadata, numMetadata [in, optional] An array of metadata objects that should be written to the file. The array is not edited. You are responsible for this metadata memory and it must maintain valid until drwav_uninit() is called. + +Returns true if successful; false otherwise. + +Close the writer with drwav_uninit(). + +This is the lowest level function for initializing a WAV file. You can also use drwav_init_file_write() and drwav_init_memory_write() +to open the stream from a file or from a block of memory respectively. + +If the total sample count is known, you can use drwav_init_write_sequential(). This avoids the need for dr_wav to perform +a post-processing step for storing the total sample count and the size of the data chunk which requires a backwards seek. + +See also: drwav_init_file_write(), drwav_init_memory_write(), drwav_uninit() +*/ +DRWAV_API drwav_bool32 drwav_init_write(drwav* pWav, const drwav_data_format* pFormat, drwav_write_proc onWrite, drwav_seek_proc onSeek, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_write_sequential(drwav* pWav, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, drwav_write_proc onWrite, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_write_sequential_pcm_frames(drwav* pWav, const drwav_data_format* pFormat, drwav_uint64 totalPCMFrameCount, drwav_write_proc onWrite, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_write_with_metadata(drwav* pWav, const drwav_data_format* pFormat, drwav_write_proc onWrite, drwav_seek_proc onSeek, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks, drwav_metadata* pMetadata, drwav_uint32 metadataCount); + +/* +Utility function to determine the target size of the entire data to be written (including all headers and chunks). + +Returns the target size in bytes. + +The metadata argument can be NULL meaning no metadata exists. + +Useful if the application needs to know the size to allocate. + +Only writing to the RIFF chunk and one data chunk is currently supported. + +See also: drwav_init_write(), drwav_init_file_write(), drwav_init_memory_write() +*/ +DRWAV_API drwav_uint64 drwav_target_write_size_bytes(const drwav_data_format* pFormat, drwav_uint64 totalFrameCount, drwav_metadata* pMetadata, drwav_uint32 metadataCount); + +/* +Take ownership of the metadata objects that were allocated via one of the init_with_metadata() function calls. The init_with_metdata functions perform a single heap allocation for this metadata. + +Useful if you want the data to persist beyond the lifetime of the drwav object. + +You must free the data returned from this function using drwav_free(). +*/ +DRWAV_API drwav_metadata* drwav_take_ownership_of_metadata(drwav* pWav); + +/* +Uninitializes the given drwav object. + +Use this only for objects initialized with drwav_init*() functions (drwav_init(), drwav_init_ex(), drwav_init_write(), drwav_init_write_sequential()). +*/ +DRWAV_API drwav_result drwav_uninit(drwav* pWav); + + +/* +Reads raw audio data. + +This is the lowest level function for reading audio data. It simply reads the given number of +bytes of the raw internal sample data. + +Consider using drwav_read_pcm_frames_s16(), drwav_read_pcm_frames_s32() or drwav_read_pcm_frames_f32() for +reading sample data in a consistent format. + +pBufferOut can be NULL in which case a seek will be performed. + +Returns the number of bytes actually read. +*/ +DRWAV_API size_t drwav_read_raw(drwav* pWav, size_t bytesToRead, void* pBufferOut); + +/* +Reads up to the specified number of PCM frames from the WAV file. + +The output data will be in the file's internal format, converted to native-endian byte order. Use +drwav_read_pcm_frames_s16/f32/s32() to read data in a specific format. + +If the return value is less than it means the end of the file has been reached or +you have requested more PCM frames than can possibly fit in the output buffer. + +This function will only work when sample data is of a fixed size and uncompressed. If you are +using a compressed format consider using drwav_read_raw() or drwav_read_pcm_frames_s16/s32/f32(). + +pBufferOut can be NULL in which case a seek will be performed. +*/ +DRWAV_API drwav_uint64 drwav_read_pcm_frames(drwav* pWav, drwav_uint64 framesToRead, void* pBufferOut); +DRWAV_API drwav_uint64 drwav_read_pcm_frames_le(drwav* pWav, drwav_uint64 framesToRead, void* pBufferOut); +DRWAV_API drwav_uint64 drwav_read_pcm_frames_be(drwav* pWav, drwav_uint64 framesToRead, void* pBufferOut); + +/* +Seeks to the given PCM frame. + +Returns true if successful; false otherwise. +*/ +DRWAV_API drwav_bool32 drwav_seek_to_pcm_frame(drwav* pWav, drwav_uint64 targetFrameIndex); + +/* +Retrieves the current read position in pcm frames. +*/ +DRWAV_API drwav_result drwav_get_cursor_in_pcm_frames(drwav* pWav, drwav_uint64* pCursor); + +/* +Retrieves the length of the file. +*/ +DRWAV_API drwav_result drwav_get_length_in_pcm_frames(drwav* pWav, drwav_uint64* pLength); + + +/* +Writes raw audio data. + +Returns the number of bytes actually written. If this differs from bytesToWrite, it indicates an error. +*/ +DRWAV_API size_t drwav_write_raw(drwav* pWav, size_t bytesToWrite, const void* pData); + +/* +Writes PCM frames. + +Returns the number of PCM frames written. + +Input samples need to be in native-endian byte order. On big-endian architectures the input data will be converted to +little-endian. Use drwav_write_raw() to write raw audio data without performing any conversion. +*/ +DRWAV_API drwav_uint64 drwav_write_pcm_frames(drwav* pWav, drwav_uint64 framesToWrite, const void* pData); +DRWAV_API drwav_uint64 drwav_write_pcm_frames_le(drwav* pWav, drwav_uint64 framesToWrite, const void* pData); +DRWAV_API drwav_uint64 drwav_write_pcm_frames_be(drwav* pWav, drwav_uint64 framesToWrite, const void* pData); + +/* Conversion Utilities */ +#ifndef DR_WAV_NO_CONVERSION_API + +/* +Reads a chunk of audio data and converts it to signed 16-bit PCM samples. + +pBufferOut can be NULL in which case a seek will be performed. + +Returns the number of PCM frames actually read. + +If the return value is less than it means the end of the file has been reached. +*/ +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s16(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut); +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s16le(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut); +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s16be(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut); + +/* Low-level function for converting unsigned 8-bit PCM samples to signed 16-bit PCM samples. */ +DRWAV_API void drwav_u8_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting signed 24-bit PCM samples to signed 16-bit PCM samples. */ +DRWAV_API void drwav_s24_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting signed 32-bit PCM samples to signed 16-bit PCM samples. */ +DRWAV_API void drwav_s32_to_s16(drwav_int16* pOut, const drwav_int32* pIn, size_t sampleCount); + +/* Low-level function for converting IEEE 32-bit floating point samples to signed 16-bit PCM samples. */ +DRWAV_API void drwav_f32_to_s16(drwav_int16* pOut, const float* pIn, size_t sampleCount); + +/* Low-level function for converting IEEE 64-bit floating point samples to signed 16-bit PCM samples. */ +DRWAV_API void drwav_f64_to_s16(drwav_int16* pOut, const double* pIn, size_t sampleCount); + +/* Low-level function for converting A-law samples to signed 16-bit PCM samples. */ +DRWAV_API void drwav_alaw_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting u-law samples to signed 16-bit PCM samples. */ +DRWAV_API void drwav_mulaw_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t sampleCount); + + +/* +Reads a chunk of audio data and converts it to IEEE 32-bit floating point samples. + +pBufferOut can be NULL in which case a seek will be performed. + +Returns the number of PCM frames actually read. + +If the return value is less than it means the end of the file has been reached. +*/ +DRWAV_API drwav_uint64 drwav_read_pcm_frames_f32(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut); +DRWAV_API drwav_uint64 drwav_read_pcm_frames_f32le(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut); +DRWAV_API drwav_uint64 drwav_read_pcm_frames_f32be(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut); + +/* Low-level function for converting unsigned 8-bit PCM samples to IEEE 32-bit floating point samples. */ +DRWAV_API void drwav_u8_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting signed 16-bit PCM samples to IEEE 32-bit floating point samples. */ +DRWAV_API void drwav_s16_to_f32(float* pOut, const drwav_int16* pIn, size_t sampleCount); + +/* Low-level function for converting signed 24-bit PCM samples to IEEE 32-bit floating point samples. */ +DRWAV_API void drwav_s24_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting signed 32-bit PCM samples to IEEE 32-bit floating point samples. */ +DRWAV_API void drwav_s32_to_f32(float* pOut, const drwav_int32* pIn, size_t sampleCount); + +/* Low-level function for converting IEEE 64-bit floating point samples to IEEE 32-bit floating point samples. */ +DRWAV_API void drwav_f64_to_f32(float* pOut, const double* pIn, size_t sampleCount); + +/* Low-level function for converting A-law samples to IEEE 32-bit floating point samples. */ +DRWAV_API void drwav_alaw_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting u-law samples to IEEE 32-bit floating point samples. */ +DRWAV_API void drwav_mulaw_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount); + + +/* +Reads a chunk of audio data and converts it to signed 32-bit PCM samples. + +pBufferOut can be NULL in which case a seek will be performed. + +Returns the number of PCM frames actually read. + +If the return value is less than it means the end of the file has been reached. +*/ +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s32(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut); +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s32le(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut); +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s32be(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut); + +/* Low-level function for converting unsigned 8-bit PCM samples to signed 32-bit PCM samples. */ +DRWAV_API void drwav_u8_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting signed 16-bit PCM samples to signed 32-bit PCM samples. */ +DRWAV_API void drwav_s16_to_s32(drwav_int32* pOut, const drwav_int16* pIn, size_t sampleCount); + +/* Low-level function for converting signed 24-bit PCM samples to signed 32-bit PCM samples. */ +DRWAV_API void drwav_s24_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting IEEE 32-bit floating point samples to signed 32-bit PCM samples. */ +DRWAV_API void drwav_f32_to_s32(drwav_int32* pOut, const float* pIn, size_t sampleCount); + +/* Low-level function for converting IEEE 64-bit floating point samples to signed 32-bit PCM samples. */ +DRWAV_API void drwav_f64_to_s32(drwav_int32* pOut, const double* pIn, size_t sampleCount); + +/* Low-level function for converting A-law samples to signed 32-bit PCM samples. */ +DRWAV_API void drwav_alaw_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t sampleCount); + +/* Low-level function for converting u-law samples to signed 32-bit PCM samples. */ +DRWAV_API void drwav_mulaw_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t sampleCount); + +#endif /* DR_WAV_NO_CONVERSION_API */ + + +/* High-Level Convenience Helpers */ + +#ifndef DR_WAV_NO_STDIO +/* +Helper for initializing a wave file for reading using stdio. + +This holds the internal FILE object until drwav_uninit() is called. Keep this in mind if you're caching drwav +objects because the operating system may restrict the number of file handles an application can have open at +any given time. +*/ +DRWAV_API drwav_bool32 drwav_init_file(drwav* pWav, const char* filename, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_ex(drwav* pWav, const char* filename, drwav_chunk_proc onChunk, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_w(drwav* pWav, const wchar_t* filename, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_ex_w(drwav* pWav, const wchar_t* filename, drwav_chunk_proc onChunk, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_with_metadata(drwav* pWav, const char* filename, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_with_metadata_w(drwav* pWav, const wchar_t* filename, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks); + + +/* +Helper for initializing a wave file for writing using stdio. + +This holds the internal FILE object until drwav_uninit() is called. Keep this in mind if you're caching drwav +objects because the operating system may restrict the number of file handles an application can have open at +any given time. +*/ +DRWAV_API drwav_bool32 drwav_init_file_write(drwav* pWav, const char* filename, const drwav_data_format* pFormat, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_write_sequential(drwav* pWav, const char* filename, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_write_sequential_pcm_frames(drwav* pWav, const char* filename, const drwav_data_format* pFormat, drwav_uint64 totalPCMFrameCount, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_write_w(drwav* pWav, const wchar_t* filename, const drwav_data_format* pFormat, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_write_sequential_w(drwav* pWav, const wchar_t* filename, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_file_write_sequential_pcm_frames_w(drwav* pWav, const wchar_t* filename, const drwav_data_format* pFormat, drwav_uint64 totalPCMFrameCount, const drwav_allocation_callbacks* pAllocationCallbacks); +#endif /* DR_WAV_NO_STDIO */ + +/* +Helper for initializing a loader from a pre-allocated memory buffer. + +This does not create a copy of the data. It is up to the application to ensure the buffer remains valid for +the lifetime of the drwav object. + +The buffer should contain the contents of the entire wave file, not just the sample data. +*/ +DRWAV_API drwav_bool32 drwav_init_memory(drwav* pWav, const void* data, size_t dataSize, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_memory_ex(drwav* pWav, const void* data, size_t dataSize, drwav_chunk_proc onChunk, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_memory_with_metadata(drwav* pWav, const void* data, size_t dataSize, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks); + +/* +Helper for initializing a writer which outputs data to a memory buffer. + +dr_wav will manage the memory allocations, however it is up to the caller to free the data with drwav_free(). + +The buffer will remain allocated even after drwav_uninit() is called. The buffer should not be considered valid +until after drwav_uninit() has been called. +*/ +DRWAV_API drwav_bool32 drwav_init_memory_write(drwav* pWav, void** ppData, size_t* pDataSize, const drwav_data_format* pFormat, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_memory_write_sequential(drwav* pWav, void** ppData, size_t* pDataSize, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_bool32 drwav_init_memory_write_sequential_pcm_frames(drwav* pWav, void** ppData, size_t* pDataSize, const drwav_data_format* pFormat, drwav_uint64 totalPCMFrameCount, const drwav_allocation_callbacks* pAllocationCallbacks); + + +#ifndef DR_WAV_NO_CONVERSION_API +/* +Opens and reads an entire wav file in a single operation. + +The return value is a heap-allocated buffer containing the audio data. Use drwav_free() to free the buffer. +*/ +DRWAV_API drwav_int16* drwav_open_and_read_pcm_frames_s16(drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API float* drwav_open_and_read_pcm_frames_f32(drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_int32* drwav_open_and_read_pcm_frames_s32(drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +#ifndef DR_WAV_NO_STDIO +/* +Opens and decodes an entire wav file in a single operation. + +The return value is a heap-allocated buffer containing the audio data. Use drwav_free() to free the buffer. +*/ +DRWAV_API drwav_int16* drwav_open_file_and_read_pcm_frames_s16(const char* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API float* drwav_open_file_and_read_pcm_frames_f32(const char* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_int32* drwav_open_file_and_read_pcm_frames_s32(const char* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_int16* drwav_open_file_and_read_pcm_frames_s16_w(const wchar_t* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API float* drwav_open_file_and_read_pcm_frames_f32_w(const wchar_t* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_int32* drwav_open_file_and_read_pcm_frames_s32_w(const wchar_t* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +#endif +/* +Opens and decodes an entire wav file from a block of memory in a single operation. + +The return value is a heap-allocated buffer containing the audio data. Use drwav_free() to free the buffer. +*/ +DRWAV_API drwav_int16* drwav_open_memory_and_read_pcm_frames_s16(const void* data, size_t dataSize, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API float* drwav_open_memory_and_read_pcm_frames_f32(const void* data, size_t dataSize, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +DRWAV_API drwav_int32* drwav_open_memory_and_read_pcm_frames_s32(const void* data, size_t dataSize, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks); +#endif + +/* Frees data that was allocated internally by dr_wav. */ +DRWAV_API void drwav_free(void* p, const drwav_allocation_callbacks* pAllocationCallbacks); + +/* Converts bytes from a wav stream to a sized type of native endian. */ +DRWAV_API drwav_uint16 drwav_bytes_to_u16(const drwav_uint8* data); +DRWAV_API drwav_int16 drwav_bytes_to_s16(const drwav_uint8* data); +DRWAV_API drwav_uint32 drwav_bytes_to_u32(const drwav_uint8* data); +DRWAV_API drwav_int32 drwav_bytes_to_s32(const drwav_uint8* data); +DRWAV_API drwav_uint64 drwav_bytes_to_u64(const drwav_uint8* data); +DRWAV_API drwav_int64 drwav_bytes_to_s64(const drwav_uint8* data); +DRWAV_API float drwav_bytes_to_f32(const drwav_uint8* data); + +/* Compares a GUID for the purpose of checking the type of a Wave64 chunk. */ +DRWAV_API drwav_bool32 drwav_guid_equal(const drwav_uint8 a[16], const drwav_uint8 b[16]); + +/* Compares a four-character-code for the purpose of checking the type of a RIFF chunk. */ +DRWAV_API drwav_bool32 drwav_fourcc_equal(const drwav_uint8* a, const char* b); + +} // namespace QtPrivate +QT_END_NAMESPACE +#ifdef __cplusplus +} +#endif +#endif /* dr_wav_h */ + + +/************************************************************************************************************************************************************ + ************************************************************************************************************************************************************ + + IMPLEMENTATION + + ************************************************************************************************************************************************************ + ************************************************************************************************************************************************************/ +#if defined(DR_WAV_IMPLEMENTATION) || defined(DRWAV_IMPLEMENTATION) +#ifndef dr_wav_c +#define dr_wav_c + +#ifdef __MRC__ +/* MrC currently doesn't compile dr_wav correctly with any optimizations enabled. */ +#pragma options opt off +#endif + +#include +#include +#include /* For INT_MAX */ + +#ifndef DR_WAV_NO_STDIO +#include +#ifndef DR_WAV_NO_WCHAR +#include +#endif +#endif + +/* Standard library stuff. */ +#ifndef DRWAV_ASSERT +#include +#define DRWAV_ASSERT(expression) assert(expression) +#endif +#ifndef DRWAV_MALLOC +#define DRWAV_MALLOC(sz) malloc((sz)) +#endif +#ifndef DRWAV_REALLOC +#define DRWAV_REALLOC(p, sz) realloc((p), (sz)) +#endif +#ifndef DRWAV_FREE +#define DRWAV_FREE(p) free((p)) +#endif +#ifndef DRWAV_COPY_MEMORY +#define DRWAV_COPY_MEMORY(dst, src, sz) memcpy((dst), (src), (sz)) +#endif +#ifndef DRWAV_ZERO_MEMORY +#define DRWAV_ZERO_MEMORY(p, sz) memset((p), 0, (sz)) +#endif +#ifndef DRWAV_ZERO_OBJECT +#define DRWAV_ZERO_OBJECT(p) DRWAV_ZERO_MEMORY((p), sizeof(*p)) +#endif + +#define drwav_countof(x) (sizeof(x) / sizeof(x[0])) +#define drwav_align(x, a) ((((x) + (a) - 1) / (a)) * (a)) +#define drwav_min(a, b) (((a) < (b)) ? (a) : (b)) +#define drwav_max(a, b) (((a) > (b)) ? (a) : (b)) +#define drwav_clamp(x, lo, hi) (drwav_max((lo), drwav_min((hi), (x)))) +#define drwav_offset_ptr(p, offset) (((drwav_uint8*)(p)) + (offset)) + +#define DRWAV_MAX_SIMD_VECTOR_SIZE 32 + +/* Architecture Detection */ +#if defined(__x86_64__) || (defined(_M_X64) && !defined(_M_ARM64EC)) + #define DRWAV_X64 +#elif defined(__i386) || defined(_M_IX86) + #define DRWAV_X86 +#elif defined(__arm__) || defined(_M_ARM) + #define DRWAV_ARM +#endif +/* End Architecture Detection */ + +/* Inline */ +#ifdef _MSC_VER + #define DRWAV_INLINE __forceinline +#elif defined(__GNUC__) + /* + I've had a bug report where GCC is emitting warnings about functions possibly not being inlineable. This warning happens when + the __attribute__((always_inline)) attribute is defined without an "inline" statement. I think therefore there must be some + case where "__inline__" is not always defined, thus the compiler emitting these warnings. When using -std=c89 or -ansi on the + command line, we cannot use the "inline" keyword and instead need to use "__inline__". In an attempt to work around this issue + I am using "__inline__" only when we're compiling in strict ANSI mode. + */ + #if defined(__STRICT_ANSI__) + #define DRWAV_GNUC_INLINE_HINT __inline__ + #else + #define DRWAV_GNUC_INLINE_HINT inline + #endif + + #if (__GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 2)) || defined(__clang__) + #define DRWAV_INLINE DRWAV_GNUC_INLINE_HINT __attribute__((always_inline)) + #else + #define DRWAV_INLINE DRWAV_GNUC_INLINE_HINT + #endif +#elif defined(__WATCOMC__) + #define DRWAV_INLINE __inline +#else + #define DRWAV_INLINE +#endif +/* End Inline */ + +/* SIZE_MAX */ +#if defined(SIZE_MAX) + #define DRWAV_SIZE_MAX SIZE_MAX +#else + #if defined(_WIN64) || defined(_LP64) || defined(__LP64__) + #define DRWAV_SIZE_MAX ((drwav_uint64)0xFFFFFFFFFFFFFFFF) + #else + #define DRWAV_SIZE_MAX 0xFFFFFFFF + #endif +#endif +/* End SIZE_MAX */ + +/* Weird bit manipulation is for C89 compatibility (no direct support for 64-bit integers). */ +#define DRWAV_INT64_MIN ((drwav_int64) ((drwav_uint64)0x80000000 << 32)) +#define DRWAV_INT64_MAX ((drwav_int64)(((drwav_uint64)0x7FFFFFFF << 32) | 0xFFFFFFFF)) + +#if defined(_MSC_VER) && _MSC_VER >= 1400 + #define DRWAV_HAS_BYTESWAP16_INTRINSIC + #define DRWAV_HAS_BYTESWAP32_INTRINSIC + #define DRWAV_HAS_BYTESWAP64_INTRINSIC +#elif defined(__clang__) + #if defined(__has_builtin) + #if __has_builtin(__builtin_bswap16) + #define DRWAV_HAS_BYTESWAP16_INTRINSIC + #endif + #if __has_builtin(__builtin_bswap32) + #define DRWAV_HAS_BYTESWAP32_INTRINSIC + #endif + #if __has_builtin(__builtin_bswap64) + #define DRWAV_HAS_BYTESWAP64_INTRINSIC + #endif + #endif +#elif defined(__GNUC__) + #if ((__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3)) + #define DRWAV_HAS_BYTESWAP32_INTRINSIC + #define DRWAV_HAS_BYTESWAP64_INTRINSIC + #endif + #if ((__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8)) + #define DRWAV_HAS_BYTESWAP16_INTRINSIC + #endif +#endif + +QT_BEGIN_NAMESPACE +namespace QtPrivate { + + +DRWAV_API void drwav_version(drwav_uint32* pMajor, drwav_uint32* pMinor, drwav_uint32* pRevision) +{ + if (pMajor) { + *pMajor = DRWAV_VERSION_MAJOR; + } + + if (pMinor) { + *pMinor = DRWAV_VERSION_MINOR; + } + + if (pRevision) { + *pRevision = DRWAV_VERSION_REVISION; + } +} + +DRWAV_API const char* drwav_version_string(void) +{ + return DRWAV_VERSION_STRING; +} + +/* +These limits are used for basic validation when initializing the decoder. If you exceed these limits, first of all: what on Earth are +you doing?! (Let me know, I'd be curious!) Second, you can adjust these by #define-ing them before the dr_wav implementation. +*/ +#ifndef DRWAV_MAX_SAMPLE_RATE +#define DRWAV_MAX_SAMPLE_RATE 384000 +#endif +#ifndef DRWAV_MAX_CHANNELS +#define DRWAV_MAX_CHANNELS 256 +#endif +#ifndef DRWAV_MAX_BITS_PER_SAMPLE +#define DRWAV_MAX_BITS_PER_SAMPLE 64 +#endif + +static const drwav_uint8 drwavGUID_W64_RIFF[16] = {0x72,0x69,0x66,0x66, 0x2E,0x91, 0xCF,0x11, 0xA5,0xD6, 0x28,0xDB,0x04,0xC1,0x00,0x00}; /* 66666972-912E-11CF-A5D6-28DB04C10000 */ +static const drwav_uint8 drwavGUID_W64_WAVE[16] = {0x77,0x61,0x76,0x65, 0xF3,0xAC, 0xD3,0x11, 0x8C,0xD1, 0x00,0xC0,0x4F,0x8E,0xDB,0x8A}; /* 65766177-ACF3-11D3-8CD1-00C04F8EDB8A */ +/*static const drwav_uint8 drwavGUID_W64_JUNK[16] = {0x6A,0x75,0x6E,0x6B, 0xF3,0xAC, 0xD3,0x11, 0x8C,0xD1, 0x00,0xC0,0x4F,0x8E,0xDB,0x8A};*/ /* 6B6E756A-ACF3-11D3-8CD1-00C04F8EDB8A */ +static const drwav_uint8 drwavGUID_W64_FMT [16] = {0x66,0x6D,0x74,0x20, 0xF3,0xAC, 0xD3,0x11, 0x8C,0xD1, 0x00,0xC0,0x4F,0x8E,0xDB,0x8A}; /* 20746D66-ACF3-11D3-8CD1-00C04F8EDB8A */ +static const drwav_uint8 drwavGUID_W64_FACT[16] = {0x66,0x61,0x63,0x74, 0xF3,0xAC, 0xD3,0x11, 0x8C,0xD1, 0x00,0xC0,0x4F,0x8E,0xDB,0x8A}; /* 74636166-ACF3-11D3-8CD1-00C04F8EDB8A */ +static const drwav_uint8 drwavGUID_W64_DATA[16] = {0x64,0x61,0x74,0x61, 0xF3,0xAC, 0xD3,0x11, 0x8C,0xD1, 0x00,0xC0,0x4F,0x8E,0xDB,0x8A}; /* 61746164-ACF3-11D3-8CD1-00C04F8EDB8A */ +/*static const drwav_uint8 drwavGUID_W64_SMPL[16] = {0x73,0x6D,0x70,0x6C, 0xF3,0xAC, 0xD3,0x11, 0x8C,0xD1, 0x00,0xC0,0x4F,0x8E,0xDB,0x8A};*/ /* 6C706D73-ACF3-11D3-8CD1-00C04F8EDB8A */ + + +static DRWAV_INLINE int drwav__is_little_endian(void) +{ +#if defined(DRWAV_X86) || defined(DRWAV_X64) + return DRWAV_TRUE; +#elif defined(__BYTE_ORDER) && defined(__LITTLE_ENDIAN) && __BYTE_ORDER == __LITTLE_ENDIAN + return DRWAV_TRUE; +#else + int n = 1; + return (*(char*)&n) == 1; +#endif +} + + +static DRWAV_INLINE void drwav_bytes_to_guid(const drwav_uint8* data, drwav_uint8* guid) +{ + int i; + for (i = 0; i < 16; ++i) { + guid[i] = data[i]; + } +} + + +static DRWAV_INLINE drwav_uint16 drwav__bswap16(drwav_uint16 n) +{ +#ifdef DRWAV_HAS_BYTESWAP16_INTRINSIC + #if defined(_MSC_VER) + return _byteswap_ushort(n); + #elif defined(__GNUC__) || defined(__clang__) + return __builtin_bswap16(n); + #else + #error "This compiler does not support the byte swap intrinsic." + #endif +#else + return ((n & 0xFF00) >> 8) | + ((n & 0x00FF) << 8); +#endif +} + +static DRWAV_INLINE drwav_uint32 drwav__bswap32(drwav_uint32 n) +{ +#ifdef DRWAV_HAS_BYTESWAP32_INTRINSIC + #if defined(_MSC_VER) + return _byteswap_ulong(n); + #elif defined(__GNUC__) || defined(__clang__) + #if defined(DRWAV_ARM) && (defined(__ARM_ARCH) && __ARM_ARCH >= 6) && !defined(DRWAV_64BIT) /* <-- 64-bit inline assembly has not been tested, so disabling for now. */ + /* Inline assembly optimized implementation for ARM. In my testing, GCC does not generate optimized code with __builtin_bswap32(). */ + drwav_uint32 r; + __asm__ __volatile__ ( + #if defined(DRWAV_64BIT) + "rev %w[out], %w[in]" : [out]"=r"(r) : [in]"r"(n) /* <-- This is untested. If someone in the community could test this, that would be appreciated! */ + #else + "rev %[out], %[in]" : [out]"=r"(r) : [in]"r"(n) + #endif + ); + return r; + #else + return __builtin_bswap32(n); + #endif + #else + #error "This compiler does not support the byte swap intrinsic." + #endif +#else + return ((n & 0xFF000000) >> 24) | + ((n & 0x00FF0000) >> 8) | + ((n & 0x0000FF00) << 8) | + ((n & 0x000000FF) << 24); +#endif +} + +static DRWAV_INLINE drwav_uint64 drwav__bswap64(drwav_uint64 n) +{ +#ifdef DRWAV_HAS_BYTESWAP64_INTRINSIC + #if defined(_MSC_VER) + return _byteswap_uint64(n); + #elif defined(__GNUC__) || defined(__clang__) + return __builtin_bswap64(n); + #else + #error "This compiler does not support the byte swap intrinsic." + #endif +#else + /* Weird "<< 32" bitshift is required for C89 because it doesn't support 64-bit constants. Should be optimized out by a good compiler. */ + return ((n & ((drwav_uint64)0xFF000000 << 32)) >> 56) | + ((n & ((drwav_uint64)0x00FF0000 << 32)) >> 40) | + ((n & ((drwav_uint64)0x0000FF00 << 32)) >> 24) | + ((n & ((drwav_uint64)0x000000FF << 32)) >> 8) | + ((n & ((drwav_uint64)0xFF000000 )) << 8) | + ((n & ((drwav_uint64)0x00FF0000 )) << 24) | + ((n & ((drwav_uint64)0x0000FF00 )) << 40) | + ((n & ((drwav_uint64)0x000000FF )) << 56); +#endif +} + + +static DRWAV_INLINE drwav_int16 drwav__bswap_s16(drwav_int16 n) +{ + return (drwav_int16)drwav__bswap16((drwav_uint16)n); +} + +static DRWAV_INLINE void drwav__bswap_samples_s16(drwav_int16* pSamples, drwav_uint64 sampleCount) +{ + drwav_uint64 iSample; + for (iSample = 0; iSample < sampleCount; iSample += 1) { + pSamples[iSample] = drwav__bswap_s16(pSamples[iSample]); + } +} + + +static DRWAV_INLINE void drwav__bswap_s24(drwav_uint8* p) +{ + drwav_uint8 t; + t = p[0]; + p[0] = p[2]; + p[2] = t; +} + +static DRWAV_INLINE void drwav__bswap_samples_s24(drwav_uint8* pSamples, drwav_uint64 sampleCount) +{ + drwav_uint64 iSample; + for (iSample = 0; iSample < sampleCount; iSample += 1) { + drwav_uint8* pSample = pSamples + (iSample*3); + drwav__bswap_s24(pSample); + } +} + + +static DRWAV_INLINE drwav_int32 drwav__bswap_s32(drwav_int32 n) +{ + return (drwav_int32)drwav__bswap32((drwav_uint32)n); +} + +static DRWAV_INLINE void drwav__bswap_samples_s32(drwav_int32* pSamples, drwav_uint64 sampleCount) +{ + drwav_uint64 iSample; + for (iSample = 0; iSample < sampleCount; iSample += 1) { + pSamples[iSample] = drwav__bswap_s32(pSamples[iSample]); + } +} + + +static DRWAV_INLINE drwav_int64 drwav__bswap_s64(drwav_int64 n) +{ + return (drwav_int64)drwav__bswap64((drwav_uint64)n); +} + +static DRWAV_INLINE void drwav__bswap_samples_s64(drwav_int64* pSamples, drwav_uint64 sampleCount) +{ + drwav_uint64 iSample; + for (iSample = 0; iSample < sampleCount; iSample += 1) { + pSamples[iSample] = drwav__bswap_s64(pSamples[iSample]); + } +} + + +static DRWAV_INLINE float drwav__bswap_f32(float n) +{ + union { + drwav_uint32 i; + float f; + } x; + x.f = n; + x.i = drwav__bswap32(x.i); + + return x.f; +} + +static DRWAV_INLINE void drwav__bswap_samples_f32(float* pSamples, drwav_uint64 sampleCount) +{ + drwav_uint64 iSample; + for (iSample = 0; iSample < sampleCount; iSample += 1) { + pSamples[iSample] = drwav__bswap_f32(pSamples[iSample]); + } +} + + +static DRWAV_INLINE void drwav__bswap_samples(void* pSamples, drwav_uint64 sampleCount, drwav_uint32 bytesPerSample) +{ + switch (bytesPerSample) + { + case 1: + { + /* No-op. */ + } break; + case 2: + { + drwav__bswap_samples_s16((drwav_int16*)pSamples, sampleCount); + } break; + case 3: + { + drwav__bswap_samples_s24((drwav_uint8*)pSamples, sampleCount); + } break; + case 4: + { + drwav__bswap_samples_s32((drwav_int32*)pSamples, sampleCount); + } break; + case 8: + { + drwav__bswap_samples_s64((drwav_int64*)pSamples, sampleCount); + } break; + default: + { + /* Unsupported format. */ + DRWAV_ASSERT(DRWAV_FALSE); + } break; + } +} + + + +DRWAV_PRIVATE DRWAV_INLINE drwav_bool32 drwav_is_container_be(drwav_container container) +{ + if (container == drwav_container_rifx || container == drwav_container_aiff) { + return DRWAV_TRUE; + } else { + return DRWAV_FALSE; + } +} + + +DRWAV_PRIVATE DRWAV_INLINE drwav_uint16 drwav_bytes_to_u16_le(const drwav_uint8* data) +{ + return ((drwav_uint16)data[0] << 0) | ((drwav_uint16)data[1] << 8); +} + +DRWAV_PRIVATE DRWAV_INLINE drwav_uint16 drwav_bytes_to_u16_be(const drwav_uint8* data) +{ + return ((drwav_uint16)data[1] << 0) | ((drwav_uint16)data[0] << 8); +} + +DRWAV_PRIVATE DRWAV_INLINE drwav_uint16 drwav_bytes_to_u16_ex(const drwav_uint8* data, drwav_container container) +{ + if (drwav_is_container_be(container)) { + return drwav_bytes_to_u16_be(data); + } else { + return drwav_bytes_to_u16_le(data); + } +} + + +DRWAV_PRIVATE DRWAV_INLINE drwav_uint32 drwav_bytes_to_u32_le(const drwav_uint8* data) +{ + return ((drwav_uint32)data[0] << 0) | ((drwav_uint32)data[1] << 8) | ((drwav_uint32)data[2] << 16) | ((drwav_uint32)data[3] << 24); +} + +DRWAV_PRIVATE DRWAV_INLINE drwav_uint32 drwav_bytes_to_u32_be(const drwav_uint8* data) +{ + return ((drwav_uint32)data[3] << 0) | ((drwav_uint32)data[2] << 8) | ((drwav_uint32)data[1] << 16) | ((drwav_uint32)data[0] << 24); +} + +DRWAV_PRIVATE DRWAV_INLINE drwav_uint32 drwav_bytes_to_u32_ex(const drwav_uint8* data, drwav_container container) +{ + if (drwav_is_container_be(container)) { + return drwav_bytes_to_u32_be(data); + } else { + return drwav_bytes_to_u32_le(data); + } +} + + + +DRWAV_PRIVATE drwav_int64 drwav_aiff_extented_to_s64(const drwav_uint8* data) +{ + drwav_uint32 exponent = ((drwav_uint32)data[0] << 8) | data[1]; + drwav_uint64 hi = ((drwav_uint64)data[2] << 24) | ((drwav_uint64)data[3] << 16) | ((drwav_uint64)data[4] << 8) | ((drwav_uint64)data[5] << 0); + drwav_uint64 lo = ((drwav_uint64)data[6] << 24) | ((drwav_uint64)data[7] << 16) | ((drwav_uint64)data[8] << 8) | ((drwav_uint64)data[9] << 0); + drwav_uint64 significand = (hi << 32) | lo; + int sign = exponent >> 15; + + /* Remove sign bit. */ + exponent &= 0x7FFF; + + /* Special cases. */ + if (exponent == 0 && significand == 0) { + return 0; + } else if (exponent == 0x7FFF) { + return sign ? DRWAV_INT64_MIN : DRWAV_INT64_MAX; /* Infinite. */ + } + + exponent -= 16383; + + if (exponent > 63) { + return sign ? DRWAV_INT64_MIN : DRWAV_INT64_MAX; /* Too big for a 64-bit integer. */ + } else if (exponent < 1) { + return 0; /* Number is less than 1, so rounds down to 0. */ + } + + significand >>= (63 - exponent); + + if (sign) { + return -(drwav_int64)significand; + } else { + return (drwav_int64)significand; + } +} + + +DRWAV_PRIVATE void* drwav__malloc_default(size_t sz, void* pUserData) +{ + (void)pUserData; + return DRWAV_MALLOC(sz); +} + +DRWAV_PRIVATE void* drwav__realloc_default(void* p, size_t sz, void* pUserData) +{ + (void)pUserData; + return DRWAV_REALLOC(p, sz); +} + +DRWAV_PRIVATE void drwav__free_default(void* p, void* pUserData) +{ + (void)pUserData; + DRWAV_FREE(p); +} + + +DRWAV_PRIVATE void* drwav__malloc_from_callbacks(size_t sz, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pAllocationCallbacks == NULL) { + return NULL; + } + + if (pAllocationCallbacks->onMalloc != NULL) { + return pAllocationCallbacks->onMalloc(sz, pAllocationCallbacks->pUserData); + } + + /* Try using realloc(). */ + if (pAllocationCallbacks->onRealloc != NULL) { + return pAllocationCallbacks->onRealloc(NULL, sz, pAllocationCallbacks->pUserData); + } + + return NULL; +} + +DRWAV_PRIVATE void* drwav__realloc_from_callbacks(void* p, size_t szNew, size_t szOld, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pAllocationCallbacks == NULL) { + return NULL; + } + + if (pAllocationCallbacks->onRealloc != NULL) { + return pAllocationCallbacks->onRealloc(p, szNew, pAllocationCallbacks->pUserData); + } + + /* Try emulating realloc() in terms of malloc()/free(). */ + if (pAllocationCallbacks->onMalloc != NULL && pAllocationCallbacks->onFree != NULL) { + void* p2; + + p2 = pAllocationCallbacks->onMalloc(szNew, pAllocationCallbacks->pUserData); + if (p2 == NULL) { + return NULL; + } + + if (p != NULL) { + DRWAV_COPY_MEMORY(p2, p, szOld); + pAllocationCallbacks->onFree(p, pAllocationCallbacks->pUserData); + } + + return p2; + } + + return NULL; +} + +DRWAV_PRIVATE void drwav__free_from_callbacks(void* p, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (p == NULL || pAllocationCallbacks == NULL) { + return; + } + + if (pAllocationCallbacks->onFree != NULL) { + pAllocationCallbacks->onFree(p, pAllocationCallbacks->pUserData); + } +} + + +DRWAV_PRIVATE drwav_allocation_callbacks drwav_copy_allocation_callbacks_or_defaults(const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pAllocationCallbacks != NULL) { + /* Copy. */ + return *pAllocationCallbacks; + } else { + /* Defaults. */ + drwav_allocation_callbacks allocationCallbacks; + allocationCallbacks.pUserData = NULL; + allocationCallbacks.onMalloc = drwav__malloc_default; + allocationCallbacks.onRealloc = drwav__realloc_default; + allocationCallbacks.onFree = drwav__free_default; + return allocationCallbacks; + } +} + + +static DRWAV_INLINE drwav_bool32 drwav__is_compressed_format_tag(drwav_uint16 formatTag) +{ + return + formatTag == DR_WAVE_FORMAT_ADPCM || + formatTag == DR_WAVE_FORMAT_DVI_ADPCM; +} + +DRWAV_PRIVATE unsigned int drwav__chunk_padding_size_riff(drwav_uint64 chunkSize) +{ + return (unsigned int)(chunkSize % 2); +} + +DRWAV_PRIVATE unsigned int drwav__chunk_padding_size_w64(drwav_uint64 chunkSize) +{ + return (unsigned int)(chunkSize % 8); +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s16__msadpcm(drwav* pWav, drwav_uint64 samplesToRead, drwav_int16* pBufferOut); +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s16__ima(drwav* pWav, drwav_uint64 samplesToRead, drwav_int16* pBufferOut); +DRWAV_PRIVATE drwav_bool32 drwav_init_write__internal(drwav* pWav, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount); + +DRWAV_PRIVATE drwav_result drwav__read_chunk_header(drwav_read_proc onRead, void* pUserData, drwav_container container, drwav_uint64* pRunningBytesReadOut, drwav_chunk_header* pHeaderOut) +{ + if (container == drwav_container_riff || container == drwav_container_rifx || container == drwav_container_rf64 || container == drwav_container_aiff) { + drwav_uint8 sizeInBytes[4]; + + if (onRead(pUserData, pHeaderOut->id.fourcc, 4) != 4) { + return DRWAV_AT_END; + } + + if (onRead(pUserData, sizeInBytes, 4) != 4) { + return DRWAV_INVALID_FILE; + } + + pHeaderOut->sizeInBytes = drwav_bytes_to_u32_ex(sizeInBytes, container); + pHeaderOut->paddingSize = drwav__chunk_padding_size_riff(pHeaderOut->sizeInBytes); + + *pRunningBytesReadOut += 8; + } else if (container == drwav_container_w64) { + drwav_uint8 sizeInBytes[8]; + + if (onRead(pUserData, pHeaderOut->id.guid, 16) != 16) { + return DRWAV_AT_END; + } + + if (onRead(pUserData, sizeInBytes, 8) != 8) { + return DRWAV_INVALID_FILE; + } + + pHeaderOut->sizeInBytes = drwav_bytes_to_u64(sizeInBytes); + + /* Subtract 24 from the size because with w64 the reported chunk size includes the size of the header itself. */ + if (pHeaderOut->sizeInBytes >= 24) { + pHeaderOut->sizeInBytes -= 24; + } else { + return DRWAV_INVALID_FILE; + } + + pHeaderOut->paddingSize = drwav__chunk_padding_size_w64(pHeaderOut->sizeInBytes); + *pRunningBytesReadOut += 24; + } else { + return DRWAV_INVALID_FILE; + } + + return DRWAV_SUCCESS; +} + +DRWAV_PRIVATE drwav_bool32 drwav__seek_forward(drwav_seek_proc onSeek, drwav_uint64 offset, void* pUserData) +{ + drwav_uint64 bytesRemainingToSeek = offset; + while (bytesRemainingToSeek > 0) { + if (bytesRemainingToSeek > 0x7FFFFFFF) { + if (!onSeek(pUserData, 0x7FFFFFFF, DRWAV_SEEK_CUR)) { + return DRWAV_FALSE; + } + bytesRemainingToSeek -= 0x7FFFFFFF; + } else { + if (!onSeek(pUserData, (int)bytesRemainingToSeek, DRWAV_SEEK_CUR)) { + return DRWAV_FALSE; + } + bytesRemainingToSeek = 0; + } + } + + return DRWAV_TRUE; +} + +DRWAV_PRIVATE drwav_bool32 drwav__seek_from_start(drwav_seek_proc onSeek, drwav_uint64 offset, void* pUserData) +{ + if (offset <= 0x7FFFFFFF) { + return onSeek(pUserData, (int)offset, DRWAV_SEEK_SET); + } + + /* Larger than 32-bit seek. */ + if (!onSeek(pUserData, 0x7FFFFFFF, DRWAV_SEEK_SET)) { + return DRWAV_FALSE; + } + offset -= 0x7FFFFFFF; + + for (;;) { + if (offset <= 0x7FFFFFFF) { + return onSeek(pUserData, (int)offset, DRWAV_SEEK_CUR); + } + + if (!onSeek(pUserData, 0x7FFFFFFF, DRWAV_SEEK_CUR)) { + return DRWAV_FALSE; + } + offset -= 0x7FFFFFFF; + } + + /* Should never get here. */ + /*return DRWAV_TRUE; */ +} + + + +DRWAV_PRIVATE size_t drwav__on_read(drwav_read_proc onRead, void* pUserData, void* pBufferOut, size_t bytesToRead, drwav_uint64* pCursor) +{ + size_t bytesRead; + + DRWAV_ASSERT(onRead != NULL); + DRWAV_ASSERT(pCursor != NULL); + + bytesRead = onRead(pUserData, pBufferOut, bytesToRead); + *pCursor += bytesRead; + return bytesRead; +} + +#if 0 +DRWAV_PRIVATE drwav_bool32 drwav__on_seek(drwav_seek_proc onSeek, void* pUserData, int offset, drwav_seek_origin origin, drwav_uint64* pCursor) +{ + DRWAV_ASSERT(onSeek != NULL); + DRWAV_ASSERT(pCursor != NULL); + + if (!onSeek(pUserData, offset, origin)) { + return DRWAV_FALSE; + } + + if (origin == DRWAV_SEEK_SET) { + *pCursor = offset; + } else { + *pCursor += offset; + } + + return DRWAV_TRUE; +} +#endif + + +#define DRWAV_SMPL_BYTES 36 +#define DRWAV_SMPL_LOOP_BYTES 24 +#define DRWAV_INST_BYTES 7 +#define DRWAV_ACID_BYTES 24 +#define DRWAV_CUE_BYTES 4 +#define DRWAV_BEXT_BYTES 602 +#define DRWAV_BEXT_DESCRIPTION_BYTES 256 +#define DRWAV_BEXT_ORIGINATOR_NAME_BYTES 32 +#define DRWAV_BEXT_ORIGINATOR_REF_BYTES 32 +#define DRWAV_BEXT_RESERVED_BYTES 180 +#define DRWAV_BEXT_UMID_BYTES 64 +#define DRWAV_CUE_POINT_BYTES 24 +#define DRWAV_LIST_LABEL_OR_NOTE_BYTES 4 +#define DRWAV_LIST_LABELLED_TEXT_BYTES 20 + +#define DRWAV_METADATA_ALIGNMENT 8 + +typedef enum +{ + drwav__metadata_parser_stage_count, + drwav__metadata_parser_stage_read +} drwav__metadata_parser_stage; + +typedef struct +{ + drwav_read_proc onRead; + drwav_seek_proc onSeek; + void *pReadSeekUserData; + drwav__metadata_parser_stage stage; + drwav_metadata *pMetadata; + drwav_uint32 metadataCount; + drwav_uint8 *pData; + drwav_uint8 *pDataCursor; + drwav_uint64 metadataCursor; + drwav_uint64 extraCapacity; +} drwav__metadata_parser; + +DRWAV_PRIVATE size_t drwav__metadata_memory_capacity(drwav__metadata_parser* pParser) +{ + drwav_uint64 cap = sizeof(drwav_metadata) * (drwav_uint64)pParser->metadataCount + pParser->extraCapacity; + if (cap > DRWAV_SIZE_MAX) { + return 0; /* Too big. */ + } + + return (size_t)cap; /* Safe cast thanks to the check above. */ +} + +DRWAV_PRIVATE drwav_uint8* drwav__metadata_get_memory(drwav__metadata_parser* pParser, size_t size, size_t align) +{ + drwav_uint8* pResult; + + if (align) { + drwav_uintptr modulo = (drwav_uintptr)pParser->pDataCursor % align; + if (modulo != 0) { + pParser->pDataCursor += align - modulo; + } + } + + pResult = pParser->pDataCursor; + + /* + Getting to the point where this function is called means there should always be memory + available. Out of memory checks should have been done at an earlier stage. + */ + DRWAV_ASSERT((pResult + size) <= (pParser->pData + drwav__metadata_memory_capacity(pParser))); + + pParser->pDataCursor += size; + return pResult; +} + +DRWAV_PRIVATE void drwav__metadata_request_extra_memory_for_stage_2(drwav__metadata_parser* pParser, size_t bytes, size_t align) +{ + size_t extra = bytes + (align ? (align - 1) : 0); + pParser->extraCapacity += extra; +} + +DRWAV_PRIVATE drwav_result drwav__metadata_alloc(drwav__metadata_parser* pParser, drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pParser->extraCapacity != 0 || pParser->metadataCount != 0) { + pAllocationCallbacks->onFree(pParser->pData, pAllocationCallbacks->pUserData); + + pParser->pData = (drwav_uint8*)pAllocationCallbacks->onMalloc(drwav__metadata_memory_capacity(pParser), pAllocationCallbacks->pUserData); + pParser->pDataCursor = pParser->pData; + + if (pParser->pData == NULL) { + return DRWAV_OUT_OF_MEMORY; + } + + /* + We don't need to worry about specifying an alignment here because malloc always returns something + of suitable alignment. This also means pParser->pMetadata is all that we need to store in order + for us to free when we are done. + */ + pParser->pMetadata = (drwav_metadata*)drwav__metadata_get_memory(pParser, sizeof(drwav_metadata) * pParser->metadataCount, 1); + pParser->metadataCursor = 0; + } + + return DRWAV_SUCCESS; +} + +DRWAV_PRIVATE size_t drwav__metadata_parser_read(drwav__metadata_parser* pParser, void* pBufferOut, size_t bytesToRead, drwav_uint64* pCursor) +{ + if (pCursor != NULL) { + return drwav__on_read(pParser->onRead, pParser->pReadSeekUserData, pBufferOut, bytesToRead, pCursor); + } else { + return pParser->onRead(pParser->pReadSeekUserData, pBufferOut, bytesToRead); + } +} + +DRWAV_PRIVATE drwav_uint64 drwav__read_smpl_to_metadata_obj(drwav__metadata_parser* pParser, const drwav_chunk_header* pChunkHeader, drwav_metadata* pMetadata) +{ + drwav_uint8 smplHeaderData[DRWAV_SMPL_BYTES]; + drwav_uint64 totalBytesRead = 0; + size_t bytesJustRead; + + if (pMetadata == NULL) { + return 0; + } + + bytesJustRead = drwav__metadata_parser_read(pParser, smplHeaderData, sizeof(smplHeaderData), &totalBytesRead); + + DRWAV_ASSERT(pParser->stage == drwav__metadata_parser_stage_read); + DRWAV_ASSERT(pChunkHeader != NULL); + + if (pMetadata != NULL && bytesJustRead == sizeof(smplHeaderData)) { + drwav_uint32 iSampleLoop; + drwav_uint32 loopCount; + drwav_uint32 calculatedLoopCount; + + /* + When we calcualted the amount of memory required for the "smpl" chunk we excluded the chunk entirely + if the loop count in the header did not match with the calculated count based on the size of the + chunk. When this happens, the second stage will still hit this path but the `pMetadata` will be + non-null, but will either be pointing at the very end of the allocation or at the start of another + chunk. We need to check the loop counts for consistency *before* dereferencing the pMetadata object + so it's consistent with how we do it in the first stage. + */ + loopCount = drwav_bytes_to_u32(smplHeaderData + 28); + calculatedLoopCount = (drwav_uint32)((pChunkHeader->sizeInBytes - DRWAV_SMPL_BYTES) / DRWAV_SMPL_LOOP_BYTES); + if (loopCount != calculatedLoopCount) { + return totalBytesRead; + } + + pMetadata->type = drwav_metadata_type_smpl; + pMetadata->data.smpl.manufacturerId = drwav_bytes_to_u32(smplHeaderData + 0); + pMetadata->data.smpl.productId = drwav_bytes_to_u32(smplHeaderData + 4); + pMetadata->data.smpl.samplePeriodNanoseconds = drwav_bytes_to_u32(smplHeaderData + 8); + pMetadata->data.smpl.midiUnityNote = drwav_bytes_to_u32(smplHeaderData + 12); + pMetadata->data.smpl.midiPitchFraction = drwav_bytes_to_u32(smplHeaderData + 16); + pMetadata->data.smpl.smpteFormat = drwav_bytes_to_u32(smplHeaderData + 20); + pMetadata->data.smpl.smpteOffset = drwav_bytes_to_u32(smplHeaderData + 24); + pMetadata->data.smpl.sampleLoopCount = drwav_bytes_to_u32(smplHeaderData + 28); + pMetadata->data.smpl.samplerSpecificDataSizeInBytes = drwav_bytes_to_u32(smplHeaderData + 32); + + /* + The loop count needs to be validated against the size of the chunk for safety so we don't + attempt to read over the boundary of the chunk. + */ + if (pMetadata->data.smpl.sampleLoopCount == calculatedLoopCount) { + pMetadata->data.smpl.pLoops = (drwav_smpl_loop*)drwav__metadata_get_memory(pParser, sizeof(drwav_smpl_loop) * pMetadata->data.smpl.sampleLoopCount, DRWAV_METADATA_ALIGNMENT); + + for (iSampleLoop = 0; iSampleLoop < pMetadata->data.smpl.sampleLoopCount; ++iSampleLoop) { + drwav_uint8 smplLoopData[DRWAV_SMPL_LOOP_BYTES]; + bytesJustRead = drwav__metadata_parser_read(pParser, smplLoopData, sizeof(smplLoopData), &totalBytesRead); + + if (bytesJustRead == sizeof(smplLoopData)) { + pMetadata->data.smpl.pLoops[iSampleLoop].cuePointId = drwav_bytes_to_u32(smplLoopData + 0); + pMetadata->data.smpl.pLoops[iSampleLoop].type = drwav_bytes_to_u32(smplLoopData + 4); + pMetadata->data.smpl.pLoops[iSampleLoop].firstSampleOffset = drwav_bytes_to_u32(smplLoopData + 8); + pMetadata->data.smpl.pLoops[iSampleLoop].lastSampleOffset = drwav_bytes_to_u32(smplLoopData + 12); + pMetadata->data.smpl.pLoops[iSampleLoop].sampleFraction = drwav_bytes_to_u32(smplLoopData + 16); + pMetadata->data.smpl.pLoops[iSampleLoop].playCount = drwav_bytes_to_u32(smplLoopData + 20); + } else { + break; + } + } + + if (pMetadata->data.smpl.samplerSpecificDataSizeInBytes > 0) { + pMetadata->data.smpl.pSamplerSpecificData = drwav__metadata_get_memory(pParser, pMetadata->data.smpl.samplerSpecificDataSizeInBytes, 1); + DRWAV_ASSERT(pMetadata->data.smpl.pSamplerSpecificData != NULL); + + drwav__metadata_parser_read(pParser, pMetadata->data.smpl.pSamplerSpecificData, pMetadata->data.smpl.samplerSpecificDataSizeInBytes, &totalBytesRead); + } + } else { + /* + Getting here means the loop count in the header does not match up with the size of the + chunk. Clear out the data to zero just to be safe. + + This should never actually get hit because we check for it above, but keeping this here + for added safety. + */ + DRWAV_ZERO_OBJECT(&pMetadata->data.smpl); + } + } + + return totalBytesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav__read_cue_to_metadata_obj(drwav__metadata_parser* pParser, const drwav_chunk_header* pChunkHeader, drwav_metadata* pMetadata) +{ + drwav_uint8 cueHeaderSectionData[DRWAV_CUE_BYTES]; + drwav_uint64 totalBytesRead = 0; + size_t bytesJustRead; + + if (pMetadata == NULL) { + return 0; + } + + bytesJustRead = drwav__metadata_parser_read(pParser, cueHeaderSectionData, sizeof(cueHeaderSectionData), &totalBytesRead); + + DRWAV_ASSERT(pParser->stage == drwav__metadata_parser_stage_read); + + if (bytesJustRead == sizeof(cueHeaderSectionData)) { + pMetadata->type = drwav_metadata_type_cue; + pMetadata->data.cue.cuePointCount = drwav_bytes_to_u32(cueHeaderSectionData); + + /* + We need to validate the cue point count against the size of the chunk so we don't read + beyond the chunk. + */ + if (pMetadata->data.cue.cuePointCount == (pChunkHeader->sizeInBytes - DRWAV_CUE_BYTES) / DRWAV_CUE_POINT_BYTES) { + pMetadata->data.cue.pCuePoints = (drwav_cue_point*)drwav__metadata_get_memory(pParser, sizeof(drwav_cue_point) * pMetadata->data.cue.cuePointCount, DRWAV_METADATA_ALIGNMENT); + DRWAV_ASSERT(pMetadata->data.cue.pCuePoints != NULL); + + if (pMetadata->data.cue.cuePointCount > 0) { + drwav_uint32 iCuePoint; + + for (iCuePoint = 0; iCuePoint < pMetadata->data.cue.cuePointCount; ++iCuePoint) { + drwav_uint8 cuePointData[DRWAV_CUE_POINT_BYTES]; + bytesJustRead = drwav__metadata_parser_read(pParser, cuePointData, sizeof(cuePointData), &totalBytesRead); + + if (bytesJustRead == sizeof(cuePointData)) { + pMetadata->data.cue.pCuePoints[iCuePoint].id = drwav_bytes_to_u32(cuePointData + 0); + pMetadata->data.cue.pCuePoints[iCuePoint].playOrderPosition = drwav_bytes_to_u32(cuePointData + 4); + pMetadata->data.cue.pCuePoints[iCuePoint].dataChunkId[0] = cuePointData[8]; + pMetadata->data.cue.pCuePoints[iCuePoint].dataChunkId[1] = cuePointData[9]; + pMetadata->data.cue.pCuePoints[iCuePoint].dataChunkId[2] = cuePointData[10]; + pMetadata->data.cue.pCuePoints[iCuePoint].dataChunkId[3] = cuePointData[11]; + pMetadata->data.cue.pCuePoints[iCuePoint].chunkStart = drwav_bytes_to_u32(cuePointData + 12); + pMetadata->data.cue.pCuePoints[iCuePoint].blockStart = drwav_bytes_to_u32(cuePointData + 16); + pMetadata->data.cue.pCuePoints[iCuePoint].sampleOffset = drwav_bytes_to_u32(cuePointData + 20); + } else { + break; + } + } + } + } + } + + return totalBytesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav__read_inst_to_metadata_obj(drwav__metadata_parser* pParser, drwav_metadata* pMetadata) +{ + drwav_uint8 instData[DRWAV_INST_BYTES]; + drwav_uint64 bytesRead; + + if (pMetadata == NULL) { + return 0; + } + + bytesRead = drwav__metadata_parser_read(pParser, instData, sizeof(instData), NULL); + + DRWAV_ASSERT(pParser->stage == drwav__metadata_parser_stage_read); + + if (bytesRead == sizeof(instData)) { + pMetadata->type = drwav_metadata_type_inst; + pMetadata->data.inst.midiUnityNote = (drwav_int8)instData[0]; + pMetadata->data.inst.fineTuneCents = (drwav_int8)instData[1]; + pMetadata->data.inst.gainDecibels = (drwav_int8)instData[2]; + pMetadata->data.inst.lowNote = (drwav_int8)instData[3]; + pMetadata->data.inst.highNote = (drwav_int8)instData[4]; + pMetadata->data.inst.lowVelocity = (drwav_int8)instData[5]; + pMetadata->data.inst.highVelocity = (drwav_int8)instData[6]; + } + + return bytesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav__read_acid_to_metadata_obj(drwav__metadata_parser* pParser, drwav_metadata* pMetadata) +{ + drwav_uint8 acidData[DRWAV_ACID_BYTES]; + drwav_uint64 bytesRead; + + if (pMetadata == NULL) { + return 0; + } + + bytesRead = drwav__metadata_parser_read(pParser, acidData, sizeof(acidData), NULL); + + DRWAV_ASSERT(pParser->stage == drwav__metadata_parser_stage_read); + + if (bytesRead == sizeof(acidData)) { + pMetadata->type = drwav_metadata_type_acid; + pMetadata->data.acid.flags = drwav_bytes_to_u32(acidData + 0); + pMetadata->data.acid.midiUnityNote = drwav_bytes_to_u16(acidData + 4); + pMetadata->data.acid.reserved1 = drwav_bytes_to_u16(acidData + 6); + pMetadata->data.acid.reserved2 = drwav_bytes_to_f32(acidData + 8); + pMetadata->data.acid.numBeats = drwav_bytes_to_u32(acidData + 12); + pMetadata->data.acid.meterDenominator = drwav_bytes_to_u16(acidData + 16); + pMetadata->data.acid.meterNumerator = drwav_bytes_to_u16(acidData + 18); + pMetadata->data.acid.tempo = drwav_bytes_to_f32(acidData + 20); + } + + return bytesRead; +} + +DRWAV_PRIVATE size_t drwav__strlen(const char* str) +{ + size_t result = 0; + + while (*str++) { + result += 1; + } + + return result; +} + +DRWAV_PRIVATE size_t drwav__strlen_clamped(const char* str, size_t maxToRead) +{ + size_t result = 0; + + while (*str++ && result < maxToRead) { + result += 1; + } + + return result; +} + +DRWAV_PRIVATE char* drwav__metadata_copy_string(drwav__metadata_parser* pParser, const char* str, size_t maxToRead) +{ + size_t len = drwav__strlen_clamped(str, maxToRead); + + if (len) { + char* result = (char*)drwav__metadata_get_memory(pParser, len + 1, 1); + DRWAV_ASSERT(result != NULL); + + DRWAV_COPY_MEMORY(result, str, len); + result[len] = '\0'; + + return result; + } else { + return NULL; + } +} + +typedef struct +{ + const void* pBuffer; + size_t sizeInBytes; + size_t cursor; +} drwav_buffer_reader; + +DRWAV_PRIVATE drwav_result drwav_buffer_reader_init(const void* pBuffer, size_t sizeInBytes, drwav_buffer_reader* pReader) +{ + DRWAV_ASSERT(pBuffer != NULL); + DRWAV_ASSERT(pReader != NULL); + + DRWAV_ZERO_OBJECT(pReader); + + pReader->pBuffer = pBuffer; + pReader->sizeInBytes = sizeInBytes; + pReader->cursor = 0; + + return DRWAV_SUCCESS; +} + +DRWAV_PRIVATE const void* drwav_buffer_reader_ptr(const drwav_buffer_reader* pReader) +{ + DRWAV_ASSERT(pReader != NULL); + + return drwav_offset_ptr(pReader->pBuffer, pReader->cursor); +} + +DRWAV_PRIVATE drwav_result drwav_buffer_reader_seek(drwav_buffer_reader* pReader, size_t bytesToSeek) +{ + DRWAV_ASSERT(pReader != NULL); + + if (pReader->cursor + bytesToSeek > pReader->sizeInBytes) { + return DRWAV_BAD_SEEK; /* Seeking too far forward. */ + } + + pReader->cursor += bytesToSeek; + + return DRWAV_SUCCESS; +} + +DRWAV_PRIVATE drwav_result drwav_buffer_reader_read(drwav_buffer_reader* pReader, void* pDst, size_t bytesToRead, size_t* pBytesRead) +{ + drwav_result result = DRWAV_SUCCESS; + size_t bytesRemaining; + + DRWAV_ASSERT(pReader != NULL); + + if (pBytesRead != NULL) { + *pBytesRead = 0; + } + + bytesRemaining = (pReader->sizeInBytes - pReader->cursor); + if (bytesToRead > bytesRemaining) { + bytesToRead = bytesRemaining; + } + + if (pDst == NULL) { + /* Seek. */ + result = drwav_buffer_reader_seek(pReader, bytesToRead); + } else { + /* Read. */ + DRWAV_COPY_MEMORY(pDst, drwav_buffer_reader_ptr(pReader), bytesToRead); + pReader->cursor += bytesToRead; + } + + DRWAV_ASSERT(pReader->cursor <= pReader->sizeInBytes); + + if (result == DRWAV_SUCCESS) { + if (pBytesRead != NULL) { + *pBytesRead = bytesToRead; + } + } + + return DRWAV_SUCCESS; +} + +DRWAV_PRIVATE drwav_result drwav_buffer_reader_read_u16(drwav_buffer_reader* pReader, drwav_uint16* pDst) +{ + drwav_result result; + size_t bytesRead; + drwav_uint8 data[2]; + + DRWAV_ASSERT(pReader != NULL); + DRWAV_ASSERT(pDst != NULL); + + *pDst = 0; /* Safety. */ + + result = drwav_buffer_reader_read(pReader, data, sizeof(*pDst), &bytesRead); + if (result != DRWAV_SUCCESS || bytesRead != sizeof(*pDst)) { + return result; + } + + *pDst = drwav_bytes_to_u16(data); + + return DRWAV_SUCCESS; +} + +DRWAV_PRIVATE drwav_result drwav_buffer_reader_read_u32(drwav_buffer_reader* pReader, drwav_uint32* pDst) +{ + drwav_result result; + size_t bytesRead; + drwav_uint8 data[4]; + + DRWAV_ASSERT(pReader != NULL); + DRWAV_ASSERT(pDst != NULL); + + *pDst = 0; /* Safety. */ + + result = drwav_buffer_reader_read(pReader, data, sizeof(*pDst), &bytesRead); + if (result != DRWAV_SUCCESS || bytesRead != sizeof(*pDst)) { + return result; + } + + *pDst = drwav_bytes_to_u32(data); + + return DRWAV_SUCCESS; +} + + + +DRWAV_PRIVATE drwav_uint64 drwav__read_bext_to_metadata_obj(drwav__metadata_parser* pParser, drwav_metadata* pMetadata, drwav_uint64 chunkSize) +{ + drwav_uint8 bextData[DRWAV_BEXT_BYTES]; + size_t bytesRead = drwav__metadata_parser_read(pParser, bextData, sizeof(bextData), NULL); + + DRWAV_ASSERT(pParser->stage == drwav__metadata_parser_stage_read); + + if (bytesRead == sizeof(bextData)) { + drwav_buffer_reader reader; + drwav_uint32 timeReferenceLow; + drwav_uint32 timeReferenceHigh; + size_t extraBytes; + + pMetadata->type = drwav_metadata_type_bext; + + if (drwav_buffer_reader_init(bextData, bytesRead, &reader) == DRWAV_SUCCESS) { + pMetadata->data.bext.pDescription = drwav__metadata_copy_string(pParser, (const char*)drwav_buffer_reader_ptr(&reader), DRWAV_BEXT_DESCRIPTION_BYTES); + drwav_buffer_reader_seek(&reader, DRWAV_BEXT_DESCRIPTION_BYTES); + + pMetadata->data.bext.pOriginatorName = drwav__metadata_copy_string(pParser, (const char*)drwav_buffer_reader_ptr(&reader), DRWAV_BEXT_ORIGINATOR_NAME_BYTES); + drwav_buffer_reader_seek(&reader, DRWAV_BEXT_ORIGINATOR_NAME_BYTES); + + pMetadata->data.bext.pOriginatorReference = drwav__metadata_copy_string(pParser, (const char*)drwav_buffer_reader_ptr(&reader), DRWAV_BEXT_ORIGINATOR_REF_BYTES); + drwav_buffer_reader_seek(&reader, DRWAV_BEXT_ORIGINATOR_REF_BYTES); + + drwav_buffer_reader_read(&reader, pMetadata->data.bext.pOriginationDate, sizeof(pMetadata->data.bext.pOriginationDate), NULL); + drwav_buffer_reader_read(&reader, pMetadata->data.bext.pOriginationTime, sizeof(pMetadata->data.bext.pOriginationTime), NULL); + + drwav_buffer_reader_read_u32(&reader, &timeReferenceLow); + drwav_buffer_reader_read_u32(&reader, &timeReferenceHigh); + pMetadata->data.bext.timeReference = ((drwav_uint64)timeReferenceHigh << 32) + timeReferenceLow; + + drwav_buffer_reader_read_u16(&reader, &pMetadata->data.bext.version); + + pMetadata->data.bext.pUMID = drwav__metadata_get_memory(pParser, DRWAV_BEXT_UMID_BYTES, 1); + drwav_buffer_reader_read(&reader, pMetadata->data.bext.pUMID, DRWAV_BEXT_UMID_BYTES, NULL); + + drwav_buffer_reader_read_u16(&reader, &pMetadata->data.bext.loudnessValue); + drwav_buffer_reader_read_u16(&reader, &pMetadata->data.bext.loudnessRange); + drwav_buffer_reader_read_u16(&reader, &pMetadata->data.bext.maxTruePeakLevel); + drwav_buffer_reader_read_u16(&reader, &pMetadata->data.bext.maxMomentaryLoudness); + drwav_buffer_reader_read_u16(&reader, &pMetadata->data.bext.maxShortTermLoudness); + + DRWAV_ASSERT((drwav_offset_ptr(drwav_buffer_reader_ptr(&reader), DRWAV_BEXT_RESERVED_BYTES)) == (bextData + DRWAV_BEXT_BYTES)); + + extraBytes = (size_t)(chunkSize - DRWAV_BEXT_BYTES); + if (extraBytes > 0) { + pMetadata->data.bext.pCodingHistory = (char*)drwav__metadata_get_memory(pParser, extraBytes + 1, 1); + DRWAV_ASSERT(pMetadata->data.bext.pCodingHistory != NULL); + + pMetadata->data.bext.codingHistorySize = (drwav_uint32)drwav__metadata_parser_read(pParser, pMetadata->data.bext.pCodingHistory, extraBytes, NULL); + pMetadata->data.bext.pCodingHistory[pMetadata->data.bext.codingHistorySize] = '\0'; /* <-- Explicit null terminator in case of a badly formed file. */ + + bytesRead += pMetadata->data.bext.codingHistorySize; + } else { + pMetadata->data.bext.pCodingHistory = NULL; + pMetadata->data.bext.codingHistorySize = 0; + } + } + } + + return bytesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav__read_list_label_or_note_to_metadata_obj(drwav__metadata_parser* pParser, drwav_metadata* pMetadata, drwav_uint64 chunkSize, drwav_metadata_type type) +{ + drwav_uint8 cueIDBuffer[DRWAV_LIST_LABEL_OR_NOTE_BYTES]; + drwav_uint64 totalBytesRead = 0; + size_t bytesJustRead = drwav__metadata_parser_read(pParser, cueIDBuffer, sizeof(cueIDBuffer), &totalBytesRead); + + DRWAV_ASSERT(pParser->stage == drwav__metadata_parser_stage_read); + + if (bytesJustRead == sizeof(cueIDBuffer)) { + drwav_uint32 sizeIncludingNullTerminator; + + pMetadata->type = type; + pMetadata->data.labelOrNote.cuePointId = drwav_bytes_to_u32(cueIDBuffer); + + sizeIncludingNullTerminator = (drwav_uint32)chunkSize - DRWAV_LIST_LABEL_OR_NOTE_BYTES; + if (sizeIncludingNullTerminator > 0) { + pMetadata->data.labelOrNote.stringLength = sizeIncludingNullTerminator - 1; + pMetadata->data.labelOrNote.pString = (char*)drwav__metadata_get_memory(pParser, sizeIncludingNullTerminator, 1); + DRWAV_ASSERT(pMetadata->data.labelOrNote.pString != NULL); + + drwav__metadata_parser_read(pParser, pMetadata->data.labelOrNote.pString, sizeIncludingNullTerminator, &totalBytesRead); + } else { + pMetadata->data.labelOrNote.stringLength = 0; + pMetadata->data.labelOrNote.pString = NULL; + } + } + + return totalBytesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav__read_list_labelled_cue_region_to_metadata_obj(drwav__metadata_parser* pParser, drwav_metadata* pMetadata, drwav_uint64 chunkSize) +{ + drwav_uint8 buffer[DRWAV_LIST_LABELLED_TEXT_BYTES]; + drwav_uint64 totalBytesRead = 0; + size_t bytesJustRead = drwav__metadata_parser_read(pParser, buffer, sizeof(buffer), &totalBytesRead); + + DRWAV_ASSERT(pParser->stage == drwav__metadata_parser_stage_read); + + if (bytesJustRead == sizeof(buffer)) { + drwav_uint32 sizeIncludingNullTerminator; + + pMetadata->type = drwav_metadata_type_list_labelled_cue_region; + pMetadata->data.labelledCueRegion.cuePointId = drwav_bytes_to_u32(buffer + 0); + pMetadata->data.labelledCueRegion.sampleLength = drwav_bytes_to_u32(buffer + 4); + pMetadata->data.labelledCueRegion.purposeId[0] = buffer[8]; + pMetadata->data.labelledCueRegion.purposeId[1] = buffer[9]; + pMetadata->data.labelledCueRegion.purposeId[2] = buffer[10]; + pMetadata->data.labelledCueRegion.purposeId[3] = buffer[11]; + pMetadata->data.labelledCueRegion.country = drwav_bytes_to_u16(buffer + 12); + pMetadata->data.labelledCueRegion.language = drwav_bytes_to_u16(buffer + 14); + pMetadata->data.labelledCueRegion.dialect = drwav_bytes_to_u16(buffer + 16); + pMetadata->data.labelledCueRegion.codePage = drwav_bytes_to_u16(buffer + 18); + + sizeIncludingNullTerminator = (drwav_uint32)chunkSize - DRWAV_LIST_LABELLED_TEXT_BYTES; + if (sizeIncludingNullTerminator > 0) { + pMetadata->data.labelledCueRegion.stringLength = sizeIncludingNullTerminator - 1; + pMetadata->data.labelledCueRegion.pString = (char*)drwav__metadata_get_memory(pParser, sizeIncludingNullTerminator, 1); + DRWAV_ASSERT(pMetadata->data.labelledCueRegion.pString != NULL); + + drwav__metadata_parser_read(pParser, pMetadata->data.labelledCueRegion.pString, sizeIncludingNullTerminator, &totalBytesRead); + } else { + pMetadata->data.labelledCueRegion.stringLength = 0; + pMetadata->data.labelledCueRegion.pString = NULL; + } + } + + return totalBytesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav__metadata_process_info_text_chunk(drwav__metadata_parser* pParser, drwav_uint64 chunkSize, drwav_metadata_type type) +{ + drwav_uint64 bytesRead = 0; + drwav_uint32 stringSizeWithNullTerminator = (drwav_uint32)chunkSize; + + if (pParser->stage == drwav__metadata_parser_stage_count) { + pParser->metadataCount += 1; + drwav__metadata_request_extra_memory_for_stage_2(pParser, stringSizeWithNullTerminator, 1); + } else { + drwav_metadata* pMetadata = &pParser->pMetadata[pParser->metadataCursor]; + pMetadata->type = type; + if (stringSizeWithNullTerminator > 0) { + pMetadata->data.infoText.stringLength = stringSizeWithNullTerminator - 1; + pMetadata->data.infoText.pString = (char*)drwav__metadata_get_memory(pParser, stringSizeWithNullTerminator, 1); + DRWAV_ASSERT(pMetadata->data.infoText.pString != NULL); + + bytesRead = drwav__metadata_parser_read(pParser, pMetadata->data.infoText.pString, (size_t)stringSizeWithNullTerminator, NULL); + if (bytesRead == chunkSize) { + pParser->metadataCursor += 1; + } else { + /* Failed to parse. */ + } + } else { + pMetadata->data.infoText.stringLength = 0; + pMetadata->data.infoText.pString = NULL; + pParser->metadataCursor += 1; + } + } + + return bytesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav__metadata_process_unknown_chunk(drwav__metadata_parser* pParser, const drwav_uint8* pChunkId, drwav_uint64 chunkSize, drwav_metadata_location location) +{ + drwav_uint64 bytesRead = 0; + + if (location == drwav_metadata_location_invalid) { + return 0; + } + + if (drwav_fourcc_equal(pChunkId, "data") || drwav_fourcc_equal(pChunkId, "fmt ") || drwav_fourcc_equal(pChunkId, "fact")) { + return 0; + } + + if (pParser->stage == drwav__metadata_parser_stage_count) { + pParser->metadataCount += 1; + drwav__metadata_request_extra_memory_for_stage_2(pParser, (size_t)chunkSize, 1); + } else { + drwav_metadata* pMetadata = &pParser->pMetadata[pParser->metadataCursor]; + pMetadata->type = drwav_metadata_type_unknown; + pMetadata->data.unknown.chunkLocation = location; + pMetadata->data.unknown.id[0] = pChunkId[0]; + pMetadata->data.unknown.id[1] = pChunkId[1]; + pMetadata->data.unknown.id[2] = pChunkId[2]; + pMetadata->data.unknown.id[3] = pChunkId[3]; + pMetadata->data.unknown.dataSizeInBytes = (drwav_uint32)chunkSize; + pMetadata->data.unknown.pData = (drwav_uint8 *)drwav__metadata_get_memory(pParser, (size_t)chunkSize, 1); + DRWAV_ASSERT(pMetadata->data.unknown.pData != NULL); + + bytesRead = drwav__metadata_parser_read(pParser, pMetadata->data.unknown.pData, pMetadata->data.unknown.dataSizeInBytes, NULL); + if (bytesRead == pMetadata->data.unknown.dataSizeInBytes) { + pParser->metadataCursor += 1; + } else { + /* Failed to read. */ + } + } + + return bytesRead; +} + +DRWAV_PRIVATE drwav_bool32 drwav__chunk_matches(drwav_metadata_type allowedMetadataTypes, const drwav_uint8* pChunkID, drwav_metadata_type type, const char* pID) +{ + return (allowedMetadataTypes & type) && drwav_fourcc_equal(pChunkID, pID); +} + +DRWAV_PRIVATE drwav_uint64 drwav__metadata_process_chunk(drwav__metadata_parser* pParser, const drwav_chunk_header* pChunkHeader, drwav_metadata_type allowedMetadataTypes) +{ + const drwav_uint8 *pChunkID = pChunkHeader->id.fourcc; + drwav_uint64 bytesRead = 0; + + if (drwav__chunk_matches(allowedMetadataTypes, pChunkID, drwav_metadata_type_smpl, "smpl")) { + if (pChunkHeader->sizeInBytes >= DRWAV_SMPL_BYTES) { + if (pParser->stage == drwav__metadata_parser_stage_count) { + drwav_uint8 buffer[4]; + size_t bytesJustRead; + + if (!pParser->onSeek(pParser->pReadSeekUserData, 28, DRWAV_SEEK_CUR)) { + return bytesRead; + } + bytesRead += 28; + + bytesJustRead = drwav__metadata_parser_read(pParser, buffer, sizeof(buffer), &bytesRead); + if (bytesJustRead == sizeof(buffer)) { + drwav_uint32 loopCount = drwav_bytes_to_u32(buffer); + drwav_uint32 calculatedLoopCount; + + /* The loop count must be validated against the size of the chunk. */ + calculatedLoopCount = (drwav_uint32)((pChunkHeader->sizeInBytes - DRWAV_SMPL_BYTES) / DRWAV_SMPL_LOOP_BYTES); + if (calculatedLoopCount == loopCount) { + bytesJustRead = drwav__metadata_parser_read(pParser, buffer, sizeof(buffer), &bytesRead); + if (bytesJustRead == sizeof(buffer)) { + drwav_uint32 samplerSpecificDataSizeInBytes = drwav_bytes_to_u32(buffer); + + pParser->metadataCount += 1; + drwav__metadata_request_extra_memory_for_stage_2(pParser, sizeof(drwav_smpl_loop) * loopCount, DRWAV_METADATA_ALIGNMENT); + drwav__metadata_request_extra_memory_for_stage_2(pParser, samplerSpecificDataSizeInBytes, 1); + } + } else { + /* Loop count in header does not match the size of the chunk. */ + } + } + } else { + bytesRead = drwav__read_smpl_to_metadata_obj(pParser, pChunkHeader, &pParser->pMetadata[pParser->metadataCursor]); + if (bytesRead == pChunkHeader->sizeInBytes) { + pParser->metadataCursor += 1; + } else { + /* Failed to parse. */ + } + } + } else { + /* Incorrectly formed chunk. */ + } + } else if (drwav__chunk_matches(allowedMetadataTypes, pChunkID, drwav_metadata_type_inst, "inst")) { + if (pChunkHeader->sizeInBytes == DRWAV_INST_BYTES) { + if (pParser->stage == drwav__metadata_parser_stage_count) { + pParser->metadataCount += 1; + } else { + bytesRead = drwav__read_inst_to_metadata_obj(pParser, &pParser->pMetadata[pParser->metadataCursor]); + if (bytesRead == pChunkHeader->sizeInBytes) { + pParser->metadataCursor += 1; + } else { + /* Failed to parse. */ + } + } + } else { + /* Incorrectly formed chunk. */ + } + } else if (drwav__chunk_matches(allowedMetadataTypes, pChunkID, drwav_metadata_type_acid, "acid")) { + if (pChunkHeader->sizeInBytes == DRWAV_ACID_BYTES) { + if (pParser->stage == drwav__metadata_parser_stage_count) { + pParser->metadataCount += 1; + } else { + bytesRead = drwav__read_acid_to_metadata_obj(pParser, &pParser->pMetadata[pParser->metadataCursor]); + if (bytesRead == pChunkHeader->sizeInBytes) { + pParser->metadataCursor += 1; + } else { + /* Failed to parse. */ + } + } + } else { + /* Incorrectly formed chunk. */ + } + } else if (drwav__chunk_matches(allowedMetadataTypes, pChunkID, drwav_metadata_type_cue, "cue ")) { + if (pChunkHeader->sizeInBytes >= DRWAV_CUE_BYTES) { + if (pParser->stage == drwav__metadata_parser_stage_count) { + size_t cueCount; + + pParser->metadataCount += 1; + cueCount = (size_t)(pChunkHeader->sizeInBytes - DRWAV_CUE_BYTES) / DRWAV_CUE_POINT_BYTES; + drwav__metadata_request_extra_memory_for_stage_2(pParser, sizeof(drwav_cue_point) * cueCount, DRWAV_METADATA_ALIGNMENT); + } else { + bytesRead = drwav__read_cue_to_metadata_obj(pParser, pChunkHeader, &pParser->pMetadata[pParser->metadataCursor]); + if (bytesRead == pChunkHeader->sizeInBytes) { + pParser->metadataCursor += 1; + } else { + /* Failed to parse. */ + } + } + } else { + /* Incorrectly formed chunk. */ + } + } else if (drwav__chunk_matches(allowedMetadataTypes, pChunkID, drwav_metadata_type_bext, "bext")) { + if (pChunkHeader->sizeInBytes >= DRWAV_BEXT_BYTES) { + if (pParser->stage == drwav__metadata_parser_stage_count) { + /* The description field is the largest one in a bext chunk, so that is the max size of this temporary buffer. */ + char buffer[DRWAV_BEXT_DESCRIPTION_BYTES + 1]; + size_t allocSizeNeeded = DRWAV_BEXT_UMID_BYTES; /* We know we will need SMPTE umid size. */ + size_t bytesJustRead; + + buffer[DRWAV_BEXT_DESCRIPTION_BYTES] = '\0'; + bytesJustRead = drwav__metadata_parser_read(pParser, buffer, DRWAV_BEXT_DESCRIPTION_BYTES, &bytesRead); + if (bytesJustRead != DRWAV_BEXT_DESCRIPTION_BYTES) { + return bytesRead; + } + allocSizeNeeded += drwav__strlen(buffer) + 1; + + buffer[DRWAV_BEXT_ORIGINATOR_NAME_BYTES] = '\0'; + bytesJustRead = drwav__metadata_parser_read(pParser, buffer, DRWAV_BEXT_ORIGINATOR_NAME_BYTES, &bytesRead); + if (bytesJustRead != DRWAV_BEXT_ORIGINATOR_NAME_BYTES) { + return bytesRead; + } + allocSizeNeeded += drwav__strlen(buffer) + 1; + + buffer[DRWAV_BEXT_ORIGINATOR_REF_BYTES] = '\0'; + bytesJustRead = drwav__metadata_parser_read(pParser, buffer, DRWAV_BEXT_ORIGINATOR_REF_BYTES, &bytesRead); + if (bytesJustRead != DRWAV_BEXT_ORIGINATOR_REF_BYTES) { + return bytesRead; + } + allocSizeNeeded += drwav__strlen(buffer) + 1; + + /* Coding history. */ + allocSizeNeeded += (size_t)pChunkHeader->sizeInBytes - DRWAV_BEXT_BYTES + 1; + + drwav__metadata_request_extra_memory_for_stage_2(pParser, allocSizeNeeded, 1); + + pParser->metadataCount += 1; + } else { + bytesRead = drwav__read_bext_to_metadata_obj(pParser, &pParser->pMetadata[pParser->metadataCursor], pChunkHeader->sizeInBytes); + if (bytesRead == pChunkHeader->sizeInBytes) { + pParser->metadataCursor += 1; + } else { + /* Failed to parse. */ + } + } + } else { + /* Incorrectly formed chunk. */ + } + } else if (drwav_fourcc_equal(pChunkID, "LIST") || drwav_fourcc_equal(pChunkID, "list")) { + drwav_metadata_location listType = drwav_metadata_location_invalid; + while (bytesRead < pChunkHeader->sizeInBytes) { + drwav_uint8 subchunkId[4]; + drwav_uint8 subchunkSizeBuffer[4]; + drwav_uint64 subchunkDataSize; + drwav_uint64 subchunkBytesRead = 0; + drwav_uint64 bytesJustRead = drwav__metadata_parser_read(pParser, subchunkId, sizeof(subchunkId), &bytesRead); + if (bytesJustRead != sizeof(subchunkId)) { + break; + } + + /* + The first thing in a list chunk should be "adtl" or "INFO". + + - adtl means this list is a Associated Data List Chunk and will contain labels, notes + or labelled cue regions. + - INFO means this list is an Info List Chunk containing info text chunks such as IPRD + which would specifies the album of this wav file. + + No data follows the adtl or INFO id so we just make note of what type this list is and + continue. + */ + if (drwav_fourcc_equal(subchunkId, "adtl")) { + listType = drwav_metadata_location_inside_adtl_list; + continue; + } else if (drwav_fourcc_equal(subchunkId, "INFO")) { + listType = drwav_metadata_location_inside_info_list; + continue; + } + + bytesJustRead = drwav__metadata_parser_read(pParser, subchunkSizeBuffer, sizeof(subchunkSizeBuffer), &bytesRead); + if (bytesJustRead != sizeof(subchunkSizeBuffer)) { + break; + } + subchunkDataSize = drwav_bytes_to_u32(subchunkSizeBuffer); + + if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_label, "labl") || drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_note, "note")) { + if (subchunkDataSize >= DRWAV_LIST_LABEL_OR_NOTE_BYTES) { + drwav_uint64 stringSizeWithNullTerm = subchunkDataSize - DRWAV_LIST_LABEL_OR_NOTE_BYTES; + if (pParser->stage == drwav__metadata_parser_stage_count) { + pParser->metadataCount += 1; + drwav__metadata_request_extra_memory_for_stage_2(pParser, (size_t)stringSizeWithNullTerm, 1); + } else { + subchunkBytesRead = drwav__read_list_label_or_note_to_metadata_obj(pParser, &pParser->pMetadata[pParser->metadataCursor], subchunkDataSize, drwav_fourcc_equal(subchunkId, "labl") ? drwav_metadata_type_list_label : drwav_metadata_type_list_note); + if (subchunkBytesRead == subchunkDataSize) { + pParser->metadataCursor += 1; + } else { + /* Failed to parse. */ + } + } + } else { + /* Incorrectly formed chunk. */ + } + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_labelled_cue_region, "ltxt")) { + if (subchunkDataSize >= DRWAV_LIST_LABELLED_TEXT_BYTES) { + drwav_uint64 stringSizeWithNullTerminator = subchunkDataSize - DRWAV_LIST_LABELLED_TEXT_BYTES; + if (pParser->stage == drwav__metadata_parser_stage_count) { + pParser->metadataCount += 1; + drwav__metadata_request_extra_memory_for_stage_2(pParser, (size_t)stringSizeWithNullTerminator, 1); + } else { + subchunkBytesRead = drwav__read_list_labelled_cue_region_to_metadata_obj(pParser, &pParser->pMetadata[pParser->metadataCursor], subchunkDataSize); + if (subchunkBytesRead == subchunkDataSize) { + pParser->metadataCursor += 1; + } else { + /* Failed to parse. */ + } + } + } else { + /* Incorrectly formed chunk. */ + } + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_software, "ISFT")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_software); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_copyright, "ICOP")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_copyright); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_title, "INAM")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_title); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_artist, "IART")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_artist); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_comment, "ICMT")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_comment); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_date, "ICRD")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_date); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_genre, "IGNR")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_genre); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_album, "IPRD")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_album); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_tracknumber, "ITRK")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_tracknumber); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_location, "IARL")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_location); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_organization, "ICMS")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_organization); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_keywords, "IKEY")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_keywords); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_medium, "IMED")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_medium); + } else if (drwav__chunk_matches(allowedMetadataTypes, subchunkId, drwav_metadata_type_list_info_description, "ISBJ")) { + subchunkBytesRead = drwav__metadata_process_info_text_chunk(pParser, subchunkDataSize, drwav_metadata_type_list_info_description); + } else if ((allowedMetadataTypes & drwav_metadata_type_unknown) != 0) { + subchunkBytesRead = drwav__metadata_process_unknown_chunk(pParser, subchunkId, subchunkDataSize, listType); + } + + bytesRead += subchunkBytesRead; + DRWAV_ASSERT(subchunkBytesRead <= subchunkDataSize); + + if (subchunkBytesRead < subchunkDataSize) { + drwav_uint64 bytesToSeek = subchunkDataSize - subchunkBytesRead; + + if (!pParser->onSeek(pParser->pReadSeekUserData, (int)bytesToSeek, DRWAV_SEEK_CUR)) { + break; + } + bytesRead += bytesToSeek; + } + + if ((subchunkDataSize % 2) == 1) { + if (!pParser->onSeek(pParser->pReadSeekUserData, 1, DRWAV_SEEK_CUR)) { + break; + } + bytesRead += 1; + } + } + } else if ((allowedMetadataTypes & drwav_metadata_type_unknown) != 0) { + bytesRead = drwav__metadata_process_unknown_chunk(pParser, pChunkID, pChunkHeader->sizeInBytes, drwav_metadata_location_top_level); + } + + return bytesRead; +} + + +DRWAV_PRIVATE drwav_uint32 drwav_get_bytes_per_pcm_frame(drwav* pWav) +{ + drwav_uint32 bytesPerFrame; + + /* + The bytes per frame is a bit ambiguous. It can be either be based on the bits per sample, or the block align. The way I'm doing it here + is that if the bits per sample is a multiple of 8, use floor(bitsPerSample*channels/8), otherwise fall back to the block align. + */ + if ((pWav->bitsPerSample & 0x7) == 0) { + /* Bits per sample is a multiple of 8. */ + bytesPerFrame = (pWav->bitsPerSample * pWav->fmt.channels) >> 3; + } else { + bytesPerFrame = pWav->fmt.blockAlign; + } + + /* Validation for known formats. a-law and mu-law should be 1 byte per channel. If it's not, it's not decodable. */ + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ALAW || pWav->translatedFormatTag == DR_WAVE_FORMAT_MULAW) { + if (bytesPerFrame != pWav->fmt.channels) { + return 0; /* Invalid file. */ + } + } + + return bytesPerFrame; +} + +DRWAV_API drwav_uint16 drwav_fmt_get_format(const drwav_fmt* pFMT) +{ + if (pFMT == NULL) { + return 0; + } + + if (pFMT->formatTag != DR_WAVE_FORMAT_EXTENSIBLE) { + return pFMT->formatTag; + } else { + return drwav_bytes_to_u16(pFMT->subFormat); /* Only the first two bytes are required. */ + } +} + +DRWAV_PRIVATE drwav_bool32 drwav_preinit(drwav* pWav, drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pReadSeekTellUserData, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pWav == NULL || onRead == NULL || onSeek == NULL) { /* <-- onTell is optional. */ + return DRWAV_FALSE; + } + + DRWAV_ZERO_MEMORY(pWav, sizeof(*pWav)); + pWav->onRead = onRead; + pWav->onSeek = onSeek; + pWav->onTell = onTell; + pWav->pUserData = pReadSeekTellUserData; + pWav->allocationCallbacks = drwav_copy_allocation_callbacks_or_defaults(pAllocationCallbacks); + + if (pWav->allocationCallbacks.onFree == NULL || (pWav->allocationCallbacks.onMalloc == NULL && pWav->allocationCallbacks.onRealloc == NULL)) { + return DRWAV_FALSE; /* Invalid allocation callbacks. */ + } + + return DRWAV_TRUE; +} + +DRWAV_PRIVATE drwav_bool32 drwav_init__internal(drwav* pWav, drwav_chunk_proc onChunk, void* pChunkUserData, drwav_uint32 flags) +{ + /* This function assumes drwav_preinit() has been called beforehand. */ + drwav_result result; + drwav_uint64 cursor; /* <-- Keeps track of the byte position so we can seek to specific locations. */ + drwav_bool32 sequential; + drwav_uint8 riff[4]; + drwav_fmt fmt; + unsigned short translatedFormatTag; + drwav_uint64 dataChunkSize = 0; /* <-- Important! Don't explicitly set this to 0 anywhere else. Calculation of the size of the data chunk is performed in different paths depending on the container. */ + drwav_uint64 sampleCountFromFactChunk = 0; /* Same as dataChunkSize - make sure this is the only place this is initialized to 0. */ + drwav_uint64 metadataStartPos; + drwav__metadata_parser metadataParser; + drwav_bool8 isProcessingMetadata = DRWAV_FALSE; + drwav_bool8 foundChunk_fmt = DRWAV_FALSE; + drwav_bool8 foundChunk_data = DRWAV_FALSE; + drwav_bool8 isAIFCFormType = DRWAV_FALSE; /* Only used with AIFF. */ + drwav_uint64 aiffFrameCount = 0; + + cursor = 0; + sequential = (flags & DRWAV_SEQUENTIAL) != 0; + DRWAV_ZERO_OBJECT(&fmt); + + /* The first 4 bytes should be the RIFF identifier. */ + if (drwav__on_read(pWav->onRead, pWav->pUserData, riff, sizeof(riff), &cursor) != sizeof(riff)) { + return DRWAV_FALSE; + } + + /* + The first 4 bytes can be used to identify the container. For RIFF files it will start with "RIFF" and for + w64 it will start with "riff". + */ + if (drwav_fourcc_equal(riff, "RIFF")) { + pWav->container = drwav_container_riff; + } else if (drwav_fourcc_equal(riff, "RIFX")) { + pWav->container = drwav_container_rifx; + } else if (drwav_fourcc_equal(riff, "riff")) { + int i; + drwav_uint8 riff2[12]; + + pWav->container = drwav_container_w64; + + /* Check the rest of the GUID for validity. */ + if (drwav__on_read(pWav->onRead, pWav->pUserData, riff2, sizeof(riff2), &cursor) != sizeof(riff2)) { + return DRWAV_FALSE; + } + + for (i = 0; i < 12; ++i) { + if (riff2[i] != drwavGUID_W64_RIFF[i+4]) { + return DRWAV_FALSE; + } + } + } else if (drwav_fourcc_equal(riff, "RF64")) { + pWav->container = drwav_container_rf64; + } else if (drwav_fourcc_equal(riff, "FORM")) { + pWav->container = drwav_container_aiff; + } else { + return DRWAV_FALSE; /* Unknown or unsupported container. */ + } + + + if (pWav->container == drwav_container_riff || pWav->container == drwav_container_rifx || pWav->container == drwav_container_rf64) { + drwav_uint8 chunkSizeBytes[4]; + drwav_uint8 wave[4]; + + if (drwav__on_read(pWav->onRead, pWav->pUserData, chunkSizeBytes, sizeof(chunkSizeBytes), &cursor) != sizeof(chunkSizeBytes)) { + return DRWAV_FALSE; + } + + if (pWav->container == drwav_container_riff || pWav->container == drwav_container_rifx) { + if (drwav_bytes_to_u32_ex(chunkSizeBytes, pWav->container) < 36) { + /* + I've had a report of a WAV file failing to load when the size of the WAVE chunk is not encoded + and is instead just set to 0. I'm going to relax the validation here to allow these files to + load. Considering the chunk size isn't actually used this should be safe. With this change my + test suite still passes. + */ + /*return DRWAV_FALSE;*/ /* Chunk size should always be at least 36 bytes. */ + } + } else if (pWav->container == drwav_container_rf64) { + if (drwav_bytes_to_u32_le(chunkSizeBytes) != 0xFFFFFFFF) { + return DRWAV_FALSE; /* Chunk size should always be set to -1/0xFFFFFFFF for RF64. The actual size is retrieved later. */ + } + } else { + return DRWAV_FALSE; /* Should never hit this. */ + } + + if (drwav__on_read(pWav->onRead, pWav->pUserData, wave, sizeof(wave), &cursor) != sizeof(wave)) { + return DRWAV_FALSE; + } + + if (!drwav_fourcc_equal(wave, "WAVE")) { + return DRWAV_FALSE; /* Expecting "WAVE". */ + } + } else if (pWav->container == drwav_container_w64) { + drwav_uint8 chunkSizeBytes[8]; + drwav_uint8 wave[16]; + + if (drwav__on_read(pWav->onRead, pWav->pUserData, chunkSizeBytes, sizeof(chunkSizeBytes), &cursor) != sizeof(chunkSizeBytes)) { + return DRWAV_FALSE; + } + + if (drwav_bytes_to_u64(chunkSizeBytes) < 80) { + return DRWAV_FALSE; + } + + if (drwav__on_read(pWav->onRead, pWav->pUserData, wave, sizeof(wave), &cursor) != sizeof(wave)) { + return DRWAV_FALSE; + } + + if (!drwav_guid_equal(wave, drwavGUID_W64_WAVE)) { + return DRWAV_FALSE; + } + } else if (pWav->container == drwav_container_aiff) { + drwav_uint8 chunkSizeBytes[4]; + drwav_uint8 aiff[4]; + + if (drwav__on_read(pWav->onRead, pWav->pUserData, chunkSizeBytes, sizeof(chunkSizeBytes), &cursor) != sizeof(chunkSizeBytes)) { + return DRWAV_FALSE; + } + + if (drwav_bytes_to_u32_be(chunkSizeBytes) < 18) { + return DRWAV_FALSE; + } + + if (drwav__on_read(pWav->onRead, pWav->pUserData, aiff, sizeof(aiff), &cursor) != sizeof(aiff)) { + return DRWAV_FALSE; + } + + if (drwav_fourcc_equal(aiff, "AIFF")) { + isAIFCFormType = DRWAV_FALSE; + } else if (drwav_fourcc_equal(aiff, "AIFC")) { + isAIFCFormType = DRWAV_TRUE; + } else { + return DRWAV_FALSE; /* Expecting "AIFF" or "AIFC". */ + } + } else { + return DRWAV_FALSE; + } + + + /* For RF64, the "ds64" chunk must come next, before the "fmt " chunk. */ + if (pWav->container == drwav_container_rf64) { + drwav_uint8 sizeBytes[8]; + drwav_uint64 bytesRemainingInChunk; + drwav_chunk_header header; + result = drwav__read_chunk_header(pWav->onRead, pWav->pUserData, pWav->container, &cursor, &header); + if (result != DRWAV_SUCCESS) { + return DRWAV_FALSE; + } + + if (!drwav_fourcc_equal(header.id.fourcc, "ds64")) { + return DRWAV_FALSE; /* Expecting "ds64". */ + } + + bytesRemainingInChunk = header.sizeInBytes + header.paddingSize; + + /* We don't care about the size of the RIFF chunk - skip it. */ + if (!drwav__seek_forward(pWav->onSeek, 8, pWav->pUserData)) { + return DRWAV_FALSE; + } + bytesRemainingInChunk -= 8; + cursor += 8; + + + /* Next 8 bytes is the size of the "data" chunk. */ + if (drwav__on_read(pWav->onRead, pWav->pUserData, sizeBytes, sizeof(sizeBytes), &cursor) != sizeof(sizeBytes)) { + return DRWAV_FALSE; + } + bytesRemainingInChunk -= 8; + dataChunkSize = drwav_bytes_to_u64(sizeBytes); + + + /* Next 8 bytes is the same count which we would usually derived from the FACT chunk if it was available. */ + if (drwav__on_read(pWav->onRead, pWav->pUserData, sizeBytes, sizeof(sizeBytes), &cursor) != sizeof(sizeBytes)) { + return DRWAV_FALSE; + } + bytesRemainingInChunk -= 8; + sampleCountFromFactChunk = drwav_bytes_to_u64(sizeBytes); + + + /* Skip over everything else. */ + if (!drwav__seek_forward(pWav->onSeek, bytesRemainingInChunk, pWav->pUserData)) { + return DRWAV_FALSE; + } + cursor += bytesRemainingInChunk; + } + + + metadataStartPos = cursor; + + /* + Whether or not we are processing metadata controls how we load. We can load more efficiently when + metadata is not being processed, but we also cannot process metadata for Wave64 because I have not + been able to test it. If someone is able to test this and provide a patch I'm happy to enable it. + + Seqential mode cannot support metadata because it involves seeking backwards. + */ + isProcessingMetadata = !sequential && ((flags & DRWAV_WITH_METADATA) != 0); + + /* Don't allow processing of metadata with untested containers. */ + if (pWav->container != drwav_container_riff && pWav->container != drwav_container_rf64) { + isProcessingMetadata = DRWAV_FALSE; + } + + DRWAV_ZERO_MEMORY(&metadataParser, sizeof(metadataParser)); + if (isProcessingMetadata) { + metadataParser.onRead = pWav->onRead; + metadataParser.onSeek = pWav->onSeek; + metadataParser.pReadSeekUserData = pWav->pUserData; + metadataParser.stage = drwav__metadata_parser_stage_count; + } + + + /* + From here on out, chunks might be in any order. In order to robustly handle metadata we'll need + to loop through every chunk and handle them as we find them. In sequential mode we need to get + out of the loop as soon as we find the data chunk because we won't be able to seek back. + */ + for (;;) { /* For each chunk... */ + drwav_chunk_header header; + drwav_uint64 chunkSize; + + result = drwav__read_chunk_header(pWav->onRead, pWav->pUserData, pWav->container, &cursor, &header); + if (result != DRWAV_SUCCESS) { + break; + } + + chunkSize = header.sizeInBytes; + + + /* + Always tell the caller about this chunk. We cannot do this in sequential mode because the + callback is allowed to read from the file, in which case we'll need to rewind. + */ + if (!sequential && onChunk != NULL) { + drwav_uint64 callbackBytesRead = onChunk(pChunkUserData, pWav->onRead, pWav->onSeek, pWav->pUserData, &header, pWav->container, &fmt); + + /* + dr_wav may need to read the contents of the chunk, so we now need to seek back to the position before + we called the callback. + */ + if (callbackBytesRead > 0) { + if (drwav__seek_from_start(pWav->onSeek, cursor, pWav->pUserData) == DRWAV_FALSE) { + return DRWAV_FALSE; + } + } + } + + + /* Explicitly handle known chunks first. */ + + /* "fmt " */ + if (((pWav->container == drwav_container_riff || pWav->container == drwav_container_rifx || pWav->container == drwav_container_rf64) && drwav_fourcc_equal(header.id.fourcc, "fmt ")) || + ((pWav->container == drwav_container_w64) && drwav_guid_equal(header.id.guid, drwavGUID_W64_FMT))) { + drwav_uint8 fmtData[16]; + + if (header.sizeInBytes < sizeof(fmtData)) { + return DRWAV_FALSE; /* Invalid fmt chunk. */ + } + + foundChunk_fmt = DRWAV_TRUE; + + if (pWav->onRead(pWav->pUserData, fmtData, sizeof(fmtData)) != sizeof(fmtData)) { + return DRWAV_FALSE; + } + cursor += sizeof(fmtData); + + fmt.formatTag = drwav_bytes_to_u16_ex(fmtData + 0, pWav->container); + fmt.channels = drwav_bytes_to_u16_ex(fmtData + 2, pWav->container); + fmt.sampleRate = drwav_bytes_to_u32_ex(fmtData + 4, pWav->container); + fmt.avgBytesPerSec = drwav_bytes_to_u32_ex(fmtData + 8, pWav->container); + fmt.blockAlign = drwav_bytes_to_u16_ex(fmtData + 12, pWav->container); + fmt.bitsPerSample = drwav_bytes_to_u16_ex(fmtData + 14, pWav->container); + + fmt.extendedSize = 0; + fmt.validBitsPerSample = 0; + fmt.channelMask = 0; + DRWAV_ZERO_MEMORY(fmt.subFormat, sizeof(fmt.subFormat)); + + if (header.sizeInBytes > 16) { + drwav_uint8 fmt_cbSize[2]; + int bytesReadSoFar = 0; + + if (pWav->onRead(pWav->pUserData, fmt_cbSize, sizeof(fmt_cbSize)) != sizeof(fmt_cbSize)) { + return DRWAV_FALSE; /* Expecting more data. */ + } + cursor += sizeof(fmt_cbSize); + + bytesReadSoFar = 18; + + fmt.extendedSize = drwav_bytes_to_u16_ex(fmt_cbSize, pWav->container); + if (fmt.extendedSize > 0) { + /* Simple validation. */ + if (fmt.formatTag == DR_WAVE_FORMAT_EXTENSIBLE) { + if (fmt.extendedSize != 22) { + return DRWAV_FALSE; + } + } + + if (fmt.formatTag == DR_WAVE_FORMAT_EXTENSIBLE) { + drwav_uint8 fmtext[22]; + + if (pWav->onRead(pWav->pUserData, fmtext, fmt.extendedSize) != fmt.extendedSize) { + return DRWAV_FALSE; /* Expecting more data. */ + } + + fmt.validBitsPerSample = drwav_bytes_to_u16_ex(fmtext + 0, pWav->container); + fmt.channelMask = drwav_bytes_to_u32_ex(fmtext + 2, pWav->container); + drwav_bytes_to_guid(fmtext + 6, fmt.subFormat); + } else { + if (pWav->onSeek(pWav->pUserData, fmt.extendedSize, DRWAV_SEEK_CUR) == DRWAV_FALSE) { + return DRWAV_FALSE; + } + } + cursor += fmt.extendedSize; + + bytesReadSoFar += fmt.extendedSize; + } + + /* Seek past any leftover bytes. For w64 the leftover will be defined based on the chunk size. */ + if (pWav->onSeek(pWav->pUserData, (int)(header.sizeInBytes - bytesReadSoFar), DRWAV_SEEK_CUR) == DRWAV_FALSE) { + return DRWAV_FALSE; + } + cursor += (header.sizeInBytes - bytesReadSoFar); + } + + if (header.paddingSize > 0) { + if (drwav__seek_forward(pWav->onSeek, header.paddingSize, pWav->pUserData) == DRWAV_FALSE) { + break; + } + cursor += header.paddingSize; + } + + /* Go to the next chunk. Don't include this chunk in metadata. */ + continue; + } + + /* "data" */ + if (((pWav->container == drwav_container_riff || pWav->container == drwav_container_rifx || pWav->container == drwav_container_rf64) && drwav_fourcc_equal(header.id.fourcc, "data")) || + ((pWav->container == drwav_container_w64) && drwav_guid_equal(header.id.guid, drwavGUID_W64_DATA))) { + foundChunk_data = DRWAV_TRUE; + + pWav->dataChunkDataPos = cursor; + + if (pWav->container != drwav_container_rf64) { /* The data chunk size for RF64 will always be set to 0xFFFFFFFF here. It was set to it's true value earlier. */ + dataChunkSize = chunkSize; + } + + /* If we're running in sequential mode, or we're not reading metadata, we have enough now that we can get out of the loop. */ + if (sequential || !isProcessingMetadata) { + break; /* No need to keep reading beyond the data chunk. */ + } else { + chunkSize += header.paddingSize; /* <-- Make sure we seek past the padding. */ + if (drwav__seek_forward(pWav->onSeek, chunkSize, pWav->pUserData) == DRWAV_FALSE) { + break; + } + cursor += chunkSize; + + continue; /* There may be some more metadata to read. */ + } + } + + /* "fact". This is optional. Can use this to get the sample count which is useful for compressed formats. For RF64 we retrieved the sample count from the ds64 chunk earlier. */ + if (((pWav->container == drwav_container_riff || pWav->container == drwav_container_rifx || pWav->container == drwav_container_rf64) && drwav_fourcc_equal(header.id.fourcc, "fact")) || + ((pWav->container == drwav_container_w64) && drwav_guid_equal(header.id.guid, drwavGUID_W64_FACT))) { + if (pWav->container == drwav_container_riff || pWav->container == drwav_container_rifx) { + drwav_uint8 sampleCount[4]; + if (drwav__on_read(pWav->onRead, pWav->pUserData, &sampleCount, 4, &cursor) != 4) { + return DRWAV_FALSE; + } + + chunkSize -= 4; + + /* + The sample count in the "fact" chunk is either unreliable, or I'm not understanding it properly. For now I am only enabling this + for Microsoft ADPCM formats. + */ + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM) { + sampleCountFromFactChunk = drwav_bytes_to_u32_ex(sampleCount, pWav->container); + } else { + sampleCountFromFactChunk = 0; + } + } else if (pWav->container == drwav_container_w64) { + if (drwav__on_read(pWav->onRead, pWav->pUserData, &sampleCountFromFactChunk, 8, &cursor) != 8) { + return DRWAV_FALSE; + } + + chunkSize -= 8; + } else if (pWav->container == drwav_container_rf64) { + /* We retrieved the sample count from the ds64 chunk earlier so no need to do that here. */ + } + + /* Seek to the next chunk in preparation for the next iteration. */ + chunkSize += header.paddingSize; /* <-- Make sure we seek past the padding. */ + if (drwav__seek_forward(pWav->onSeek, chunkSize, pWav->pUserData) == DRWAV_FALSE) { + break; + } + cursor += chunkSize; + + continue; + } + + + /* "COMM". AIFF/AIFC only. */ + if (pWav->container == drwav_container_aiff && drwav_fourcc_equal(header.id.fourcc, "COMM")) { + drwav_uint8 commData[24]; + drwav_uint32 commDataBytesToRead; + drwav_uint16 channels; + drwav_uint32 frameCount; + drwav_uint16 sampleSizeInBits; + drwav_int64 sampleRate; + drwav_uint16 compressionFormat; + + foundChunk_fmt = DRWAV_TRUE; + + if (isAIFCFormType) { + commDataBytesToRead = 24; + if (header.sizeInBytes < commDataBytesToRead) { + return DRWAV_FALSE; /* Invalid COMM chunk. */ + } + } else { + commDataBytesToRead = 18; + if (header.sizeInBytes != commDataBytesToRead) { + return DRWAV_FALSE; /* INVALID COMM chunk. */ + } + } + + if (drwav__on_read(pWav->onRead, pWav->pUserData, commData, commDataBytesToRead, &cursor) != commDataBytesToRead) { + return DRWAV_FALSE; + } + + + channels = drwav_bytes_to_u16_ex (commData + 0, pWav->container); + frameCount = drwav_bytes_to_u32_ex (commData + 2, pWav->container); + sampleSizeInBits = drwav_bytes_to_u16_ex (commData + 6, pWav->container); + sampleRate = drwav_aiff_extented_to_s64(commData + 8); + + if (sampleRate < 0 || sampleRate > 0xFFFFFFFF) { + return DRWAV_FALSE; /* Invalid sample rate. */ + } + + if (isAIFCFormType) { + const drwav_uint8* type = commData + 18; + + if (drwav_fourcc_equal(type, "NONE")) { + compressionFormat = DR_WAVE_FORMAT_PCM; /* PCM, big-endian. */ + } else if (drwav_fourcc_equal(type, "raw ")) { + compressionFormat = DR_WAVE_FORMAT_PCM; + + /* In my testing, it looks like when the "raw " compression type is used, 8-bit samples should be considered unsigned. */ + if (sampleSizeInBits == 8) { + pWav->aiff.isUnsigned = DRWAV_TRUE; + } + } else if (drwav_fourcc_equal(type, "sowt")) { + compressionFormat = DR_WAVE_FORMAT_PCM; /* PCM, little-endian. */ + pWav->aiff.isLE = DRWAV_TRUE; + } else if (drwav_fourcc_equal(type, "fl32") || drwav_fourcc_equal(type, "fl64") || drwav_fourcc_equal(type, "FL32") || drwav_fourcc_equal(type, "FL64")) { + compressionFormat = DR_WAVE_FORMAT_IEEE_FLOAT; + } else if (drwav_fourcc_equal(type, "alaw") || drwav_fourcc_equal(type, "ALAW")) { + compressionFormat = DR_WAVE_FORMAT_ALAW; + } else if (drwav_fourcc_equal(type, "ulaw") || drwav_fourcc_equal(type, "ULAW")) { + compressionFormat = DR_WAVE_FORMAT_MULAW; + } else if (drwav_fourcc_equal(type, "ima4")) { + compressionFormat = DR_WAVE_FORMAT_DVI_ADPCM; + sampleSizeInBits = 4; + + /* + I haven't been able to figure out how to get correct decoding for IMA ADPCM. Until this is figured out + we'll need to abort when we encounter such an encoding. Advice welcome! + */ + (void)compressionFormat; + (void)sampleSizeInBits; + + return DRWAV_FALSE; + } else { + return DRWAV_FALSE; /* Unknown or unsupported compression format. Need to abort. */ + } + } else { + compressionFormat = DR_WAVE_FORMAT_PCM; /* It's a standard AIFF form which is always compressed. */ + } + + /* With AIFF we want to use the explicitly defined frame count rather than deriving it from the size of the chunk. */ + aiffFrameCount = frameCount; + + /* We should now have enough information to fill out our fmt structure. */ + fmt.formatTag = compressionFormat; + fmt.channels = channels; + fmt.sampleRate = (drwav_uint32)sampleRate; + fmt.bitsPerSample = sampleSizeInBits; + fmt.blockAlign = (drwav_uint16)(fmt.channels * fmt.bitsPerSample / 8); + fmt.avgBytesPerSec = fmt.blockAlign * fmt.sampleRate; + + if (fmt.blockAlign == 0 && compressionFormat == DR_WAVE_FORMAT_DVI_ADPCM) { + fmt.blockAlign = 34 * fmt.channels; + } + + /* + Weird one. I've seen some alaw and ulaw encoded files that for some reason set the bits per sample to 16 when + it should be 8. To get this working I need to explicitly check for this and change it. + */ + if (compressionFormat == DR_WAVE_FORMAT_ALAW || compressionFormat == DR_WAVE_FORMAT_MULAW) { + if (fmt.bitsPerSample > 8) { + fmt.bitsPerSample = 8; + fmt.blockAlign = fmt.channels; + } + } + + /* In AIFF, samples are padded to 8 byte boundaries. We need to round up our bits per sample here. */ + fmt.bitsPerSample += (fmt.bitsPerSample & 7); + + + /* If the form type is AIFC there will be some additional data in the chunk. We need to seek past it. */ + if (isAIFCFormType) { + if (drwav__seek_forward(pWav->onSeek, (chunkSize - commDataBytesToRead), pWav->pUserData) == DRWAV_FALSE) { + return DRWAV_FALSE; + } + cursor += (chunkSize - commDataBytesToRead); + } + + /* Don't fall through or else we'll end up treating this chunk as metadata which is incorrect. */ + continue; + } + + + /* "SSND". AIFF/AIFC only. This is the AIFF equivalent of the "data" chunk. */ + if (pWav->container == drwav_container_aiff && drwav_fourcc_equal(header.id.fourcc, "SSND")) { + drwav_uint8 offsetAndBlockSizeData[8]; + drwav_uint32 offset; + + foundChunk_data = DRWAV_TRUE; + + if (drwav__on_read(pWav->onRead, pWav->pUserData, offsetAndBlockSizeData, sizeof(offsetAndBlockSizeData), &cursor) != sizeof(offsetAndBlockSizeData)) { + return DRWAV_FALSE; + } + + /* The position of the audio data starts at an offset. */ + offset = drwav_bytes_to_u32_ex(offsetAndBlockSizeData + 0, pWav->container); + pWav->dataChunkDataPos = cursor + offset; + + /* The data chunk size needs to be reduced by the offset or else seeking will break. */ + dataChunkSize = chunkSize; + if (dataChunkSize > offset) { + dataChunkSize -= offset; + } else { + dataChunkSize = 0; + } + + if (sequential) { + if (foundChunk_fmt) { /* <-- Name is misleading, but will be set to true if the COMM chunk has been parsed. */ + /* + Getting here means we're opening in sequential mode and we've found the SSND (data) and COMM (fmt) chunks. We need + to get out of the loop here or else we'll end up going past the data chunk and will have no way of getting back to + it since we're not allowed to seek backwards. + + One subtle detail here is that there is an offset with the SSND chunk. We need to make sure we seek past this offset + so we're left sitting on the first byte of actual audio data. + */ + if (drwav__seek_forward(pWav->onSeek, offset, pWav->pUserData) == DRWAV_FALSE) { + return DRWAV_FALSE; + } + cursor += offset; + + break; + } else { + /* + Getting here means the COMM chunk was not found. In sequential mode, if we haven't yet found the COMM chunk + we'll need to abort because we can't be doing a backwards seek back to the SSND chunk in order to read the + data. For this reason, this configuration of AIFF files are not supported with sequential mode. + */ + return DRWAV_FALSE; + } + } else { + chunkSize += header.paddingSize; /* <-- Make sure we seek past the padding. */ + chunkSize -= sizeof(offsetAndBlockSizeData); /* <-- This was read earlier. */ + + if (drwav__seek_forward(pWav->onSeek, chunkSize, pWav->pUserData) == DRWAV_FALSE) { + break; + } + cursor += chunkSize; + + continue; /* There may be some more metadata to read. */ + } + } + + + /* Getting here means it's not a chunk that we care about internally, but might need to be handled as metadata by the caller. */ + if (isProcessingMetadata) { + drwav__metadata_process_chunk(&metadataParser, &header, drwav_metadata_type_all_including_unknown); + + /* Go back to the start of the chunk so we can normalize the position of the cursor. */ + if (drwav__seek_from_start(pWav->onSeek, cursor, pWav->pUserData) == DRWAV_FALSE) { + break; /* Failed to seek. Can't reliable read the remaining chunks. Get out. */ + } + } + + + /* Make sure we skip past the content of this chunk before we go to the next one. */ + chunkSize += header.paddingSize; /* <-- Make sure we seek past the padding. */ + if (drwav__seek_forward(pWav->onSeek, chunkSize, pWav->pUserData) == DRWAV_FALSE) { + break; + } + cursor += chunkSize; + } + + /* There's some mandatory chunks that must exist. If they were not found in the iteration above we must abort. */ + if (!foundChunk_fmt || !foundChunk_data) { + return DRWAV_FALSE; + } + + /* Basic validation. */ + if ((fmt.sampleRate == 0 || fmt.sampleRate > DRWAV_MAX_SAMPLE_RATE ) || + (fmt.channels == 0 || fmt.channels > DRWAV_MAX_CHANNELS ) || + (fmt.bitsPerSample == 0 || fmt.bitsPerSample > DRWAV_MAX_BITS_PER_SAMPLE) || + fmt.blockAlign == 0) { + return DRWAV_FALSE; /* Probably an invalid WAV file. */ + } + + /* Translate the internal format. */ + translatedFormatTag = fmt.formatTag; + if (translatedFormatTag == DR_WAVE_FORMAT_EXTENSIBLE) { + translatedFormatTag = drwav_bytes_to_u16_ex(fmt.subFormat + 0, pWav->container); + } + + /* We may have moved passed the data chunk. If so we need to move back. If running in sequential mode we can assume we are already sitting on the data chunk. */ + if (!sequential) { + if (!drwav__seek_from_start(pWav->onSeek, pWav->dataChunkDataPos, pWav->pUserData)) { + return DRWAV_FALSE; + } + cursor = pWav->dataChunkDataPos; + } + + + /* + At this point we should have done the initial parsing of each of our chunks, but we now need to + do a second pass to extract the actual contents of the metadata (the first pass just calculated + the length of the memory allocation). + + We only do this if we've actually got metadata to parse. + */ + if (isProcessingMetadata && metadataParser.metadataCount > 0) { + if (drwav__seek_from_start(pWav->onSeek, metadataStartPos, pWav->pUserData) == DRWAV_FALSE) { + return DRWAV_FALSE; + } + + result = drwav__metadata_alloc(&metadataParser, &pWav->allocationCallbacks); + if (result != DRWAV_SUCCESS) { + return DRWAV_FALSE; + } + + metadataParser.stage = drwav__metadata_parser_stage_read; + + for (;;) { + drwav_chunk_header header; + drwav_uint64 metadataBytesRead; + + result = drwav__read_chunk_header(pWav->onRead, pWav->pUserData, pWav->container, &cursor, &header); + if (result != DRWAV_SUCCESS) { + break; + } + + metadataBytesRead = drwav__metadata_process_chunk(&metadataParser, &header, drwav_metadata_type_all_including_unknown); + + /* Move to the end of the chunk so we can keep iterating. */ + if (drwav__seek_forward(pWav->onSeek, (header.sizeInBytes + header.paddingSize) - metadataBytesRead, pWav->pUserData) == DRWAV_FALSE) { + drwav_free(metadataParser.pMetadata, &pWav->allocationCallbacks); + return DRWAV_FALSE; + } + } + + /* Getting here means we're finished parsing the metadata. */ + pWav->pMetadata = metadataParser.pMetadata; + pWav->metadataCount = metadataParser.metadataCount; + } + + /* + It's possible for the size reported in the data chunk to be greater than that of the file. We + need to do a validation check here to make sure we don't exceed the file size. To skip this + check, set the onTell callback to NULL. + */ + if (pWav->onTell != NULL && pWav->onSeek != NULL) { + if (pWav->onSeek(pWav->pUserData, 0, DRWAV_SEEK_END) == DRWAV_TRUE) { + drwav_int64 fileSize; + if (pWav->onTell(pWav->pUserData, &fileSize)) { + if (dataChunkSize + pWav->dataChunkDataPos > (drwav_uint64)fileSize) { + dataChunkSize = (drwav_uint64)fileSize - pWav->dataChunkDataPos; + } + } + } else { + /* + Failed to seek to the end of the file. It might not be supported by the backend so in + this case we cannot perform the validation check. + */ + } + } + + /* + I've seen a WAV file in the wild where a RIFF-ecapsulated file has the size of it's "RIFF" and + "data" chunks set to 0xFFFFFFFF when the file is definitely not that big. In this case we're + going to have to calculate the size by reading and discarding bytes, and then seeking back. We + cannot do this in sequential mode. We just assume that the rest of the file is audio data. + */ + if (dataChunkSize == 0xFFFFFFFF && (pWav->container == drwav_container_riff || pWav->container == drwav_container_rifx) && pWav->isSequentialWrite == DRWAV_FALSE) { + dataChunkSize = 0; + + for (;;) { + drwav_uint8 temp[4096]; + size_t bytesRead = pWav->onRead(pWav->pUserData, temp, sizeof(temp)); + dataChunkSize += bytesRead; + + if (bytesRead < sizeof(temp)) { + break; + } + } + } + + /* At this point we want to be sitting on the first byte of the raw audio data. */ + if (drwav__seek_from_start(pWav->onSeek, pWav->dataChunkDataPos, pWav->pUserData) == DRWAV_FALSE) { + drwav_free(pWav->pMetadata, &pWav->allocationCallbacks); + return DRWAV_FALSE; + } + + + pWav->fmt = fmt; + pWav->sampleRate = fmt.sampleRate; + pWav->channels = fmt.channels; + pWav->bitsPerSample = fmt.bitsPerSample; + pWav->translatedFormatTag = translatedFormatTag; + + /* + I've had a report where files would start glitching after seeking. The reason for this is the data + chunk is not a clean multiple of the PCM frame size in bytes. Where this becomes a problem is when + seeking, because the number of bytes remaining in the data chunk is used to calculate the current + byte position. If this byte position is not aligned to the number of bytes in a PCM frame, it will + result in the seek not being cleanly positioned at the start of the PCM frame thereby resulting in + all decoded frames after that being corrupted. + + To address this, we need to round the data chunk size down to the nearest multiple of the frame size. + */ + if (!drwav__is_compressed_format_tag(translatedFormatTag)) { + drwav_uint32 bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame > 0) { + dataChunkSize -= (dataChunkSize % bytesPerFrame); + } + } + + pWav->bytesRemaining = dataChunkSize; + pWav->dataChunkDataSize = dataChunkSize; + + if (sampleCountFromFactChunk != 0) { + pWav->totalPCMFrameCount = sampleCountFromFactChunk; + } else if (aiffFrameCount != 0) { + pWav->totalPCMFrameCount = aiffFrameCount; + } else { + drwav_uint32 bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + drwav_free(pWav->pMetadata, &pWav->allocationCallbacks); + return DRWAV_FALSE; /* Invalid file. */ + } + + pWav->totalPCMFrameCount = dataChunkSize / bytesPerFrame; + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM) { + drwav_uint64 totalBlockHeaderSizeInBytes; + drwav_uint64 blockCount = dataChunkSize / fmt.blockAlign; + + /* Make sure any trailing partial block is accounted for. */ + if ((blockCount * fmt.blockAlign) < dataChunkSize) { + blockCount += 1; + } + + /* We decode two samples per byte. There will be blockCount headers in the data chunk. This is enough to know how to calculate the total PCM frame count. */ + totalBlockHeaderSizeInBytes = blockCount * (6*fmt.channels); + if (totalBlockHeaderSizeInBytes >= dataChunkSize) { /* <-- We'll be subtracting totalBlockHeaderSizeInBytes from dataChunkSize next so it must be validated. */ + drwav_free(pWav->pMetadata, &pWav->allocationCallbacks); + return DRWAV_FALSE; /* Invalid file. */ + } + + pWav->totalPCMFrameCount = ((dataChunkSize - totalBlockHeaderSizeInBytes) * 2) / fmt.channels; + } + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_DVI_ADPCM) { + drwav_uint64 totalBlockHeaderSizeInBytes; + drwav_uint64 blockCount = dataChunkSize / fmt.blockAlign; + + /* Make sure any trailing partial block is accounted for. */ + if ((blockCount * fmt.blockAlign) < dataChunkSize) { + blockCount += 1; + } + + /* We decode two samples per byte. There will be blockCount headers in the data chunk. This is enough to know how to calculate the total PCM frame count. */ + totalBlockHeaderSizeInBytes = blockCount * (4*fmt.channels); + if (totalBlockHeaderSizeInBytes >= dataChunkSize) { /* <-- We'll be subtracting totalBlockHeaderSizeInBytes from dataChunkSize next so it must be validated. */ + drwav_free(pWav->pMetadata, &pWav->allocationCallbacks); + return DRWAV_FALSE; /* Invalid file. */ + } + + pWav->totalPCMFrameCount = ((dataChunkSize - totalBlockHeaderSizeInBytes) * 2) / fmt.channels; + + /* The header includes a decoded sample for each channel which acts as the initial predictor sample. */ + pWav->totalPCMFrameCount += blockCount; + } + } + + /* Some formats only support a certain number of channels. */ + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM || pWav->translatedFormatTag == DR_WAVE_FORMAT_DVI_ADPCM) { + if (pWav->channels > 2) { + drwav_free(pWav->pMetadata, &pWav->allocationCallbacks); + return DRWAV_FALSE; + } + } + + /* The number of bytes per frame must be known. If not, it's an invalid file and not decodable. */ + if (drwav_get_bytes_per_pcm_frame(pWav) == 0) { + drwav_free(pWav->pMetadata, &pWav->allocationCallbacks); + return DRWAV_FALSE; + } + +#ifdef DR_WAV_LIBSNDFILE_COMPAT + /* + I use libsndfile as a benchmark for testing, however in the version I'm using (from the Windows installer on the libsndfile website), + it appears the total sample count libsndfile uses for MS-ADPCM is incorrect. It would seem they are computing the total sample count + from the number of blocks, however this results in the inclusion of extra silent samples at the end of the last block. The correct + way to know the total sample count is to inspect the "fact" chunk, which should always be present for compressed formats, and should + always include the sample count. This little block of code below is only used to emulate the libsndfile logic so I can properly run my + correctness tests against libsndfile, and is disabled by default. + */ + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM) { + drwav_uint64 blockCount = dataChunkSize / fmt.blockAlign; + pWav->totalPCMFrameCount = (((blockCount * (fmt.blockAlign - (6*pWav->channels))) * 2)) / fmt.channels; /* x2 because two samples per byte. */ + } + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_DVI_ADPCM) { + drwav_uint64 blockCount = dataChunkSize / fmt.blockAlign; + pWav->totalPCMFrameCount = (((blockCount * (fmt.blockAlign - (4*pWav->channels))) * 2) + (blockCount * pWav->channels)) / fmt.channels; + } +#endif + + return DRWAV_TRUE; +} + +DRWAV_API drwav_bool32 drwav_init(drwav* pWav, drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_ex(pWav, onRead, onSeek, onTell, NULL, pUserData, NULL, 0, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_ex(drwav* pWav, drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, drwav_chunk_proc onChunk, void* pReadSeekTellUserData, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (!drwav_preinit(pWav, onRead, onSeek, onTell, pReadSeekTellUserData, pAllocationCallbacks)) { + return DRWAV_FALSE; + } + + return drwav_init__internal(pWav, onChunk, pChunkUserData, flags); +} + +DRWAV_API drwav_bool32 drwav_init_with_metadata(drwav* pWav, drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (!drwav_preinit(pWav, onRead, onSeek, onTell, pUserData, pAllocationCallbacks)) { + return DRWAV_FALSE; + } + + return drwav_init__internal(pWav, NULL, NULL, flags | DRWAV_WITH_METADATA); +} + +DRWAV_API drwav_metadata* drwav_take_ownership_of_metadata(drwav* pWav) +{ + drwav_metadata *result = pWav->pMetadata; + + pWav->pMetadata = NULL; + pWav->metadataCount = 0; + + return result; +} + + +DRWAV_PRIVATE size_t drwav__write(drwav* pWav, const void* pData, size_t dataSize) +{ + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pWav->onWrite != NULL); + + /* Generic write. Assumes no byte reordering required. */ + return pWav->onWrite(pWav->pUserData, pData, dataSize); +} + +DRWAV_PRIVATE size_t drwav__write_byte(drwav* pWav, drwav_uint8 byte) +{ + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pWav->onWrite != NULL); + + return pWav->onWrite(pWav->pUserData, &byte, 1); +} + +DRWAV_PRIVATE size_t drwav__write_u16ne_to_le(drwav* pWav, drwav_uint16 value) +{ + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pWav->onWrite != NULL); + + if (!drwav__is_little_endian()) { + value = drwav__bswap16(value); + } + + return drwav__write(pWav, &value, 2); +} + +DRWAV_PRIVATE size_t drwav__write_u32ne_to_le(drwav* pWav, drwav_uint32 value) +{ + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pWav->onWrite != NULL); + + if (!drwav__is_little_endian()) { + value = drwav__bswap32(value); + } + + return drwav__write(pWav, &value, 4); +} + +DRWAV_PRIVATE size_t drwav__write_u64ne_to_le(drwav* pWav, drwav_uint64 value) +{ + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pWav->onWrite != NULL); + + if (!drwav__is_little_endian()) { + value = drwav__bswap64(value); + } + + return drwav__write(pWav, &value, 8); +} + +DRWAV_PRIVATE size_t drwav__write_f32ne_to_le(drwav* pWav, float value) +{ + union { + drwav_uint32 u32; + float f32; + } u; + + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pWav->onWrite != NULL); + + u.f32 = value; + + if (!drwav__is_little_endian()) { + u.u32 = drwav__bswap32(u.u32); + } + + return drwav__write(pWav, &u.u32, 4); +} + +DRWAV_PRIVATE size_t drwav__write_or_count(drwav* pWav, const void* pData, size_t dataSize) +{ + if (pWav == NULL) { + return dataSize; + } + + return drwav__write(pWav, pData, dataSize); +} + +DRWAV_PRIVATE size_t drwav__write_or_count_byte(drwav* pWav, drwav_uint8 byte) +{ + if (pWav == NULL) { + return 1; + } + + return drwav__write_byte(pWav, byte); +} + +DRWAV_PRIVATE size_t drwav__write_or_count_u16ne_to_le(drwav* pWav, drwav_uint16 value) +{ + if (pWav == NULL) { + return 2; + } + + return drwav__write_u16ne_to_le(pWav, value); +} + +DRWAV_PRIVATE size_t drwav__write_or_count_u32ne_to_le(drwav* pWav, drwav_uint32 value) +{ + if (pWav == NULL) { + return 4; + } + + return drwav__write_u32ne_to_le(pWav, value); +} + +#if 0 /* Unused for now. */ +DRWAV_PRIVATE size_t drwav__write_or_count_u64ne_to_le(drwav* pWav, drwav_uint64 value) +{ + if (pWav == NULL) { + return 8; + } + + return drwav__write_u64ne_to_le(pWav, value); +} +#endif + +DRWAV_PRIVATE size_t drwav__write_or_count_f32ne_to_le(drwav* pWav, float value) +{ + if (pWav == NULL) { + return 4; + } + + return drwav__write_f32ne_to_le(pWav, value); +} + +DRWAV_PRIVATE size_t drwav__write_or_count_string_to_fixed_size_buf(drwav* pWav, char* str, size_t bufFixedSize) +{ + size_t len; + + if (pWav == NULL) { + return bufFixedSize; + } + + len = drwav__strlen_clamped(str, bufFixedSize); + drwav__write_or_count(pWav, str, len); + + if (len < bufFixedSize) { + size_t i; + for (i = 0; i < bufFixedSize - len; ++i) { + drwav__write_byte(pWav, 0); + } + } + + return bufFixedSize; +} + + +/* pWav can be NULL meaning just count the bytes that would be written. */ +DRWAV_PRIVATE size_t drwav__write_or_count_metadata(drwav* pWav, drwav_metadata* pMetadatas, drwav_uint32 metadataCount) +{ + size_t bytesWritten = 0; + drwav_bool32 hasListAdtl = DRWAV_FALSE; + drwav_bool32 hasListInfo = DRWAV_FALSE; + drwav_uint32 iMetadata; + + if (pMetadatas == NULL || metadataCount == 0) { + return 0; + } + + for (iMetadata = 0; iMetadata < metadataCount; ++iMetadata) { + drwav_metadata* pMetadata = &pMetadatas[iMetadata]; + drwav_uint32 chunkSize = 0; + + if ((pMetadata->type & drwav_metadata_type_list_all_info_strings) || (pMetadata->type == drwav_metadata_type_unknown && pMetadata->data.unknown.chunkLocation == drwav_metadata_location_inside_info_list)) { + hasListInfo = DRWAV_TRUE; + } + + if ((pMetadata->type & drwav_metadata_type_list_all_adtl) || (pMetadata->type == drwav_metadata_type_unknown && pMetadata->data.unknown.chunkLocation == drwav_metadata_location_inside_adtl_list)) { + hasListAdtl = DRWAV_TRUE; + } + + switch (pMetadata->type) { + case drwav_metadata_type_smpl: + { + drwav_uint32 iLoop; + + chunkSize = DRWAV_SMPL_BYTES + DRWAV_SMPL_LOOP_BYTES * pMetadata->data.smpl.sampleLoopCount + pMetadata->data.smpl.samplerSpecificDataSizeInBytes; + + bytesWritten += drwav__write_or_count(pWav, "smpl", 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, chunkSize); + + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.manufacturerId); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.productId); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.samplePeriodNanoseconds); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.midiUnityNote); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.midiPitchFraction); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.smpteFormat); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.smpteOffset); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.sampleLoopCount); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.samplerSpecificDataSizeInBytes); + + for (iLoop = 0; iLoop < pMetadata->data.smpl.sampleLoopCount; ++iLoop) { + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.pLoops[iLoop].cuePointId); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.pLoops[iLoop].type); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.pLoops[iLoop].firstSampleOffset); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.pLoops[iLoop].lastSampleOffset); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.pLoops[iLoop].sampleFraction); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.smpl.pLoops[iLoop].playCount); + } + + if (pMetadata->data.smpl.samplerSpecificDataSizeInBytes > 0) { + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.smpl.pSamplerSpecificData, pMetadata->data.smpl.samplerSpecificDataSizeInBytes); + } + } break; + + case drwav_metadata_type_inst: + { + chunkSize = DRWAV_INST_BYTES; + + bytesWritten += drwav__write_or_count(pWav, "inst", 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, chunkSize); + bytesWritten += drwav__write_or_count(pWav, &pMetadata->data.inst.midiUnityNote, 1); + bytesWritten += drwav__write_or_count(pWav, &pMetadata->data.inst.fineTuneCents, 1); + bytesWritten += drwav__write_or_count(pWav, &pMetadata->data.inst.gainDecibels, 1); + bytesWritten += drwav__write_or_count(pWav, &pMetadata->data.inst.lowNote, 1); + bytesWritten += drwav__write_or_count(pWav, &pMetadata->data.inst.highNote, 1); + bytesWritten += drwav__write_or_count(pWav, &pMetadata->data.inst.lowVelocity, 1); + bytesWritten += drwav__write_or_count(pWav, &pMetadata->data.inst.highVelocity, 1); + } break; + + case drwav_metadata_type_cue: + { + drwav_uint32 iCuePoint; + + chunkSize = DRWAV_CUE_BYTES + DRWAV_CUE_POINT_BYTES * pMetadata->data.cue.cuePointCount; + + bytesWritten += drwav__write_or_count(pWav, "cue ", 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, chunkSize); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.cue.cuePointCount); + for (iCuePoint = 0; iCuePoint < pMetadata->data.cue.cuePointCount; ++iCuePoint) { + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.cue.pCuePoints[iCuePoint].id); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.cue.pCuePoints[iCuePoint].playOrderPosition); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.cue.pCuePoints[iCuePoint].dataChunkId, 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.cue.pCuePoints[iCuePoint].chunkStart); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.cue.pCuePoints[iCuePoint].blockStart); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.cue.pCuePoints[iCuePoint].sampleOffset); + } + } break; + + case drwav_metadata_type_acid: + { + chunkSize = DRWAV_ACID_BYTES; + + bytesWritten += drwav__write_or_count(pWav, "acid", 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, chunkSize); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.acid.flags); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.acid.midiUnityNote); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.acid.reserved1); + bytesWritten += drwav__write_or_count_f32ne_to_le(pWav, pMetadata->data.acid.reserved2); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.acid.numBeats); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.acid.meterDenominator); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.acid.meterNumerator); + bytesWritten += drwav__write_or_count_f32ne_to_le(pWav, pMetadata->data.acid.tempo); + } break; + + case drwav_metadata_type_bext: + { + char reservedBuf[DRWAV_BEXT_RESERVED_BYTES]; + drwav_uint32 timeReferenceLow; + drwav_uint32 timeReferenceHigh; + + chunkSize = DRWAV_BEXT_BYTES + pMetadata->data.bext.codingHistorySize; + + bytesWritten += drwav__write_or_count(pWav, "bext", 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, chunkSize); + + bytesWritten += drwav__write_or_count_string_to_fixed_size_buf(pWav, pMetadata->data.bext.pDescription, DRWAV_BEXT_DESCRIPTION_BYTES); + bytesWritten += drwav__write_or_count_string_to_fixed_size_buf(pWav, pMetadata->data.bext.pOriginatorName, DRWAV_BEXT_ORIGINATOR_NAME_BYTES); + bytesWritten += drwav__write_or_count_string_to_fixed_size_buf(pWav, pMetadata->data.bext.pOriginatorReference, DRWAV_BEXT_ORIGINATOR_REF_BYTES); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.bext.pOriginationDate, sizeof(pMetadata->data.bext.pOriginationDate)); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.bext.pOriginationTime, sizeof(pMetadata->data.bext.pOriginationTime)); + + timeReferenceLow = (drwav_uint32)(pMetadata->data.bext.timeReference & 0xFFFFFFFF); + timeReferenceHigh = (drwav_uint32)(pMetadata->data.bext.timeReference >> 32); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, timeReferenceLow); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, timeReferenceHigh); + + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.bext.version); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.bext.pUMID, DRWAV_BEXT_UMID_BYTES); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.bext.loudnessValue); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.bext.loudnessRange); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.bext.maxTruePeakLevel); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.bext.maxMomentaryLoudness); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.bext.maxShortTermLoudness); + + DRWAV_ZERO_MEMORY(reservedBuf, sizeof(reservedBuf)); + bytesWritten += drwav__write_or_count(pWav, reservedBuf, sizeof(reservedBuf)); + + if (pMetadata->data.bext.codingHistorySize > 0) { + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.bext.pCodingHistory, pMetadata->data.bext.codingHistorySize); + } + } break; + + case drwav_metadata_type_unknown: + { + if (pMetadata->data.unknown.chunkLocation == drwav_metadata_location_top_level) { + chunkSize = pMetadata->data.unknown.dataSizeInBytes; + + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.unknown.id, 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, chunkSize); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.unknown.pData, pMetadata->data.unknown.dataSizeInBytes); + } + } break; + + default: break; + } + if ((chunkSize % 2) != 0) { + bytesWritten += drwav__write_or_count_byte(pWav, 0); + } + } + + if (hasListInfo) { + drwav_uint32 chunkSize = 4; /* Start with 4 bytes for "INFO". */ + for (iMetadata = 0; iMetadata < metadataCount; ++iMetadata) { + drwav_metadata* pMetadata = &pMetadatas[iMetadata]; + + if ((pMetadata->type & drwav_metadata_type_list_all_info_strings)) { + chunkSize += 8; /* For id and string size. */ + chunkSize += pMetadata->data.infoText.stringLength + 1; /* Include null terminator. */ + } else if (pMetadata->type == drwav_metadata_type_unknown && pMetadata->data.unknown.chunkLocation == drwav_metadata_location_inside_info_list) { + chunkSize += 8; /* For id string size. */ + chunkSize += pMetadata->data.unknown.dataSizeInBytes; + } + + if ((chunkSize % 2) != 0) { + chunkSize += 1; + } + } + + bytesWritten += drwav__write_or_count(pWav, "LIST", 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, chunkSize); + bytesWritten += drwav__write_or_count(pWav, "INFO", 4); + + for (iMetadata = 0; iMetadata < metadataCount; ++iMetadata) { + drwav_metadata* pMetadata = &pMetadatas[iMetadata]; + drwav_uint32 subchunkSize = 0; + + if (pMetadata->type & drwav_metadata_type_list_all_info_strings) { + const char* pID = NULL; + + switch (pMetadata->type) { + case drwav_metadata_type_list_info_software: pID = "ISFT"; break; + case drwav_metadata_type_list_info_copyright: pID = "ICOP"; break; + case drwav_metadata_type_list_info_title: pID = "INAM"; break; + case drwav_metadata_type_list_info_artist: pID = "IART"; break; + case drwav_metadata_type_list_info_comment: pID = "ICMT"; break; + case drwav_metadata_type_list_info_date: pID = "ICRD"; break; + case drwav_metadata_type_list_info_genre: pID = "IGNR"; break; + case drwav_metadata_type_list_info_album: pID = "IPRD"; break; + case drwav_metadata_type_list_info_tracknumber: pID = "ITRK"; break; + case drwav_metadata_type_list_info_location: pID = "IARL"; break; + case drwav_metadata_type_list_info_organization: pID = "ICMS"; break; + case drwav_metadata_type_list_info_keywords: pID = "IKEY"; break; + case drwav_metadata_type_list_info_medium: pID = "IMED"; break; + case drwav_metadata_type_list_info_description: pID = "ISBJ"; break; + default: break; + } + + DRWAV_ASSERT(pID != NULL); + + if (pMetadata->data.infoText.stringLength) { + subchunkSize = pMetadata->data.infoText.stringLength + 1; + bytesWritten += drwav__write_or_count(pWav, pID, 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, subchunkSize); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.infoText.pString, pMetadata->data.infoText.stringLength); + bytesWritten += drwav__write_or_count_byte(pWav, '\0'); + } + } else if (pMetadata->type == drwav_metadata_type_unknown && pMetadata->data.unknown.chunkLocation == drwav_metadata_location_inside_info_list) { + if (pMetadata->data.unknown.dataSizeInBytes) { + subchunkSize = pMetadata->data.unknown.dataSizeInBytes; + + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.unknown.id, 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.unknown.dataSizeInBytes); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.unknown.pData, subchunkSize); + } + } + + if ((subchunkSize % 2) != 0) { + bytesWritten += drwav__write_or_count_byte(pWav, 0); + } + } + } + + if (hasListAdtl) { + drwav_uint32 chunkSize = 4; /* start with 4 bytes for "adtl" */ + + for (iMetadata = 0; iMetadata < metadataCount; ++iMetadata) { + drwav_metadata* pMetadata = &pMetadatas[iMetadata]; + + switch (pMetadata->type) + { + case drwav_metadata_type_list_label: + case drwav_metadata_type_list_note: + { + chunkSize += 8; /* for id and chunk size */ + chunkSize += DRWAV_LIST_LABEL_OR_NOTE_BYTES; + + if (pMetadata->data.labelOrNote.stringLength > 0) { + chunkSize += pMetadata->data.labelOrNote.stringLength + 1; + } + } break; + + case drwav_metadata_type_list_labelled_cue_region: + { + chunkSize += 8; /* for id and chunk size */ + chunkSize += DRWAV_LIST_LABELLED_TEXT_BYTES; + + if (pMetadata->data.labelledCueRegion.stringLength > 0) { + chunkSize += pMetadata->data.labelledCueRegion.stringLength + 1; + } + } break; + + case drwav_metadata_type_unknown: + { + if (pMetadata->data.unknown.chunkLocation == drwav_metadata_location_inside_adtl_list) { + chunkSize += 8; /* for id and chunk size */ + chunkSize += pMetadata->data.unknown.dataSizeInBytes; + } + } break; + + default: break; + } + + if ((chunkSize % 2) != 0) { + chunkSize += 1; + } + } + + bytesWritten += drwav__write_or_count(pWav, "LIST", 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, chunkSize); + bytesWritten += drwav__write_or_count(pWav, "adtl", 4); + + for (iMetadata = 0; iMetadata < metadataCount; ++iMetadata) { + drwav_metadata* pMetadata = &pMetadatas[iMetadata]; + drwav_uint32 subchunkSize = 0; + + switch (pMetadata->type) + { + case drwav_metadata_type_list_label: + case drwav_metadata_type_list_note: + { + if (pMetadata->data.labelOrNote.stringLength > 0) { + const char *pID = NULL; + + if (pMetadata->type == drwav_metadata_type_list_label) { + pID = "labl"; + } + else if (pMetadata->type == drwav_metadata_type_list_note) { + pID = "note"; + } + + DRWAV_ASSERT(pID != NULL); + DRWAV_ASSERT(pMetadata->data.labelOrNote.pString != NULL); + + subchunkSize = DRWAV_LIST_LABEL_OR_NOTE_BYTES; + + bytesWritten += drwav__write_or_count(pWav, pID, 4); + subchunkSize += pMetadata->data.labelOrNote.stringLength + 1; + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, subchunkSize); + + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.labelOrNote.cuePointId); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.labelOrNote.pString, pMetadata->data.labelOrNote.stringLength); + bytesWritten += drwav__write_or_count_byte(pWav, '\0'); + } + } break; + + case drwav_metadata_type_list_labelled_cue_region: + { + subchunkSize = DRWAV_LIST_LABELLED_TEXT_BYTES; + + bytesWritten += drwav__write_or_count(pWav, "ltxt", 4); + if (pMetadata->data.labelledCueRegion.stringLength > 0) { + subchunkSize += pMetadata->data.labelledCueRegion.stringLength + 1; + } + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, subchunkSize); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.labelledCueRegion.cuePointId); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, pMetadata->data.labelledCueRegion.sampleLength); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.labelledCueRegion.purposeId, 4); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.labelledCueRegion.country); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.labelledCueRegion.language); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.labelledCueRegion.dialect); + bytesWritten += drwav__write_or_count_u16ne_to_le(pWav, pMetadata->data.labelledCueRegion.codePage); + + if (pMetadata->data.labelledCueRegion.stringLength > 0) { + DRWAV_ASSERT(pMetadata->data.labelledCueRegion.pString != NULL); + + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.labelledCueRegion.pString, pMetadata->data.labelledCueRegion.stringLength); + bytesWritten += drwav__write_or_count_byte(pWav, '\0'); + } + } break; + + case drwav_metadata_type_unknown: + { + if (pMetadata->data.unknown.chunkLocation == drwav_metadata_location_inside_adtl_list) { + subchunkSize = pMetadata->data.unknown.dataSizeInBytes; + + DRWAV_ASSERT(pMetadata->data.unknown.pData != NULL); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.unknown.id, 4); + bytesWritten += drwav__write_or_count_u32ne_to_le(pWav, subchunkSize); + bytesWritten += drwav__write_or_count(pWav, pMetadata->data.unknown.pData, subchunkSize); + } + } break; + + default: break; + } + + if ((subchunkSize % 2) != 0) { + bytesWritten += drwav__write_or_count_byte(pWav, 0); + } + } + } + + DRWAV_ASSERT((bytesWritten % 2) == 0); + + return bytesWritten; +} + +DRWAV_PRIVATE drwav_uint32 drwav__riff_chunk_size_riff(drwav_uint64 dataChunkSize, drwav_metadata* pMetadata, drwav_uint32 metadataCount) +{ + drwav_uint64 chunkSize = 4 + 24 + (drwav_uint64)drwav__write_or_count_metadata(NULL, pMetadata, metadataCount) + 8 + dataChunkSize + drwav__chunk_padding_size_riff(dataChunkSize); /* 4 = "WAVE". 24 = "fmt " chunk. 8 = "data" + u32 data size. */ + if (chunkSize > 0xFFFFFFFFUL) { + chunkSize = 0xFFFFFFFFUL; + } + + return (drwav_uint32)chunkSize; /* Safe cast due to the clamp above. */ +} + +DRWAV_PRIVATE drwav_uint32 drwav__data_chunk_size_riff(drwav_uint64 dataChunkSize) +{ + if (dataChunkSize <= 0xFFFFFFFFUL) { + return (drwav_uint32)dataChunkSize; + } else { + return 0xFFFFFFFFUL; + } +} + +DRWAV_PRIVATE drwav_uint64 drwav__riff_chunk_size_w64(drwav_uint64 dataChunkSize) +{ + drwav_uint64 dataSubchunkPaddingSize = drwav__chunk_padding_size_w64(dataChunkSize); + + return 80 + 24 + dataChunkSize + dataSubchunkPaddingSize; /* +24 because W64 includes the size of the GUID and size fields. */ +} + +DRWAV_PRIVATE drwav_uint64 drwav__data_chunk_size_w64(drwav_uint64 dataChunkSize) +{ + return 24 + dataChunkSize; /* +24 because W64 includes the size of the GUID and size fields. */ +} + +DRWAV_PRIVATE drwav_uint64 drwav__riff_chunk_size_rf64(drwav_uint64 dataChunkSize, drwav_metadata *metadata, drwav_uint32 numMetadata) +{ + drwav_uint64 chunkSize = 4 + 36 + 24 + (drwav_uint64)drwav__write_or_count_metadata(NULL, metadata, numMetadata) + 8 + dataChunkSize + drwav__chunk_padding_size_riff(dataChunkSize); /* 4 = "WAVE". 36 = "ds64" chunk. 24 = "fmt " chunk. 8 = "data" + u32 data size. */ + if (chunkSize > 0xFFFFFFFFUL) { + chunkSize = 0xFFFFFFFFUL; + } + + return chunkSize; +} + +DRWAV_PRIVATE drwav_uint64 drwav__data_chunk_size_rf64(drwav_uint64 dataChunkSize) +{ + return dataChunkSize; +} + + + +DRWAV_PRIVATE drwav_bool32 drwav_preinit_write(drwav* pWav, const drwav_data_format* pFormat, drwav_bool32 isSequential, drwav_write_proc onWrite, drwav_seek_proc onSeek, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pWav == NULL || onWrite == NULL) { + return DRWAV_FALSE; + } + + if (!isSequential && onSeek == NULL) { + return DRWAV_FALSE; /* <-- onSeek is required when in non-sequential mode. */ + } + + /* Not currently supporting compressed formats. Will need to add support for the "fact" chunk before we enable this. */ + if (pFormat->format == DR_WAVE_FORMAT_EXTENSIBLE) { + return DRWAV_FALSE; + } + if (pFormat->format == DR_WAVE_FORMAT_ADPCM || pFormat->format == DR_WAVE_FORMAT_DVI_ADPCM) { + return DRWAV_FALSE; + } + + DRWAV_ZERO_MEMORY(pWav, sizeof(*pWav)); + pWav->onWrite = onWrite; + pWav->onSeek = onSeek; + pWav->pUserData = pUserData; + pWav->allocationCallbacks = drwav_copy_allocation_callbacks_or_defaults(pAllocationCallbacks); + + if (pWav->allocationCallbacks.onFree == NULL || (pWav->allocationCallbacks.onMalloc == NULL && pWav->allocationCallbacks.onRealloc == NULL)) { + return DRWAV_FALSE; /* Invalid allocation callbacks. */ + } + + pWav->fmt.formatTag = (drwav_uint16)pFormat->format; + pWav->fmt.channels = (drwav_uint16)pFormat->channels; + pWav->fmt.sampleRate = pFormat->sampleRate; + pWav->fmt.avgBytesPerSec = (drwav_uint32)((pFormat->bitsPerSample * pFormat->sampleRate * pFormat->channels) / 8); + pWav->fmt.blockAlign = (drwav_uint16)((pFormat->channels * pFormat->bitsPerSample) / 8); + pWav->fmt.bitsPerSample = (drwav_uint16)pFormat->bitsPerSample; + pWav->fmt.extendedSize = 0; + pWav->isSequentialWrite = isSequential; + + return DRWAV_TRUE; +} + + +DRWAV_PRIVATE drwav_bool32 drwav_init_write__internal(drwav* pWav, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount) +{ + /* The function assumes drwav_preinit_write() was called beforehand. */ + + size_t runningPos = 0; + drwav_uint64 initialDataChunkSize = 0; + drwav_uint64 chunkSizeFMT; + + /* + The initial values for the "RIFF" and "data" chunks depends on whether or not we are initializing in sequential mode or not. In + sequential mode we set this to its final values straight away since they can be calculated from the total sample count. In non- + sequential mode we initialize it all to zero and fill it out in drwav_uninit() using a backwards seek. + */ + if (pWav->isSequentialWrite) { + initialDataChunkSize = (totalSampleCount * pWav->fmt.bitsPerSample) / 8; + + /* + The RIFF container has a limit on the number of samples. drwav is not allowing this. There's no practical limits for Wave64 + so for the sake of simplicity I'm not doing any validation for that. + */ + if (pFormat->container == drwav_container_riff) { + if (initialDataChunkSize > (0xFFFFFFFFUL - 36)) { + return DRWAV_FALSE; /* Not enough room to store every sample. */ + } + } + } + + pWav->dataChunkDataSizeTargetWrite = initialDataChunkSize; + + + /* "RIFF" chunk. */ + if (pFormat->container == drwav_container_riff) { + drwav_uint32 chunkSizeRIFF = 36 + (drwav_uint32)initialDataChunkSize; /* +36 = "WAVE" + [sizeof "fmt " chunk] + [data chunk header] */ + runningPos += drwav__write(pWav, "RIFF", 4); + runningPos += drwav__write_u32ne_to_le(pWav, chunkSizeRIFF); + runningPos += drwav__write(pWav, "WAVE", 4); + } else if (pFormat->container == drwav_container_w64) { + drwav_uint64 chunkSizeRIFF = 80 + 24 + initialDataChunkSize; /* +24 because W64 includes the size of the GUID and size fields. */ + runningPos += drwav__write(pWav, drwavGUID_W64_RIFF, 16); + runningPos += drwav__write_u64ne_to_le(pWav, chunkSizeRIFF); + runningPos += drwav__write(pWav, drwavGUID_W64_WAVE, 16); + } else if (pFormat->container == drwav_container_rf64) { + runningPos += drwav__write(pWav, "RF64", 4); + runningPos += drwav__write_u32ne_to_le(pWav, 0xFFFFFFFF); /* Always 0xFFFFFFFF for RF64. Set to a proper value in the "ds64" chunk. */ + runningPos += drwav__write(pWav, "WAVE", 4); + } else { + return DRWAV_FALSE; /* Container not supported for writing. */ + } + + + /* "ds64" chunk (RF64 only). */ + if (pFormat->container == drwav_container_rf64) { + drwav_uint32 initialds64ChunkSize = 28; /* 28 = [Size of RIFF (8 bytes)] + [Size of DATA (8 bytes)] + [Sample Count (8 bytes)] + [Table Length (4 bytes)]. Table length always set to 0. */ + drwav_uint64 initialRiffChunkSize = 8 + initialds64ChunkSize + initialDataChunkSize; /* +8 for the ds64 header. */ + + runningPos += drwav__write(pWav, "ds64", 4); + runningPos += drwav__write_u32ne_to_le(pWav, initialds64ChunkSize); /* Size of ds64. */ + runningPos += drwav__write_u64ne_to_le(pWav, initialRiffChunkSize); /* Size of RIFF. Set to true value at the end. */ + runningPos += drwav__write_u64ne_to_le(pWav, initialDataChunkSize); /* Size of DATA. Set to true value at the end. */ + runningPos += drwav__write_u64ne_to_le(pWav, totalSampleCount); /* Sample count. */ + runningPos += drwav__write_u32ne_to_le(pWav, 0); /* Table length. Always set to zero in our case since we're not doing any other chunks than "DATA". */ + } + + + /* "fmt " chunk. */ + if (pFormat->container == drwav_container_riff || pFormat->container == drwav_container_rf64) { + chunkSizeFMT = 16; + runningPos += drwav__write(pWav, "fmt ", 4); + runningPos += drwav__write_u32ne_to_le(pWav, (drwav_uint32)chunkSizeFMT); + } else if (pFormat->container == drwav_container_w64) { + chunkSizeFMT = 40; + runningPos += drwav__write(pWav, drwavGUID_W64_FMT, 16); + runningPos += drwav__write_u64ne_to_le(pWav, chunkSizeFMT); + } + + runningPos += drwav__write_u16ne_to_le(pWav, pWav->fmt.formatTag); + runningPos += drwav__write_u16ne_to_le(pWav, pWav->fmt.channels); + runningPos += drwav__write_u32ne_to_le(pWav, pWav->fmt.sampleRate); + runningPos += drwav__write_u32ne_to_le(pWav, pWav->fmt.avgBytesPerSec); + runningPos += drwav__write_u16ne_to_le(pWav, pWav->fmt.blockAlign); + runningPos += drwav__write_u16ne_to_le(pWav, pWav->fmt.bitsPerSample); + + /* TODO: is a 'fact' chunk required for DR_WAVE_FORMAT_IEEE_FLOAT? */ + + if (!pWav->isSequentialWrite && pWav->pMetadata != NULL && pWav->metadataCount > 0 && (pFormat->container == drwav_container_riff || pFormat->container == drwav_container_rf64)) { + runningPos += drwav__write_or_count_metadata(pWav, pWav->pMetadata, pWav->metadataCount); + } + + pWav->dataChunkDataPos = runningPos; + + /* "data" chunk. */ + if (pFormat->container == drwav_container_riff) { + drwav_uint32 chunkSizeDATA = (drwav_uint32)initialDataChunkSize; + runningPos += drwav__write(pWav, "data", 4); + runningPos += drwav__write_u32ne_to_le(pWav, chunkSizeDATA); + } else if (pFormat->container == drwav_container_w64) { + drwav_uint64 chunkSizeDATA = 24 + initialDataChunkSize; /* +24 because W64 includes the size of the GUID and size fields. */ + runningPos += drwav__write(pWav, drwavGUID_W64_DATA, 16); + runningPos += drwav__write_u64ne_to_le(pWav, chunkSizeDATA); + } else if (pFormat->container == drwav_container_rf64) { + runningPos += drwav__write(pWav, "data", 4); + runningPos += drwav__write_u32ne_to_le(pWav, 0xFFFFFFFF); /* Always set to 0xFFFFFFFF for RF64. The true size of the data chunk is specified in the ds64 chunk. */ + } + + /* Set some properties for the client's convenience. */ + pWav->container = pFormat->container; + pWav->channels = (drwav_uint16)pFormat->channels; + pWav->sampleRate = pFormat->sampleRate; + pWav->bitsPerSample = (drwav_uint16)pFormat->bitsPerSample; + pWav->translatedFormatTag = (drwav_uint16)pFormat->format; + pWav->dataChunkDataPos = runningPos; + + return DRWAV_TRUE; +} + + +DRWAV_API drwav_bool32 drwav_init_write(drwav* pWav, const drwav_data_format* pFormat, drwav_write_proc onWrite, drwav_seek_proc onSeek, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (!drwav_preinit_write(pWav, pFormat, DRWAV_FALSE, onWrite, onSeek, pUserData, pAllocationCallbacks)) { + return DRWAV_FALSE; + } + + return drwav_init_write__internal(pWav, pFormat, 0); /* DRWAV_FALSE = Not Sequential */ +} + +DRWAV_API drwav_bool32 drwav_init_write_sequential(drwav* pWav, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, drwav_write_proc onWrite, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (!drwav_preinit_write(pWav, pFormat, DRWAV_TRUE, onWrite, NULL, pUserData, pAllocationCallbacks)) { + return DRWAV_FALSE; + } + + return drwav_init_write__internal(pWav, pFormat, totalSampleCount); /* DRWAV_TRUE = Sequential */ +} + +DRWAV_API drwav_bool32 drwav_init_write_sequential_pcm_frames(drwav* pWav, const drwav_data_format* pFormat, drwav_uint64 totalPCMFrameCount, drwav_write_proc onWrite, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pFormat == NULL) { + return DRWAV_FALSE; + } + + return drwav_init_write_sequential(pWav, pFormat, totalPCMFrameCount*pFormat->channels, onWrite, pUserData, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_write_with_metadata(drwav* pWav, const drwav_data_format* pFormat, drwav_write_proc onWrite, drwav_seek_proc onSeek, void* pUserData, const drwav_allocation_callbacks* pAllocationCallbacks, drwav_metadata* pMetadata, drwav_uint32 metadataCount) +{ + if (!drwav_preinit_write(pWav, pFormat, DRWAV_FALSE, onWrite, onSeek, pUserData, pAllocationCallbacks)) { + return DRWAV_FALSE; + } + + pWav->pMetadata = pMetadata; + pWav->metadataCount = metadataCount; + + return drwav_init_write__internal(pWav, pFormat, 0); +} + + +DRWAV_API drwav_uint64 drwav_target_write_size_bytes(const drwav_data_format* pFormat, drwav_uint64 totalFrameCount, drwav_metadata* pMetadata, drwav_uint32 metadataCount) +{ + /* Casting totalFrameCount to drwav_int64 for VC6 compatibility. No issues in practice because nobody is going to exhaust the whole 63 bits. */ + drwav_uint64 targetDataSizeBytes = (drwav_uint64)((drwav_int64)totalFrameCount * pFormat->channels * pFormat->bitsPerSample/8.0); + drwav_uint64 riffChunkSizeBytes; + drwav_uint64 fileSizeBytes = 0; + + if (pFormat->container == drwav_container_riff) { + riffChunkSizeBytes = drwav__riff_chunk_size_riff(targetDataSizeBytes, pMetadata, metadataCount); + fileSizeBytes = (8 + riffChunkSizeBytes); /* +8 because WAV doesn't include the size of the ChunkID and ChunkSize fields. */ + } else if (pFormat->container == drwav_container_w64) { + riffChunkSizeBytes = drwav__riff_chunk_size_w64(targetDataSizeBytes); + fileSizeBytes = riffChunkSizeBytes; + } else if (pFormat->container == drwav_container_rf64) { + riffChunkSizeBytes = drwav__riff_chunk_size_rf64(targetDataSizeBytes, pMetadata, metadataCount); + fileSizeBytes = (8 + riffChunkSizeBytes); /* +8 because WAV doesn't include the size of the ChunkID and ChunkSize fields. */ + } + + return fileSizeBytes; +} + + +#ifndef DR_WAV_NO_STDIO + +/* Errno */ +/* drwav_result_from_errno() is only used for fopen() and wfopen() so putting it inside DR_WAV_NO_STDIO for now. If something else needs this later we can move it out. */ +#include +DRWAV_PRIVATE drwav_result drwav_result_from_errno(int e) +{ + switch (e) + { + case 0: return DRWAV_SUCCESS; + #ifdef EPERM + case EPERM: return DRWAV_INVALID_OPERATION; + #endif + #ifdef ENOENT + case ENOENT: return DRWAV_DOES_NOT_EXIST; + #endif + #ifdef ESRCH + case ESRCH: return DRWAV_DOES_NOT_EXIST; + #endif + #ifdef EINTR + case EINTR: return DRWAV_INTERRUPT; + #endif + #ifdef EIO + case EIO: return DRWAV_IO_ERROR; + #endif + #ifdef ENXIO + case ENXIO: return DRWAV_DOES_NOT_EXIST; + #endif + #ifdef E2BIG + case E2BIG: return DRWAV_INVALID_ARGS; + #endif + #ifdef ENOEXEC + case ENOEXEC: return DRWAV_INVALID_FILE; + #endif + #ifdef EBADF + case EBADF: return DRWAV_INVALID_FILE; + #endif + #ifdef ECHILD + case ECHILD: return DRWAV_ERROR; + #endif + #ifdef EAGAIN + case EAGAIN: return DRWAV_UNAVAILABLE; + #endif + #ifdef ENOMEM + case ENOMEM: return DRWAV_OUT_OF_MEMORY; + #endif + #ifdef EACCES + case EACCES: return DRWAV_ACCESS_DENIED; + #endif + #ifdef EFAULT + case EFAULT: return DRWAV_BAD_ADDRESS; + #endif + #ifdef ENOTBLK + case ENOTBLK: return DRWAV_ERROR; + #endif + #ifdef EBUSY + case EBUSY: return DRWAV_BUSY; + #endif + #ifdef EEXIST + case EEXIST: return DRWAV_ALREADY_EXISTS; + #endif + #ifdef EXDEV + case EXDEV: return DRWAV_ERROR; + #endif + #ifdef ENODEV + case ENODEV: return DRWAV_DOES_NOT_EXIST; + #endif + #ifdef ENOTDIR + case ENOTDIR: return DRWAV_NOT_DIRECTORY; + #endif + #ifdef EISDIR + case EISDIR: return DRWAV_IS_DIRECTORY; + #endif + #ifdef EINVAL + case EINVAL: return DRWAV_INVALID_ARGS; + #endif + #ifdef ENFILE + case ENFILE: return DRWAV_TOO_MANY_OPEN_FILES; + #endif + #ifdef EMFILE + case EMFILE: return DRWAV_TOO_MANY_OPEN_FILES; + #endif + #ifdef ENOTTY + case ENOTTY: return DRWAV_INVALID_OPERATION; + #endif + #ifdef ETXTBSY + case ETXTBSY: return DRWAV_BUSY; + #endif + #ifdef EFBIG + case EFBIG: return DRWAV_TOO_BIG; + #endif + #ifdef ENOSPC + case ENOSPC: return DRWAV_NO_SPACE; + #endif + #ifdef ESPIPE + case ESPIPE: return DRWAV_BAD_SEEK; + #endif + #ifdef EROFS + case EROFS: return DRWAV_ACCESS_DENIED; + #endif + #ifdef EMLINK + case EMLINK: return DRWAV_TOO_MANY_LINKS; + #endif + #ifdef EPIPE + case EPIPE: return DRWAV_BAD_PIPE; + #endif + #ifdef EDOM + case EDOM: return DRWAV_OUT_OF_RANGE; + #endif + #ifdef ERANGE + case ERANGE: return DRWAV_OUT_OF_RANGE; + #endif + #ifdef EDEADLK + case EDEADLK: return DRWAV_DEADLOCK; + #endif + #ifdef ENAMETOOLONG + case ENAMETOOLONG: return DRWAV_PATH_TOO_LONG; + #endif + #ifdef ENOLCK + case ENOLCK: return DRWAV_ERROR; + #endif + #ifdef ENOSYS + case ENOSYS: return DRWAV_NOT_IMPLEMENTED; + #endif + #if defined(ENOTEMPTY) && ENOTEMPTY != EEXIST /* In AIX, ENOTEMPTY and EEXIST use the same value. */ + case ENOTEMPTY: return DRWAV_DIRECTORY_NOT_EMPTY; + #endif + #ifdef ELOOP + case ELOOP: return DRWAV_TOO_MANY_LINKS; + #endif + #ifdef ENOMSG + case ENOMSG: return DRWAV_NO_MESSAGE; + #endif + #ifdef EIDRM + case EIDRM: return DRWAV_ERROR; + #endif + #ifdef ECHRNG + case ECHRNG: return DRWAV_ERROR; + #endif + #ifdef EL2NSYNC + case EL2NSYNC: return DRWAV_ERROR; + #endif + #ifdef EL3HLT + case EL3HLT: return DRWAV_ERROR; + #endif + #ifdef EL3RST + case EL3RST: return DRWAV_ERROR; + #endif + #ifdef ELNRNG + case ELNRNG: return DRWAV_OUT_OF_RANGE; + #endif + #ifdef EUNATCH + case EUNATCH: return DRWAV_ERROR; + #endif + #ifdef ENOCSI + case ENOCSI: return DRWAV_ERROR; + #endif + #ifdef EL2HLT + case EL2HLT: return DRWAV_ERROR; + #endif + #ifdef EBADE + case EBADE: return DRWAV_ERROR; + #endif + #ifdef EBADR + case EBADR: return DRWAV_ERROR; + #endif + #ifdef EXFULL + case EXFULL: return DRWAV_ERROR; + #endif + #ifdef ENOANO + case ENOANO: return DRWAV_ERROR; + #endif + #ifdef EBADRQC + case EBADRQC: return DRWAV_ERROR; + #endif + #ifdef EBADSLT + case EBADSLT: return DRWAV_ERROR; + #endif + #ifdef EBFONT + case EBFONT: return DRWAV_INVALID_FILE; + #endif + #ifdef ENOSTR + case ENOSTR: return DRWAV_ERROR; + #endif + #ifdef ENODATA + case ENODATA: return DRWAV_NO_DATA_AVAILABLE; + #endif + #ifdef ETIME + case ETIME: return DRWAV_TIMEOUT; + #endif + #ifdef ENOSR + case ENOSR: return DRWAV_NO_DATA_AVAILABLE; + #endif + #ifdef ENONET + case ENONET: return DRWAV_NO_NETWORK; + #endif + #ifdef ENOPKG + case ENOPKG: return DRWAV_ERROR; + #endif + #ifdef EREMOTE + case EREMOTE: return DRWAV_ERROR; + #endif + #ifdef ENOLINK + case ENOLINK: return DRWAV_ERROR; + #endif + #ifdef EADV + case EADV: return DRWAV_ERROR; + #endif + #ifdef ESRMNT + case ESRMNT: return DRWAV_ERROR; + #endif + #ifdef ECOMM + case ECOMM: return DRWAV_ERROR; + #endif + #ifdef EPROTO + case EPROTO: return DRWAV_ERROR; + #endif + #ifdef EMULTIHOP + case EMULTIHOP: return DRWAV_ERROR; + #endif + #ifdef EDOTDOT + case EDOTDOT: return DRWAV_ERROR; + #endif + #ifdef EBADMSG + case EBADMSG: return DRWAV_BAD_MESSAGE; + #endif + #ifdef EOVERFLOW + case EOVERFLOW: return DRWAV_TOO_BIG; + #endif + #ifdef ENOTUNIQ + case ENOTUNIQ: return DRWAV_NOT_UNIQUE; + #endif + #ifdef EBADFD + case EBADFD: return DRWAV_ERROR; + #endif + #ifdef EREMCHG + case EREMCHG: return DRWAV_ERROR; + #endif + #ifdef ELIBACC + case ELIBACC: return DRWAV_ACCESS_DENIED; + #endif + #ifdef ELIBBAD + case ELIBBAD: return DRWAV_INVALID_FILE; + #endif + #ifdef ELIBSCN + case ELIBSCN: return DRWAV_INVALID_FILE; + #endif + #ifdef ELIBMAX + case ELIBMAX: return DRWAV_ERROR; + #endif + #ifdef ELIBEXEC + case ELIBEXEC: return DRWAV_ERROR; + #endif + #ifdef EILSEQ + case EILSEQ: return DRWAV_INVALID_DATA; + #endif + #ifdef ERESTART + case ERESTART: return DRWAV_ERROR; + #endif + #ifdef ESTRPIPE + case ESTRPIPE: return DRWAV_ERROR; + #endif + #ifdef EUSERS + case EUSERS: return DRWAV_ERROR; + #endif + #ifdef ENOTSOCK + case ENOTSOCK: return DRWAV_NOT_SOCKET; + #endif + #ifdef EDESTADDRREQ + case EDESTADDRREQ: return DRWAV_NO_ADDRESS; + #endif + #ifdef EMSGSIZE + case EMSGSIZE: return DRWAV_TOO_BIG; + #endif + #ifdef EPROTOTYPE + case EPROTOTYPE: return DRWAV_BAD_PROTOCOL; + #endif + #ifdef ENOPROTOOPT + case ENOPROTOOPT: return DRWAV_PROTOCOL_UNAVAILABLE; + #endif + #ifdef EPROTONOSUPPORT + case EPROTONOSUPPORT: return DRWAV_PROTOCOL_NOT_SUPPORTED; + #endif + #ifdef ESOCKTNOSUPPORT + case ESOCKTNOSUPPORT: return DRWAV_SOCKET_NOT_SUPPORTED; + #endif + #ifdef EOPNOTSUPP + case EOPNOTSUPP: return DRWAV_INVALID_OPERATION; + #endif + #ifdef EPFNOSUPPORT + case EPFNOSUPPORT: return DRWAV_PROTOCOL_FAMILY_NOT_SUPPORTED; + #endif + #ifdef EAFNOSUPPORT + case EAFNOSUPPORT: return DRWAV_ADDRESS_FAMILY_NOT_SUPPORTED; + #endif + #ifdef EADDRINUSE + case EADDRINUSE: return DRWAV_ALREADY_IN_USE; + #endif + #ifdef EADDRNOTAVAIL + case EADDRNOTAVAIL: return DRWAV_ERROR; + #endif + #ifdef ENETDOWN + case ENETDOWN: return DRWAV_NO_NETWORK; + #endif + #ifdef ENETUNREACH + case ENETUNREACH: return DRWAV_NO_NETWORK; + #endif + #ifdef ENETRESET + case ENETRESET: return DRWAV_NO_NETWORK; + #endif + #ifdef ECONNABORTED + case ECONNABORTED: return DRWAV_NO_NETWORK; + #endif + #ifdef ECONNRESET + case ECONNRESET: return DRWAV_CONNECTION_RESET; + #endif + #ifdef ENOBUFS + case ENOBUFS: return DRWAV_NO_SPACE; + #endif + #ifdef EISCONN + case EISCONN: return DRWAV_ALREADY_CONNECTED; + #endif + #ifdef ENOTCONN + case ENOTCONN: return DRWAV_NOT_CONNECTED; + #endif + #ifdef ESHUTDOWN + case ESHUTDOWN: return DRWAV_ERROR; + #endif + #ifdef ETOOMANYREFS + case ETOOMANYREFS: return DRWAV_ERROR; + #endif + #ifdef ETIMEDOUT + case ETIMEDOUT: return DRWAV_TIMEOUT; + #endif + #ifdef ECONNREFUSED + case ECONNREFUSED: return DRWAV_CONNECTION_REFUSED; + #endif + #ifdef EHOSTDOWN + case EHOSTDOWN: return DRWAV_NO_HOST; + #endif + #ifdef EHOSTUNREACH + case EHOSTUNREACH: return DRWAV_NO_HOST; + #endif + #ifdef EALREADY + case EALREADY: return DRWAV_IN_PROGRESS; + #endif + #ifdef EINPROGRESS + case EINPROGRESS: return DRWAV_IN_PROGRESS; + #endif + #ifdef ESTALE + case ESTALE: return DRWAV_INVALID_FILE; + #endif + #ifdef EUCLEAN + case EUCLEAN: return DRWAV_ERROR; + #endif + #ifdef ENOTNAM + case ENOTNAM: return DRWAV_ERROR; + #endif + #ifdef ENAVAIL + case ENAVAIL: return DRWAV_ERROR; + #endif + #ifdef EISNAM + case EISNAM: return DRWAV_ERROR; + #endif + #ifdef EREMOTEIO + case EREMOTEIO: return DRWAV_IO_ERROR; + #endif + #ifdef EDQUOT + case EDQUOT: return DRWAV_NO_SPACE; + #endif + #ifdef ENOMEDIUM + case ENOMEDIUM: return DRWAV_DOES_NOT_EXIST; + #endif + #ifdef EMEDIUMTYPE + case EMEDIUMTYPE: return DRWAV_ERROR; + #endif + #ifdef ECANCELED + case ECANCELED: return DRWAV_CANCELLED; + #endif + #ifdef ENOKEY + case ENOKEY: return DRWAV_ERROR; + #endif + #ifdef EKEYEXPIRED + case EKEYEXPIRED: return DRWAV_ERROR; + #endif + #ifdef EKEYREVOKED + case EKEYREVOKED: return DRWAV_ERROR; + #endif + #ifdef EKEYREJECTED + case EKEYREJECTED: return DRWAV_ERROR; + #endif + #ifdef EOWNERDEAD + case EOWNERDEAD: return DRWAV_ERROR; + #endif + #ifdef ENOTRECOVERABLE + case ENOTRECOVERABLE: return DRWAV_ERROR; + #endif + #ifdef ERFKILL + case ERFKILL: return DRWAV_ERROR; + #endif + #ifdef EHWPOISON + case EHWPOISON: return DRWAV_ERROR; + #endif + default: return DRWAV_ERROR; + } +} +/* End Errno */ + +/* fopen */ +DRWAV_PRIVATE drwav_result drwav_fopen(FILE** ppFile, const char* pFilePath, const char* pOpenMode) +{ +#if defined(_MSC_VER) && _MSC_VER >= 1400 + errno_t err; +#endif + + if (ppFile != NULL) { + *ppFile = NULL; /* Safety. */ + } + + if (pFilePath == NULL || pOpenMode == NULL || ppFile == NULL) { + return DRWAV_INVALID_ARGS; + } + +#if defined(_MSC_VER) && _MSC_VER >= 1400 + err = fopen_s(ppFile, pFilePath, pOpenMode); + if (err != 0) { + return drwav_result_from_errno(err); + } +#else +#if defined(_WIN32) || defined(__APPLE__) + *ppFile = fopen(pFilePath, pOpenMode); +#else + #if defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS == 64 && defined(_LARGEFILE64_SOURCE) + *ppFile = fopen64(pFilePath, pOpenMode); + #else + *ppFile = fopen(pFilePath, pOpenMode); + #endif +#endif + if (*ppFile == NULL) { + drwav_result result = drwav_result_from_errno(errno); + if (result == DRWAV_SUCCESS) { + result = DRWAV_ERROR; /* Just a safety check to make sure we never ever return success when pFile == NULL. */ + } + + return result; + } +#endif + + return DRWAV_SUCCESS; +} + +/* +_wfopen() isn't always available in all compilation environments. + + * Windows only. + * MSVC seems to support it universally as far back as VC6 from what I can tell (haven't checked further back). + * MinGW-64 (both 32- and 64-bit) seems to support it. + * MinGW wraps it in !defined(__STRICT_ANSI__). + * OpenWatcom wraps it in !defined(_NO_EXT_KEYS). + +This can be reviewed as compatibility issues arise. The preference is to use _wfopen_s() and _wfopen() as opposed to the wcsrtombs() +fallback, so if you notice your compiler not detecting this properly I'm happy to look at adding support. +*/ +#if defined(_WIN32) + #if defined(_MSC_VER) || defined(__MINGW64__) || (!defined(__STRICT_ANSI__) && !defined(_NO_EXT_KEYS)) + #define DRWAV_HAS_WFOPEN + #endif +#endif + +#ifndef DR_WAV_NO_WCHAR +DRWAV_PRIVATE drwav_result drwav_wfopen(FILE** ppFile, const wchar_t* pFilePath, const wchar_t* pOpenMode, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (ppFile != NULL) { + *ppFile = NULL; /* Safety. */ + } + + if (pFilePath == NULL || pOpenMode == NULL || ppFile == NULL) { + return DRWAV_INVALID_ARGS; + } + +#if defined(DRWAV_HAS_WFOPEN) + { + /* Use _wfopen() on Windows. */ + #if defined(_MSC_VER) && _MSC_VER >= 1400 + errno_t err = _wfopen_s(ppFile, pFilePath, pOpenMode); + if (err != 0) { + return drwav_result_from_errno(err); + } + #else + *ppFile = _wfopen(pFilePath, pOpenMode); + if (*ppFile == NULL) { + return drwav_result_from_errno(errno); + } + #endif + (void)pAllocationCallbacks; + } +#else + /* + Use fopen() on anything other than Windows. Requires a conversion. This is annoying because + fopen() is locale specific. The only real way I can think of to do this is with wcsrtombs(). Note + that wcstombs() is apparently not thread-safe because it uses a static global mbstate_t object for + maintaining state. I've checked this with -std=c89 and it works, but if somebody get's a compiler + error I'll look into improving compatibility. + */ + + /* + Some compilers don't support wchar_t or wcsrtombs() which we're using below. In this case we just + need to abort with an error. If you encounter a compiler lacking such support, add it to this list + and submit a bug report and it'll be added to the library upstream. + */ + #if defined(__DJGPP__) + { + /* Nothing to do here. This will fall through to the error check below. */ + } + #else + { + mbstate_t mbs; + size_t lenMB; + const wchar_t* pFilePathTemp = pFilePath; + char* pFilePathMB = NULL; + char pOpenModeMB[32] = {0}; + + /* Get the length first. */ + DRWAV_ZERO_OBJECT(&mbs); + lenMB = wcsrtombs(NULL, &pFilePathTemp, 0, &mbs); + if (lenMB == (size_t)-1) { + return drwav_result_from_errno(errno); + } + + pFilePathMB = (char*)drwav__malloc_from_callbacks(lenMB + 1, pAllocationCallbacks); + if (pFilePathMB == NULL) { + return DRWAV_OUT_OF_MEMORY; + } + + pFilePathTemp = pFilePath; + DRWAV_ZERO_OBJECT(&mbs); + wcsrtombs(pFilePathMB, &pFilePathTemp, lenMB + 1, &mbs); + + /* The open mode should always consist of ASCII characters so we should be able to do a trivial conversion. */ + { + size_t i = 0; + for (;;) { + if (pOpenMode[i] == 0) { + pOpenModeMB[i] = '\0'; + break; + } + + pOpenModeMB[i] = (char)pOpenMode[i]; + i += 1; + } + } + + *ppFile = fopen(pFilePathMB, pOpenModeMB); + + drwav__free_from_callbacks(pFilePathMB, pAllocationCallbacks); + } + #endif + + if (*ppFile == NULL) { + return DRWAV_ERROR; + } +#endif + + return DRWAV_SUCCESS; +} +#endif +/* End fopen */ + + +DRWAV_PRIVATE size_t drwav__on_read_stdio(void* pUserData, void* pBufferOut, size_t bytesToRead) +{ + return fread(pBufferOut, 1, bytesToRead, (FILE*)pUserData); +} + +DRWAV_PRIVATE size_t drwav__on_write_stdio(void* pUserData, const void* pData, size_t bytesToWrite) +{ + return fwrite(pData, 1, bytesToWrite, (FILE*)pUserData); +} + +DRWAV_PRIVATE drwav_bool32 drwav__on_seek_stdio(void* pUserData, int offset, drwav_seek_origin origin) +{ + int whence = SEEK_SET; + if (origin == DRWAV_SEEK_CUR) { + whence = SEEK_CUR; + } else if (origin == DRWAV_SEEK_END) { + whence = SEEK_END; + } + + return fseek((FILE*)pUserData, offset, whence) == 0; +} + +DRWAV_PRIVATE drwav_bool32 drwav__on_tell_stdio(void* pUserData, drwav_int64* pCursor) +{ + FILE* pFileStdio = (FILE*)pUserData; + drwav_int64 result; + + /* These were all validated at a higher level. */ + DRWAV_ASSERT(pFileStdio != NULL); + DRWAV_ASSERT(pCursor != NULL); + +#if defined(_WIN32) && !defined(NXDK) + #if defined(_MSC_VER) && _MSC_VER > 1200 + result = _ftelli64(pFileStdio); + #else + result = ftell(pFileStdio); + #endif +#else + result = ftell(pFileStdio); +#endif + + *pCursor = result; + + return DRWAV_TRUE; +} + +DRWAV_API drwav_bool32 drwav_init_file(drwav* pWav, const char* filename, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_file_ex(pWav, filename, NULL, NULL, 0, pAllocationCallbacks); +} + + +DRWAV_PRIVATE drwav_bool32 drwav_init_file__internal_FILE(drwav* pWav, FILE* pFile, drwav_chunk_proc onChunk, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav_bool32 result; + + result = drwav_preinit(pWav, drwav__on_read_stdio, drwav__on_seek_stdio, drwav__on_tell_stdio, (void*)pFile, pAllocationCallbacks); + if (result != DRWAV_TRUE) { + fclose(pFile); + return result; + } + + result = drwav_init__internal(pWav, onChunk, pChunkUserData, flags); + if (result != DRWAV_TRUE) { + fclose(pFile); + return result; + } + + return DRWAV_TRUE; +} + +DRWAV_API drwav_bool32 drwav_init_file_ex(drwav* pWav, const char* filename, drwav_chunk_proc onChunk, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + FILE* pFile; + if (drwav_fopen(&pFile, filename, "rb") != DRWAV_SUCCESS) { + return DRWAV_FALSE; + } + + /* This takes ownership of the FILE* object. */ + return drwav_init_file__internal_FILE(pWav, pFile, onChunk, pChunkUserData, flags, pAllocationCallbacks); +} + +#ifndef DR_WAV_NO_WCHAR +DRWAV_API drwav_bool32 drwav_init_file_w(drwav* pWav, const wchar_t* filename, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_file_ex_w(pWav, filename, NULL, NULL, 0, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_file_ex_w(drwav* pWav, const wchar_t* filename, drwav_chunk_proc onChunk, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + FILE* pFile; + if (drwav_wfopen(&pFile, filename, L"rb", pAllocationCallbacks) != DRWAV_SUCCESS) { + return DRWAV_FALSE; + } + + /* This takes ownership of the FILE* object. */ + return drwav_init_file__internal_FILE(pWav, pFile, onChunk, pChunkUserData, flags, pAllocationCallbacks); +} +#endif + +DRWAV_API drwav_bool32 drwav_init_file_with_metadata(drwav* pWav, const char* filename, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + FILE* pFile; + if (drwav_fopen(&pFile, filename, "rb") != DRWAV_SUCCESS) { + return DRWAV_FALSE; + } + + /* This takes ownership of the FILE* object. */ + return drwav_init_file__internal_FILE(pWav, pFile, NULL, NULL, flags | DRWAV_WITH_METADATA, pAllocationCallbacks); +} + +#ifndef DR_WAV_NO_WCHAR +DRWAV_API drwav_bool32 drwav_init_file_with_metadata_w(drwav* pWav, const wchar_t* filename, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + FILE* pFile; + if (drwav_wfopen(&pFile, filename, L"rb", pAllocationCallbacks) != DRWAV_SUCCESS) { + return DRWAV_FALSE; + } + + /* This takes ownership of the FILE* object. */ + return drwav_init_file__internal_FILE(pWav, pFile, NULL, NULL, flags | DRWAV_WITH_METADATA, pAllocationCallbacks); +} +#endif + + +DRWAV_PRIVATE drwav_bool32 drwav_init_file_write__internal_FILE(drwav* pWav, FILE* pFile, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, drwav_bool32 isSequential, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav_bool32 result; + + result = drwav_preinit_write(pWav, pFormat, isSequential, drwav__on_write_stdio, drwav__on_seek_stdio, (void*)pFile, pAllocationCallbacks); + if (result != DRWAV_TRUE) { + fclose(pFile); + return result; + } + + result = drwav_init_write__internal(pWav, pFormat, totalSampleCount); + if (result != DRWAV_TRUE) { + fclose(pFile); + return result; + } + + return DRWAV_TRUE; +} + +DRWAV_PRIVATE drwav_bool32 drwav_init_file_write__internal(drwav* pWav, const char* filename, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, drwav_bool32 isSequential, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + FILE* pFile; + if (drwav_fopen(&pFile, filename, "wb") != DRWAV_SUCCESS) { + return DRWAV_FALSE; + } + + /* This takes ownership of the FILE* object. */ + return drwav_init_file_write__internal_FILE(pWav, pFile, pFormat, totalSampleCount, isSequential, pAllocationCallbacks); +} + +#ifndef DR_WAV_NO_WCHAR +DRWAV_PRIVATE drwav_bool32 drwav_init_file_write_w__internal(drwav* pWav, const wchar_t* filename, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, drwav_bool32 isSequential, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + FILE* pFile; + if (drwav_wfopen(&pFile, filename, L"wb", pAllocationCallbacks) != DRWAV_SUCCESS) { + return DRWAV_FALSE; + } + + /* This takes ownership of the FILE* object. */ + return drwav_init_file_write__internal_FILE(pWav, pFile, pFormat, totalSampleCount, isSequential, pAllocationCallbacks); +} +#endif + +DRWAV_API drwav_bool32 drwav_init_file_write(drwav* pWav, const char* filename, const drwav_data_format* pFormat, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_file_write__internal(pWav, filename, pFormat, 0, DRWAV_FALSE, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_file_write_sequential(drwav* pWav, const char* filename, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_file_write__internal(pWav, filename, pFormat, totalSampleCount, DRWAV_TRUE, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_file_write_sequential_pcm_frames(drwav* pWav, const char* filename, const drwav_data_format* pFormat, drwav_uint64 totalPCMFrameCount, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pFormat == NULL) { + return DRWAV_FALSE; + } + + return drwav_init_file_write_sequential(pWav, filename, pFormat, totalPCMFrameCount*pFormat->channels, pAllocationCallbacks); +} + +#ifndef DR_WAV_NO_WCHAR +DRWAV_API drwav_bool32 drwav_init_file_write_w(drwav* pWav, const wchar_t* filename, const drwav_data_format* pFormat, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_file_write_w__internal(pWav, filename, pFormat, 0, DRWAV_FALSE, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_file_write_sequential_w(drwav* pWav, const wchar_t* filename, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_file_write_w__internal(pWav, filename, pFormat, totalSampleCount, DRWAV_TRUE, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_file_write_sequential_pcm_frames_w(drwav* pWav, const wchar_t* filename, const drwav_data_format* pFormat, drwav_uint64 totalPCMFrameCount, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pFormat == NULL) { + return DRWAV_FALSE; + } + + return drwav_init_file_write_sequential_w(pWav, filename, pFormat, totalPCMFrameCount*pFormat->channels, pAllocationCallbacks); +} +#endif +#endif /* DR_WAV_NO_STDIO */ + + +DRWAV_PRIVATE size_t drwav__on_read_memory(void* pUserData, void* pBufferOut, size_t bytesToRead) +{ + drwav* pWav = (drwav*)pUserData; + size_t bytesRemaining; + + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pWav->memoryStream.dataSize >= pWav->memoryStream.currentReadPos); + + bytesRemaining = pWav->memoryStream.dataSize - pWav->memoryStream.currentReadPos; + if (bytesToRead > bytesRemaining) { + bytesToRead = bytesRemaining; + } + + if (bytesToRead > 0) { + DRWAV_COPY_MEMORY(pBufferOut, pWav->memoryStream.data + pWav->memoryStream.currentReadPos, bytesToRead); + pWav->memoryStream.currentReadPos += bytesToRead; + } + + return bytesToRead; +} + +DRWAV_PRIVATE drwav_bool32 drwav__on_seek_memory(void* pUserData, int offset, drwav_seek_origin origin) +{ + drwav* pWav = (drwav*)pUserData; + drwav_int64 newCursor; + + DRWAV_ASSERT(pWav != NULL); + + if (origin == DRWAV_SEEK_SET) { + newCursor = 0; + } else if (origin == DRWAV_SEEK_CUR) { + newCursor = (drwav_int64)pWav->memoryStream.currentReadPos; + } else if (origin == DRWAV_SEEK_END) { + newCursor = (drwav_int64)pWav->memoryStream.dataSize; + } else { + DRWAV_ASSERT(!"Invalid seek origin"); + return DRWAV_FALSE; + } + + newCursor += offset; + + if (newCursor < 0) { + return DRWAV_FALSE; /* Trying to seek prior to the start of the buffer. */ + } + if ((size_t)newCursor > pWav->memoryStream.dataSize) { + return DRWAV_FALSE; /* Trying to seek beyond the end of the buffer. */ + } + + pWav->memoryStream.currentReadPos = (size_t)newCursor; + + return DRWAV_TRUE; +} + +DRWAV_PRIVATE size_t drwav__on_write_memory(void* pUserData, const void* pDataIn, size_t bytesToWrite) +{ + drwav* pWav = (drwav*)pUserData; + size_t bytesRemaining; + + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pWav->memoryStreamWrite.dataCapacity >= pWav->memoryStreamWrite.currentWritePos); + + bytesRemaining = pWav->memoryStreamWrite.dataCapacity - pWav->memoryStreamWrite.currentWritePos; + if (bytesRemaining < bytesToWrite) { + /* Need to reallocate. */ + void* pNewData; + size_t newDataCapacity = (pWav->memoryStreamWrite.dataCapacity == 0) ? 256 : pWav->memoryStreamWrite.dataCapacity * 2; + + /* If doubling wasn't enough, just make it the minimum required size to write the data. */ + if ((newDataCapacity - pWav->memoryStreamWrite.currentWritePos) < bytesToWrite) { + newDataCapacity = pWav->memoryStreamWrite.currentWritePos + bytesToWrite; + } + + pNewData = drwav__realloc_from_callbacks(*pWav->memoryStreamWrite.ppData, newDataCapacity, pWav->memoryStreamWrite.dataCapacity, &pWav->allocationCallbacks); + if (pNewData == NULL) { + return 0; + } + + *pWav->memoryStreamWrite.ppData = pNewData; + pWav->memoryStreamWrite.dataCapacity = newDataCapacity; + } + + DRWAV_COPY_MEMORY(((drwav_uint8*)(*pWav->memoryStreamWrite.ppData)) + pWav->memoryStreamWrite.currentWritePos, pDataIn, bytesToWrite); + + pWav->memoryStreamWrite.currentWritePos += bytesToWrite; + if (pWav->memoryStreamWrite.dataSize < pWav->memoryStreamWrite.currentWritePos) { + pWav->memoryStreamWrite.dataSize = pWav->memoryStreamWrite.currentWritePos; + } + + *pWav->memoryStreamWrite.pDataSize = pWav->memoryStreamWrite.dataSize; + + return bytesToWrite; +} + +DRWAV_PRIVATE drwav_bool32 drwav__on_seek_memory_write(void* pUserData, int offset, drwav_seek_origin origin) +{ + drwav* pWav = (drwav*)pUserData; + drwav_int64 newCursor; + + DRWAV_ASSERT(pWav != NULL); + + if (origin == DRWAV_SEEK_SET) { + newCursor = 0; + } else if (origin == DRWAV_SEEK_CUR) { + newCursor = (drwav_int64)pWav->memoryStreamWrite.currentWritePos; + } else if (origin == DRWAV_SEEK_END) { + newCursor = (drwav_int64)pWav->memoryStreamWrite.dataSize; + } else { + DRWAV_ASSERT(!"Invalid seek origin"); + return DRWAV_FALSE; + } + + newCursor += offset; + + if (newCursor < 0) { + return DRWAV_FALSE; /* Trying to seek prior to the start of the buffer. */ + } + if ((size_t)newCursor > pWav->memoryStreamWrite.dataSize) { + return DRWAV_FALSE; /* Trying to seek beyond the end of the buffer. */ + } + + pWav->memoryStreamWrite.currentWritePos = (size_t)newCursor; + + return DRWAV_TRUE; +} + +DRWAV_PRIVATE drwav_bool32 drwav__on_tell_memory(void* pUserData, drwav_int64* pCursor) +{ + drwav* pWav = (drwav*)pUserData; + + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(pCursor != NULL); + + *pCursor = (drwav_int64)pWav->memoryStream.currentReadPos; + return DRWAV_TRUE; +} + +DRWAV_API drwav_bool32 drwav_init_memory(drwav* pWav, const void* data, size_t dataSize, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_memory_ex(pWav, data, dataSize, NULL, NULL, 0, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_memory_ex(drwav* pWav, const void* data, size_t dataSize, drwav_chunk_proc onChunk, void* pChunkUserData, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (data == NULL || dataSize == 0) { + return DRWAV_FALSE; + } + + if (!drwav_preinit(pWav, drwav__on_read_memory, drwav__on_seek_memory, drwav__on_tell_memory, pWav, pAllocationCallbacks)) { + return DRWAV_FALSE; + } + + pWav->memoryStream.data = (const drwav_uint8*)data; + pWav->memoryStream.dataSize = dataSize; + pWav->memoryStream.currentReadPos = 0; + + return drwav_init__internal(pWav, onChunk, pChunkUserData, flags); +} + +DRWAV_API drwav_bool32 drwav_init_memory_with_metadata(drwav* pWav, const void* data, size_t dataSize, drwav_uint32 flags, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (data == NULL || dataSize == 0) { + return DRWAV_FALSE; + } + + if (!drwav_preinit(pWav, drwav__on_read_memory, drwav__on_seek_memory, drwav__on_tell_memory, pWav, pAllocationCallbacks)) { + return DRWAV_FALSE; + } + + pWav->memoryStream.data = (const drwav_uint8*)data; + pWav->memoryStream.dataSize = dataSize; + pWav->memoryStream.currentReadPos = 0; + + return drwav_init__internal(pWav, NULL, NULL, flags | DRWAV_WITH_METADATA); +} + + +DRWAV_PRIVATE drwav_bool32 drwav_init_memory_write__internal(drwav* pWav, void** ppData, size_t* pDataSize, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, drwav_bool32 isSequential, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (ppData == NULL || pDataSize == NULL) { + return DRWAV_FALSE; + } + + *ppData = NULL; /* Important because we're using realloc()! */ + *pDataSize = 0; + + if (!drwav_preinit_write(pWav, pFormat, isSequential, drwav__on_write_memory, drwav__on_seek_memory_write, pWav, pAllocationCallbacks)) { + return DRWAV_FALSE; + } + + pWav->memoryStreamWrite.ppData = ppData; + pWav->memoryStreamWrite.pDataSize = pDataSize; + pWav->memoryStreamWrite.dataSize = 0; + pWav->memoryStreamWrite.dataCapacity = 0; + pWav->memoryStreamWrite.currentWritePos = 0; + + return drwav_init_write__internal(pWav, pFormat, totalSampleCount); +} + +DRWAV_API drwav_bool32 drwav_init_memory_write(drwav* pWav, void** ppData, size_t* pDataSize, const drwav_data_format* pFormat, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_memory_write__internal(pWav, ppData, pDataSize, pFormat, 0, DRWAV_FALSE, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_memory_write_sequential(drwav* pWav, void** ppData, size_t* pDataSize, const drwav_data_format* pFormat, drwav_uint64 totalSampleCount, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + return drwav_init_memory_write__internal(pWav, ppData, pDataSize, pFormat, totalSampleCount, DRWAV_TRUE, pAllocationCallbacks); +} + +DRWAV_API drwav_bool32 drwav_init_memory_write_sequential_pcm_frames(drwav* pWav, void** ppData, size_t* pDataSize, const drwav_data_format* pFormat, drwav_uint64 totalPCMFrameCount, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pFormat == NULL) { + return DRWAV_FALSE; + } + + return drwav_init_memory_write_sequential(pWav, ppData, pDataSize, pFormat, totalPCMFrameCount*pFormat->channels, pAllocationCallbacks); +} + + + +DRWAV_API drwav_result drwav_uninit(drwav* pWav) +{ + drwav_result result = DRWAV_SUCCESS; + + if (pWav == NULL) { + return DRWAV_INVALID_ARGS; + } + + /* + If the drwav object was opened in write mode we'll need to finalize a few things: + - Make sure the "data" chunk is aligned to 16-bits for RIFF containers, or 64 bits for W64 containers. + - Set the size of the "data" chunk. + */ + if (pWav->onWrite != NULL) { + drwav_uint32 paddingSize = 0; + + /* Padding. Do not adjust pWav->dataChunkDataSize - this should not include the padding. */ + if (pWav->container == drwav_container_riff || pWav->container == drwav_container_rf64) { + paddingSize = drwav__chunk_padding_size_riff(pWav->dataChunkDataSize); + } else { + paddingSize = drwav__chunk_padding_size_w64(pWav->dataChunkDataSize); + } + + if (paddingSize > 0) { + drwav_uint64 paddingData = 0; + drwav__write(pWav, &paddingData, paddingSize); /* Byte order does not matter for this. */ + } + + /* + Chunk sizes. When using sequential mode, these will have been filled in at initialization time. We only need + to do this when using non-sequential mode. + */ + if (pWav->onSeek && !pWav->isSequentialWrite) { + if (pWav->container == drwav_container_riff) { + /* The "RIFF" chunk size. */ + if (pWav->onSeek(pWav->pUserData, 4, DRWAV_SEEK_SET)) { + drwav_uint32 riffChunkSize = drwav__riff_chunk_size_riff(pWav->dataChunkDataSize, pWav->pMetadata, pWav->metadataCount); + drwav__write_u32ne_to_le(pWav, riffChunkSize); + } + + /* The "data" chunk size. */ + if (pWav->onSeek(pWav->pUserData, (int)pWav->dataChunkDataPos - 4, DRWAV_SEEK_SET)) { + drwav_uint32 dataChunkSize = drwav__data_chunk_size_riff(pWav->dataChunkDataSize); + drwav__write_u32ne_to_le(pWav, dataChunkSize); + } + } else if (pWav->container == drwav_container_w64) { + /* The "RIFF" chunk size. */ + if (pWav->onSeek(pWav->pUserData, 16, DRWAV_SEEK_SET)) { + drwav_uint64 riffChunkSize = drwav__riff_chunk_size_w64(pWav->dataChunkDataSize); + drwav__write_u64ne_to_le(pWav, riffChunkSize); + } + + /* The "data" chunk size. */ + if (pWav->onSeek(pWav->pUserData, (int)pWav->dataChunkDataPos - 8, DRWAV_SEEK_SET)) { + drwav_uint64 dataChunkSize = drwav__data_chunk_size_w64(pWav->dataChunkDataSize); + drwav__write_u64ne_to_le(pWav, dataChunkSize); + } + } else if (pWav->container == drwav_container_rf64) { + /* We only need to update the ds64 chunk. The "RIFF" and "data" chunks always have their sizes set to 0xFFFFFFFF for RF64. */ + int ds64BodyPos = 12 + 8; + + /* The "RIFF" chunk size. */ + if (pWav->onSeek(pWav->pUserData, ds64BodyPos + 0, DRWAV_SEEK_SET)) { + drwav_uint64 riffChunkSize = drwav__riff_chunk_size_rf64(pWav->dataChunkDataSize, pWav->pMetadata, pWav->metadataCount); + drwav__write_u64ne_to_le(pWav, riffChunkSize); + } + + /* The "data" chunk size. */ + if (pWav->onSeek(pWav->pUserData, ds64BodyPos + 8, DRWAV_SEEK_SET)) { + drwav_uint64 dataChunkSize = drwav__data_chunk_size_rf64(pWav->dataChunkDataSize); + drwav__write_u64ne_to_le(pWav, dataChunkSize); + } + } + } + + /* Validation for sequential mode. */ + if (pWav->isSequentialWrite) { + if (pWav->dataChunkDataSize != pWav->dataChunkDataSizeTargetWrite) { + result = DRWAV_INVALID_FILE; + } + } + } else { + drwav_free(pWav->pMetadata, &pWav->allocationCallbacks); + } + +#ifndef DR_WAV_NO_STDIO + /* + If we opened the file with drwav_open_file() we will want to close the file handle. We can know whether or not drwav_open_file() + was used by looking at the onRead and onSeek callbacks. + */ + if (pWav->onRead == drwav__on_read_stdio || pWav->onWrite == drwav__on_write_stdio) { + fclose((FILE*)pWav->pUserData); + } +#endif + + return result; +} + + + +DRWAV_API size_t drwav_read_raw(drwav* pWav, size_t bytesToRead, void* pBufferOut) +{ + size_t bytesRead; + drwav_uint32 bytesPerFrame; + + if (pWav == NULL || bytesToRead == 0) { + return 0; /* Invalid args. */ + } + + if (bytesToRead > pWav->bytesRemaining) { + bytesToRead = (size_t)pWav->bytesRemaining; + } + + if (bytesToRead == 0) { + return 0; /* At end. */ + } + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; /* Could not determine the bytes per frame. */ + } + + if (pBufferOut != NULL) { + bytesRead = pWav->onRead(pWav->pUserData, pBufferOut, bytesToRead); + } else { + /* We need to seek. If we fail, we need to read-and-discard to make sure we get a good byte count. */ + bytesRead = 0; + while (bytesRead < bytesToRead) { + size_t bytesToSeek = (bytesToRead - bytesRead); + if (bytesToSeek > 0x7FFFFFFF) { + bytesToSeek = 0x7FFFFFFF; + } + + if (pWav->onSeek(pWav->pUserData, (int)bytesToSeek, DRWAV_SEEK_CUR) == DRWAV_FALSE) { + break; + } + + bytesRead += bytesToSeek; + } + + /* When we get here we may need to read-and-discard some data. */ + while (bytesRead < bytesToRead) { + drwav_uint8 buffer[4096]; + size_t bytesSeeked; + size_t bytesToSeek = (bytesToRead - bytesRead); + if (bytesToSeek > sizeof(buffer)) { + bytesToSeek = sizeof(buffer); + } + + bytesSeeked = pWav->onRead(pWav->pUserData, buffer, bytesToSeek); + bytesRead += bytesSeeked; + + if (bytesSeeked < bytesToSeek) { + break; /* Reached the end. */ + } + } + } + + pWav->readCursorInPCMFrames += bytesRead / bytesPerFrame; + + pWav->bytesRemaining -= bytesRead; + return bytesRead; +} + + + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_le(drwav* pWav, drwav_uint64 framesToRead, void* pBufferOut) +{ + drwav_uint32 bytesPerFrame; + drwav_uint64 bytesToRead; /* Intentionally uint64 instead of size_t so we can do a check that we're not reading too much on 32-bit builds. */ + drwav_uint64 framesRemainingInFile; + + if (pWav == NULL || framesToRead == 0) { + return 0; + } + + /* Cannot use this function for compressed formats. */ + if (drwav__is_compressed_format_tag(pWav->translatedFormatTag)) { + return 0; + } + + framesRemainingInFile = pWav->totalPCMFrameCount - pWav->readCursorInPCMFrames; + if (framesToRead > framesRemainingInFile) { + framesToRead = framesRemainingInFile; + } + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + /* Don't try to read more samples than can potentially fit in the output buffer. */ + bytesToRead = framesToRead * bytesPerFrame; + if (bytesToRead > DRWAV_SIZE_MAX) { + bytesToRead = (DRWAV_SIZE_MAX / bytesPerFrame) * bytesPerFrame; /* Round the number of bytes to read to a clean frame boundary. */ + } + + /* + Doing an explicit check here just to make it clear that we don't want to be attempt to read anything if there's no bytes to read. There + *could* be a time where it evaluates to 0 due to overflowing. + */ + if (bytesToRead == 0) { + return 0; + } + + return drwav_read_raw(pWav, (size_t)bytesToRead, pBufferOut) / bytesPerFrame; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_be(drwav* pWav, drwav_uint64 framesToRead, void* pBufferOut) +{ + drwav_uint64 framesRead = drwav_read_pcm_frames_le(pWav, framesToRead, pBufferOut); + + if (pBufferOut != NULL) { + drwav_uint32 bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; /* Could not get the bytes per frame which means bytes per sample cannot be determined and we don't know how to byte swap. */ + } + + drwav__bswap_samples(pBufferOut, framesRead*pWav->channels, bytesPerFrame/pWav->channels); + } + + return framesRead; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames(drwav* pWav, drwav_uint64 framesToRead, void* pBufferOut) +{ + drwav_uint64 framesRead = 0; + + if (drwav_is_container_be(pWav->container)) { + /* + Special case for AIFF. AIFF is a big-endian encoded format, but it supports a format that is + PCM in little-endian encoding. In this case, we fall through this branch and treate it as + little-endian. + */ + if (pWav->container != drwav_container_aiff || pWav->aiff.isLE == DRWAV_FALSE) { + if (drwav__is_little_endian()) { + framesRead = drwav_read_pcm_frames_be(pWav, framesToRead, pBufferOut); + } else { + framesRead = drwav_read_pcm_frames_le(pWav, framesToRead, pBufferOut); + } + + goto post_process; + } + } + + /* Getting here means the data should be considered little-endian. */ + if (drwav__is_little_endian()) { + framesRead = drwav_read_pcm_frames_le(pWav, framesToRead, pBufferOut); + } else { + framesRead = drwav_read_pcm_frames_be(pWav, framesToRead, pBufferOut); + } + + /* + Here is where we check if we need to do a signed/unsigned conversion for AIFF. The reason we need to do this + is because dr_wav always assumes an 8-bit sample is unsigned, whereas AIFF can have signed 8-bit formats. + */ + post_process: + { + if (pWav->container == drwav_container_aiff && pWav->bitsPerSample == 8 && pWav->aiff.isUnsigned == DRWAV_FALSE) { + if (pBufferOut != NULL) { + drwav_uint64 iSample; + + for (iSample = 0; iSample < framesRead * pWav->channels; iSample += 1) { + ((drwav_uint8*)pBufferOut)[iSample] += 128; + } + } + } + } + + return framesRead; +} + + + +DRWAV_PRIVATE drwav_bool32 drwav_seek_to_first_pcm_frame(drwav* pWav) +{ + if (pWav->onWrite != NULL) { + return DRWAV_FALSE; /* No seeking in write mode. */ + } + + if (!pWav->onSeek(pWav->pUserData, (int)pWav->dataChunkDataPos, DRWAV_SEEK_SET)) { + return DRWAV_FALSE; + } + + if (drwav__is_compressed_format_tag(pWav->translatedFormatTag)) { + /* Cached data needs to be cleared for compressed formats. */ + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM) { + DRWAV_ZERO_OBJECT(&pWav->msadpcm); + } else if (pWav->translatedFormatTag == DR_WAVE_FORMAT_DVI_ADPCM) { + DRWAV_ZERO_OBJECT(&pWav->ima); + } else { + DRWAV_ASSERT(DRWAV_FALSE); /* If this assertion is triggered it means I've implemented a new compressed format but forgot to add a branch for it here. */ + } + } + + pWav->readCursorInPCMFrames = 0; + pWav->bytesRemaining = pWav->dataChunkDataSize; + + return DRWAV_TRUE; +} + +DRWAV_API drwav_bool32 drwav_seek_to_pcm_frame(drwav* pWav, drwav_uint64 targetFrameIndex) +{ + /* Seeking should be compatible with wave files > 2GB. */ + + if (pWav == NULL || pWav->onSeek == NULL) { + return DRWAV_FALSE; + } + + /* No seeking in write mode. */ + if (pWav->onWrite != NULL) { + return DRWAV_FALSE; + } + + /* If there are no samples, just return DRWAV_TRUE without doing anything. */ + if (pWav->totalPCMFrameCount == 0) { + return DRWAV_TRUE; + } + + /* Make sure the sample is clamped. */ + if (targetFrameIndex > pWav->totalPCMFrameCount) { + targetFrameIndex = pWav->totalPCMFrameCount; + } + + /* + For compressed formats we just use a slow generic seek. If we are seeking forward we just seek forward. If we are going backwards we need + to seek back to the start. + */ + if (drwav__is_compressed_format_tag(pWav->translatedFormatTag)) { + /* TODO: This can be optimized. */ + + /* + If we're seeking forward it's simple - just keep reading samples until we hit the sample we're requesting. If we're seeking backwards, + we first need to seek back to the start and then just do the same thing as a forward seek. + */ + if (targetFrameIndex < pWav->readCursorInPCMFrames) { + if (!drwav_seek_to_first_pcm_frame(pWav)) { + return DRWAV_FALSE; + } + } + + if (targetFrameIndex > pWav->readCursorInPCMFrames) { + drwav_uint64 offsetInFrames = targetFrameIndex - pWav->readCursorInPCMFrames; + + drwav_int16 devnull[2048]; + while (offsetInFrames > 0) { + drwav_uint64 framesRead = 0; + drwav_uint64 framesToRead = offsetInFrames; + if (framesToRead > drwav_countof(devnull)/pWav->channels) { + framesToRead = drwav_countof(devnull)/pWav->channels; + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM) { + framesRead = drwav_read_pcm_frames_s16__msadpcm(pWav, framesToRead, devnull); + } else if (pWav->translatedFormatTag == DR_WAVE_FORMAT_DVI_ADPCM) { + framesRead = drwav_read_pcm_frames_s16__ima(pWav, framesToRead, devnull); + } else { + DRWAV_ASSERT(DRWAV_FALSE); /* If this assertion is triggered it means I've implemented a new compressed format but forgot to add a branch for it here. */ + } + + if (framesRead != framesToRead) { + return DRWAV_FALSE; + } + + offsetInFrames -= framesRead; + } + } + } else { + drwav_uint64 totalSizeInBytes; + drwav_uint64 currentBytePos; + drwav_uint64 targetBytePos; + drwav_uint64 offset; + drwav_uint32 bytesPerFrame; + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return DRWAV_FALSE; /* Not able to calculate offset. */ + } + + totalSizeInBytes = pWav->totalPCMFrameCount * bytesPerFrame; + /*DRWAV_ASSERT(totalSizeInBytes >= pWav->bytesRemaining);*/ + + currentBytePos = totalSizeInBytes - pWav->bytesRemaining; + targetBytePos = targetFrameIndex * bytesPerFrame; + + if (currentBytePos < targetBytePos) { + /* Offset forwards. */ + offset = (targetBytePos - currentBytePos); + } else { + /* Offset backwards. */ + if (!drwav_seek_to_first_pcm_frame(pWav)) { + return DRWAV_FALSE; + } + offset = targetBytePos; + } + + while (offset > 0) { + int offset32 = ((offset > INT_MAX) ? INT_MAX : (int)offset); + if (!pWav->onSeek(pWav->pUserData, offset32, DRWAV_SEEK_CUR)) { + return DRWAV_FALSE; + } + + pWav->readCursorInPCMFrames += offset32 / bytesPerFrame; + pWav->bytesRemaining -= offset32; + offset -= offset32; + } + } + + return DRWAV_TRUE; +} + +DRWAV_API drwav_result drwav_get_cursor_in_pcm_frames(drwav* pWav, drwav_uint64* pCursor) +{ + if (pCursor == NULL) { + return DRWAV_INVALID_ARGS; + } + + *pCursor = 0; /* Safety. */ + + if (pWav == NULL) { + return DRWAV_INVALID_ARGS; + } + + *pCursor = pWav->readCursorInPCMFrames; + + return DRWAV_SUCCESS; +} + +DRWAV_API drwav_result drwav_get_length_in_pcm_frames(drwav* pWav, drwav_uint64* pLength) +{ + if (pLength == NULL) { + return DRWAV_INVALID_ARGS; + } + + *pLength = 0; /* Safety. */ + + if (pWav == NULL) { + return DRWAV_INVALID_ARGS; + } + + *pLength = pWav->totalPCMFrameCount; + + return DRWAV_SUCCESS; +} + + +DRWAV_API size_t drwav_write_raw(drwav* pWav, size_t bytesToWrite, const void* pData) +{ + size_t bytesWritten; + + if (pWav == NULL || bytesToWrite == 0 || pData == NULL) { + return 0; + } + + bytesWritten = pWav->onWrite(pWav->pUserData, pData, bytesToWrite); + pWav->dataChunkDataSize += bytesWritten; + + return bytesWritten; +} + +DRWAV_API drwav_uint64 drwav_write_pcm_frames_le(drwav* pWav, drwav_uint64 framesToWrite, const void* pData) +{ + drwav_uint64 bytesToWrite; + drwav_uint64 bytesWritten; + const drwav_uint8* pRunningData; + + if (pWav == NULL || framesToWrite == 0 || pData == NULL) { + return 0; + } + + bytesToWrite = ((framesToWrite * pWav->channels * pWav->bitsPerSample) / 8); + if (bytesToWrite > DRWAV_SIZE_MAX) { + return 0; + } + + bytesWritten = 0; + pRunningData = (const drwav_uint8*)pData; + + while (bytesToWrite > 0) { + size_t bytesJustWritten; + drwav_uint64 bytesToWriteThisIteration; + + bytesToWriteThisIteration = bytesToWrite; + DRWAV_ASSERT(bytesToWriteThisIteration <= DRWAV_SIZE_MAX); /* <-- This is checked above. */ + + bytesJustWritten = drwav_write_raw(pWav, (size_t)bytesToWriteThisIteration, pRunningData); + if (bytesJustWritten == 0) { + break; + } + + bytesToWrite -= bytesJustWritten; + bytesWritten += bytesJustWritten; + pRunningData += bytesJustWritten; + } + + return (bytesWritten * 8) / pWav->bitsPerSample / pWav->channels; +} + +DRWAV_API drwav_uint64 drwav_write_pcm_frames_be(drwav* pWav, drwav_uint64 framesToWrite, const void* pData) +{ + drwav_uint64 bytesToWrite; + drwav_uint64 bytesWritten; + drwav_uint32 bytesPerSample; + const drwav_uint8* pRunningData; + + if (pWav == NULL || framesToWrite == 0 || pData == NULL) { + return 0; + } + + bytesToWrite = ((framesToWrite * pWav->channels * pWav->bitsPerSample) / 8); + if (bytesToWrite > DRWAV_SIZE_MAX) { + return 0; + } + + bytesWritten = 0; + pRunningData = (const drwav_uint8*)pData; + + bytesPerSample = drwav_get_bytes_per_pcm_frame(pWav) / pWav->channels; + if (bytesPerSample == 0) { + return 0; /* Cannot determine bytes per sample, or bytes per sample is less than one byte. */ + } + + while (bytesToWrite > 0) { + drwav_uint8 temp[4096]; + drwav_uint32 sampleCount; + size_t bytesJustWritten; + drwav_uint64 bytesToWriteThisIteration; + + bytesToWriteThisIteration = bytesToWrite; + DRWAV_ASSERT(bytesToWriteThisIteration <= DRWAV_SIZE_MAX); /* <-- This is checked above. */ + + /* + WAV files are always little-endian. We need to byte swap on big-endian architectures. Since our input buffer is read-only we need + to use an intermediary buffer for the conversion. + */ + sampleCount = sizeof(temp)/bytesPerSample; + + if (bytesToWriteThisIteration > ((drwav_uint64)sampleCount)*bytesPerSample) { + bytesToWriteThisIteration = ((drwav_uint64)sampleCount)*bytesPerSample; + } + + DRWAV_COPY_MEMORY(temp, pRunningData, (size_t)bytesToWriteThisIteration); + drwav__bswap_samples(temp, sampleCount, bytesPerSample); + + bytesJustWritten = drwav_write_raw(pWav, (size_t)bytesToWriteThisIteration, temp); + if (bytesJustWritten == 0) { + break; + } + + bytesToWrite -= bytesJustWritten; + bytesWritten += bytesJustWritten; + pRunningData += bytesJustWritten; + } + + return (bytesWritten * 8) / pWav->bitsPerSample / pWav->channels; +} + +DRWAV_API drwav_uint64 drwav_write_pcm_frames(drwav* pWav, drwav_uint64 framesToWrite, const void* pData) +{ + if (drwav__is_little_endian()) { + return drwav_write_pcm_frames_le(pWav, framesToWrite, pData); + } else { + return drwav_write_pcm_frames_be(pWav, framesToWrite, pData); + } +} + + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s16__msadpcm(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + drwav_uint64 totalFramesRead = 0; + + static const drwav_int32 adaptationTable[] = { + 230, 230, 230, 230, 307, 409, 512, 614, + 768, 614, 512, 409, 307, 230, 230, 230 + }; + static const drwav_int32 coeff1Table[] = { 256, 512, 0, 192, 240, 460, 392 }; + static const drwav_int32 coeff2Table[] = { 0, -256, 0, 64, 0, -208, -232 }; + + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(framesToRead > 0); + + /* TODO: Lots of room for optimization here. */ + + while (pWav->readCursorInPCMFrames < pWav->totalPCMFrameCount) { + DRWAV_ASSERT(framesToRead > 0); /* This loop iteration will never get hit with framesToRead == 0 because it's asserted at the top, and we check for 0 inside the loop just below. */ + + /* If there are no cached frames we need to load a new block. */ + if (pWav->msadpcm.cachedFrameCount == 0 && pWav->msadpcm.bytesRemainingInBlock == 0) { + if (pWav->channels == 1) { + /* Mono. */ + drwav_uint8 header[7]; + if (pWav->onRead(pWav->pUserData, header, sizeof(header)) != sizeof(header)) { + return totalFramesRead; + } + pWav->msadpcm.bytesRemainingInBlock = pWav->fmt.blockAlign - sizeof(header); + + pWav->msadpcm.predictor[0] = header[0]; + pWav->msadpcm.delta[0] = drwav_bytes_to_s16(header + 1); + pWav->msadpcm.prevFrames[0][1] = (drwav_int32)drwav_bytes_to_s16(header + 3); + pWav->msadpcm.prevFrames[0][0] = (drwav_int32)drwav_bytes_to_s16(header + 5); + pWav->msadpcm.cachedFrames[2] = pWav->msadpcm.prevFrames[0][0]; + pWav->msadpcm.cachedFrames[3] = pWav->msadpcm.prevFrames[0][1]; + pWav->msadpcm.cachedFrameCount = 2; + + /* The predictor is used as an index into coeff1Table so we'll need to validate to ensure it never overflows. */ + if (pWav->msadpcm.predictor[0] >= drwav_countof(coeff1Table) || pWav->msadpcm.predictor[0] >= drwav_countof(coeff2Table)) { + return totalFramesRead; /* Invalid file. */ + } + } else { + /* Stereo. */ + drwav_uint8 header[14]; + if (pWav->onRead(pWav->pUserData, header, sizeof(header)) != sizeof(header)) { + return totalFramesRead; + } + pWav->msadpcm.bytesRemainingInBlock = pWav->fmt.blockAlign - sizeof(header); + + pWav->msadpcm.predictor[0] = header[0]; + pWav->msadpcm.predictor[1] = header[1]; + pWav->msadpcm.delta[0] = drwav_bytes_to_s16(header + 2); + pWav->msadpcm.delta[1] = drwav_bytes_to_s16(header + 4); + pWav->msadpcm.prevFrames[0][1] = (drwav_int32)drwav_bytes_to_s16(header + 6); + pWav->msadpcm.prevFrames[1][1] = (drwav_int32)drwav_bytes_to_s16(header + 8); + pWav->msadpcm.prevFrames[0][0] = (drwav_int32)drwav_bytes_to_s16(header + 10); + pWav->msadpcm.prevFrames[1][0] = (drwav_int32)drwav_bytes_to_s16(header + 12); + + pWav->msadpcm.cachedFrames[0] = pWav->msadpcm.prevFrames[0][0]; + pWav->msadpcm.cachedFrames[1] = pWav->msadpcm.prevFrames[1][0]; + pWav->msadpcm.cachedFrames[2] = pWav->msadpcm.prevFrames[0][1]; + pWav->msadpcm.cachedFrames[3] = pWav->msadpcm.prevFrames[1][1]; + pWav->msadpcm.cachedFrameCount = 2; + + /* The predictor is used as an index into coeff1Table so we'll need to validate to ensure it never overflows. */ + if (pWav->msadpcm.predictor[0] >= drwav_countof(coeff1Table) || pWav->msadpcm.predictor[0] >= drwav_countof(coeff2Table) || + pWav->msadpcm.predictor[1] >= drwav_countof(coeff1Table) || pWav->msadpcm.predictor[1] >= drwav_countof(coeff2Table)) { + return totalFramesRead; /* Invalid file. */ + } + } + } + + /* Output anything that's cached. */ + while (framesToRead > 0 && pWav->msadpcm.cachedFrameCount > 0 && pWav->readCursorInPCMFrames < pWav->totalPCMFrameCount) { + if (pBufferOut != NULL) { + drwav_uint32 iSample = 0; + for (iSample = 0; iSample < pWav->channels; iSample += 1) { + pBufferOut[iSample] = (drwav_int16)pWav->msadpcm.cachedFrames[(drwav_countof(pWav->msadpcm.cachedFrames) - (pWav->msadpcm.cachedFrameCount*pWav->channels)) + iSample]; + } + + pBufferOut += pWav->channels; + } + + framesToRead -= 1; + totalFramesRead += 1; + pWav->readCursorInPCMFrames += 1; + pWav->msadpcm.cachedFrameCount -= 1; + } + + if (framesToRead == 0) { + break; + } + + + /* + If there's nothing left in the cache, just go ahead and load more. If there's nothing left to load in the current block we just continue to the next + loop iteration which will trigger the loading of a new block. + */ + if (pWav->msadpcm.cachedFrameCount == 0) { + if (pWav->msadpcm.bytesRemainingInBlock == 0) { + continue; + } else { + drwav_uint8 nibbles; + drwav_int32 nibble0; + drwav_int32 nibble1; + + if (pWav->onRead(pWav->pUserData, &nibbles, 1) != 1) { + return totalFramesRead; + } + pWav->msadpcm.bytesRemainingInBlock -= 1; + + /* TODO: Optimize away these if statements. */ + nibble0 = ((nibbles & 0xF0) >> 4); if ((nibbles & 0x80)) { nibble0 |= 0xFFFFFFF0UL; } + nibble1 = ((nibbles & 0x0F) >> 0); if ((nibbles & 0x08)) { nibble1 |= 0xFFFFFFF0UL; } + + if (pWav->channels == 1) { + /* Mono. */ + drwav_int32 newSample0; + drwav_int32 newSample1; + + /* The predictor is read from the file and then indexed into a table. Check that it's in bounds. */ + if (pWav->msadpcm.predictor[0] >= drwav_countof(coeff1Table) || pWav->msadpcm.predictor[0] >= drwav_countof(coeff2Table)) { + return totalFramesRead; + } + + newSample0 = ((pWav->msadpcm.prevFrames[0][1] * coeff1Table[pWav->msadpcm.predictor[0]]) + (pWav->msadpcm.prevFrames[0][0] * coeff2Table[pWav->msadpcm.predictor[0]])) >> 8; + newSample0 += nibble0 * pWav->msadpcm.delta[0]; + newSample0 = drwav_clamp(newSample0, -32768, 32767); + + pWav->msadpcm.delta[0] = (drwav_int32)drwav_clamp(((drwav_int64)adaptationTable[((nibbles & 0xF0) >> 4)] * pWav->msadpcm.delta[0]) >> 8, 16, 0x7FFFFFFF); + + pWav->msadpcm.prevFrames[0][0] = pWav->msadpcm.prevFrames[0][1]; + pWav->msadpcm.prevFrames[0][1] = newSample0; + + + newSample1 = ((pWav->msadpcm.prevFrames[0][1] * coeff1Table[pWav->msadpcm.predictor[0]]) + (pWav->msadpcm.prevFrames[0][0] * coeff2Table[pWav->msadpcm.predictor[0]])) >> 8; + newSample1 += nibble1 * pWav->msadpcm.delta[0]; + newSample1 = drwav_clamp(newSample1, -32768, 32767); + + pWav->msadpcm.delta[0] = (drwav_int32)drwav_clamp(((drwav_int64)adaptationTable[((nibbles & 0x0F) >> 0)] * pWav->msadpcm.delta[0]) >> 8, 16, 0x7FFFFFFF); + + pWav->msadpcm.prevFrames[0][0] = pWav->msadpcm.prevFrames[0][1]; + pWav->msadpcm.prevFrames[0][1] = newSample1; + + pWav->msadpcm.cachedFrames[2] = newSample0; + pWav->msadpcm.cachedFrames[3] = newSample1; + pWav->msadpcm.cachedFrameCount = 2; + } else { + /* Stereo. */ + drwav_int32 newSample0; + drwav_int32 newSample1; + + /* Left. */ + if (pWav->msadpcm.predictor[0] >= drwav_countof(coeff1Table) || pWav->msadpcm.predictor[0] >= drwav_countof(coeff2Table)) { + return totalFramesRead; /* Out of bounds. Invalid file. */ + } + + newSample0 = ((pWav->msadpcm.prevFrames[0][1] * coeff1Table[pWav->msadpcm.predictor[0]]) + (pWav->msadpcm.prevFrames[0][0] * coeff2Table[pWav->msadpcm.predictor[0]])) >> 8; + newSample0 += nibble0 * pWav->msadpcm.delta[0]; + newSample0 = drwav_clamp(newSample0, -32768, 32767); + + pWav->msadpcm.delta[0] = (drwav_int32)drwav_clamp(((drwav_int64)adaptationTable[((nibbles & 0xF0) >> 4)] * pWav->msadpcm.delta[0]) >> 8, 16, 0x7FFFFFFF); + + pWav->msadpcm.prevFrames[0][0] = pWav->msadpcm.prevFrames[0][1]; + pWav->msadpcm.prevFrames[0][1] = newSample0; + + + /* Right. */ + if (pWav->msadpcm.predictor[1] >= drwav_countof(coeff1Table) || pWav->msadpcm.predictor[1] >= drwav_countof(coeff2Table)) { + return totalFramesRead; /* Out of bounds. Invalid file. */ + } + + newSample1 = ((pWav->msadpcm.prevFrames[1][1] * coeff1Table[pWav->msadpcm.predictor[1]]) + (pWav->msadpcm.prevFrames[1][0] * coeff2Table[pWav->msadpcm.predictor[1]])) >> 8; + newSample1 += nibble1 * pWav->msadpcm.delta[1]; + newSample1 = drwav_clamp(newSample1, -32768, 32767); + + pWav->msadpcm.delta[1] = (drwav_int32)drwav_clamp(((drwav_int64)adaptationTable[((nibbles & 0x0F) >> 0)] * pWav->msadpcm.delta[1]) >> 8, 16, 0x7FFFFFFF); + + pWav->msadpcm.prevFrames[1][0] = pWav->msadpcm.prevFrames[1][1]; + pWav->msadpcm.prevFrames[1][1] = newSample1; + + pWav->msadpcm.cachedFrames[2] = newSample0; + pWav->msadpcm.cachedFrames[3] = newSample1; + pWav->msadpcm.cachedFrameCount = 1; + } + } + } + } + + return totalFramesRead; +} + + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s16__ima(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + drwav_uint64 totalFramesRead = 0; + drwav_uint32 iChannel; + + static const drwav_int32 indexTable[16] = { + -1, -1, -1, -1, 2, 4, 6, 8, + -1, -1, -1, -1, 2, 4, 6, 8 + }; + + static const drwav_int32 stepTable[89] = { + 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, + 19, 21, 23, 25, 28, 31, 34, 37, 41, 45, + 50, 55, 60, 66, 73, 80, 88, 97, 107, 118, + 130, 143, 157, 173, 190, 209, 230, 253, 279, 307, + 337, 371, 408, 449, 494, 544, 598, 658, 724, 796, + 876, 963, 1060, 1166, 1282, 1411, 1552, 1707, 1878, 2066, + 2272, 2499, 2749, 3024, 3327, 3660, 4026, 4428, 4871, 5358, + 5894, 6484, 7132, 7845, 8630, 9493, 10442, 11487, 12635, 13899, + 15289, 16818, 18500, 20350, 22385, 24623, 27086, 29794, 32767 + }; + + DRWAV_ASSERT(pWav != NULL); + DRWAV_ASSERT(framesToRead > 0); + + /* TODO: Lots of room for optimization here. */ + + while (pWav->readCursorInPCMFrames < pWav->totalPCMFrameCount) { + DRWAV_ASSERT(framesToRead > 0); /* This loop iteration will never get hit with framesToRead == 0 because it's asserted at the top, and we check for 0 inside the loop just below. */ + + /* If there are no cached samples we need to load a new block. */ + if (pWav->ima.cachedFrameCount == 0 && pWav->ima.bytesRemainingInBlock == 0) { + if (pWav->channels == 1) { + /* Mono. */ + drwav_uint8 header[4]; + if (pWav->onRead(pWav->pUserData, header, sizeof(header)) != sizeof(header)) { + return totalFramesRead; + } + pWav->ima.bytesRemainingInBlock = pWav->fmt.blockAlign - sizeof(header); + + if (header[2] >= drwav_countof(stepTable)) { + pWav->onSeek(pWav->pUserData, pWav->ima.bytesRemainingInBlock, DRWAV_SEEK_CUR); + pWav->ima.bytesRemainingInBlock = 0; + return totalFramesRead; /* Invalid data. */ + } + + pWav->ima.predictor[0] = (drwav_int16)drwav_bytes_to_u16(header + 0); + pWav->ima.stepIndex[0] = drwav_clamp(header[2], 0, (drwav_int32)drwav_countof(stepTable)-1); /* Clamp not necessary because we checked above, but adding here to silence a static analysis warning. */ + pWav->ima.cachedFrames[drwav_countof(pWav->ima.cachedFrames) - 1] = pWav->ima.predictor[0]; + pWav->ima.cachedFrameCount = 1; + } else { + /* Stereo. */ + drwav_uint8 header[8]; + if (pWav->onRead(pWav->pUserData, header, sizeof(header)) != sizeof(header)) { + return totalFramesRead; + } + pWav->ima.bytesRemainingInBlock = pWav->fmt.blockAlign - sizeof(header); + + if (header[2] >= drwav_countof(stepTable) || header[6] >= drwav_countof(stepTable)) { + pWav->onSeek(pWav->pUserData, pWav->ima.bytesRemainingInBlock, DRWAV_SEEK_CUR); + pWav->ima.bytesRemainingInBlock = 0; + return totalFramesRead; /* Invalid data. */ + } + + pWav->ima.predictor[0] = drwav_bytes_to_s16(header + 0); + pWav->ima.stepIndex[0] = drwav_clamp(header[2], 0, (drwav_int32)drwav_countof(stepTable)-1); /* Clamp not necessary because we checked above, but adding here to silence a static analysis warning. */ + pWav->ima.predictor[1] = drwav_bytes_to_s16(header + 4); + pWav->ima.stepIndex[1] = drwav_clamp(header[6], 0, (drwav_int32)drwav_countof(stepTable)-1); /* Clamp not necessary because we checked above, but adding here to silence a static analysis warning. */ + + pWav->ima.cachedFrames[drwav_countof(pWav->ima.cachedFrames) - 2] = pWav->ima.predictor[0]; + pWav->ima.cachedFrames[drwav_countof(pWav->ima.cachedFrames) - 1] = pWav->ima.predictor[1]; + pWav->ima.cachedFrameCount = 1; + } + } + + /* Output anything that's cached. */ + while (framesToRead > 0 && pWav->ima.cachedFrameCount > 0 && pWav->readCursorInPCMFrames < pWav->totalPCMFrameCount) { + if (pBufferOut != NULL) { + drwav_uint32 iSample; + for (iSample = 0; iSample < pWav->channels; iSample += 1) { + pBufferOut[iSample] = (drwav_int16)pWav->ima.cachedFrames[(drwav_countof(pWav->ima.cachedFrames) - (pWav->ima.cachedFrameCount*pWav->channels)) + iSample]; + } + pBufferOut += pWav->channels; + } + + framesToRead -= 1; + totalFramesRead += 1; + pWav->readCursorInPCMFrames += 1; + pWav->ima.cachedFrameCount -= 1; + } + + if (framesToRead == 0) { + break; + } + + /* + If there's nothing left in the cache, just go ahead and load more. If there's nothing left to load in the current block we just continue to the next + loop iteration which will trigger the loading of a new block. + */ + if (pWav->ima.cachedFrameCount == 0) { + if (pWav->ima.bytesRemainingInBlock == 0) { + continue; + } else { + /* + From what I can tell with stereo streams, it looks like every 4 bytes (8 samples) is for one channel. So it goes 4 bytes for the + left channel, 4 bytes for the right channel. + */ + pWav->ima.cachedFrameCount = 8; + for (iChannel = 0; iChannel < pWav->channels; ++iChannel) { + drwav_uint32 iByte; + drwav_uint8 nibbles[4]; + if (pWav->onRead(pWav->pUserData, &nibbles, 4) != 4) { + pWav->ima.cachedFrameCount = 0; + return totalFramesRead; + } + pWav->ima.bytesRemainingInBlock -= 4; + + for (iByte = 0; iByte < 4; ++iByte) { + drwav_uint8 nibble0 = ((nibbles[iByte] & 0x0F) >> 0); + drwav_uint8 nibble1 = ((nibbles[iByte] & 0xF0) >> 4); + + drwav_int32 step = stepTable[pWav->ima.stepIndex[iChannel]]; + drwav_int32 predictor = pWav->ima.predictor[iChannel]; + + drwav_int32 diff = step >> 3; + if (nibble0 & 1) diff += step >> 2; + if (nibble0 & 2) diff += step >> 1; + if (nibble0 & 4) diff += step; + if (nibble0 & 8) diff = -diff; + + predictor = drwav_clamp(predictor + diff, -32768, 32767); + pWav->ima.predictor[iChannel] = predictor; + pWav->ima.stepIndex[iChannel] = drwav_clamp(pWav->ima.stepIndex[iChannel] + indexTable[nibble0], 0, (drwav_int32)drwav_countof(stepTable)-1); + pWav->ima.cachedFrames[(drwav_countof(pWav->ima.cachedFrames) - (pWav->ima.cachedFrameCount*pWav->channels)) + (iByte*2+0)*pWav->channels + iChannel] = predictor; + + + step = stepTable[pWav->ima.stepIndex[iChannel]]; + predictor = pWav->ima.predictor[iChannel]; + + diff = step >> 3; + if (nibble1 & 1) diff += step >> 2; + if (nibble1 & 2) diff += step >> 1; + if (nibble1 & 4) diff += step; + if (nibble1 & 8) diff = -diff; + + predictor = drwav_clamp(predictor + diff, -32768, 32767); + pWav->ima.predictor[iChannel] = predictor; + pWav->ima.stepIndex[iChannel] = drwav_clamp(pWav->ima.stepIndex[iChannel] + indexTable[nibble1], 0, (drwav_int32)drwav_countof(stepTable)-1); + pWav->ima.cachedFrames[(drwav_countof(pWav->ima.cachedFrames) - (pWav->ima.cachedFrameCount*pWav->channels)) + (iByte*2+1)*pWav->channels + iChannel] = predictor; + } + } + } + } + } + + return totalFramesRead; +} + + +#ifndef DR_WAV_NO_CONVERSION_API +static const unsigned short g_drwavAlawTable[256] = { + 0xEA80, 0xEB80, 0xE880, 0xE980, 0xEE80, 0xEF80, 0xEC80, 0xED80, 0xE280, 0xE380, 0xE080, 0xE180, 0xE680, 0xE780, 0xE480, 0xE580, + 0xF540, 0xF5C0, 0xF440, 0xF4C0, 0xF740, 0xF7C0, 0xF640, 0xF6C0, 0xF140, 0xF1C0, 0xF040, 0xF0C0, 0xF340, 0xF3C0, 0xF240, 0xF2C0, + 0xAA00, 0xAE00, 0xA200, 0xA600, 0xBA00, 0xBE00, 0xB200, 0xB600, 0x8A00, 0x8E00, 0x8200, 0x8600, 0x9A00, 0x9E00, 0x9200, 0x9600, + 0xD500, 0xD700, 0xD100, 0xD300, 0xDD00, 0xDF00, 0xD900, 0xDB00, 0xC500, 0xC700, 0xC100, 0xC300, 0xCD00, 0xCF00, 0xC900, 0xCB00, + 0xFEA8, 0xFEB8, 0xFE88, 0xFE98, 0xFEE8, 0xFEF8, 0xFEC8, 0xFED8, 0xFE28, 0xFE38, 0xFE08, 0xFE18, 0xFE68, 0xFE78, 0xFE48, 0xFE58, + 0xFFA8, 0xFFB8, 0xFF88, 0xFF98, 0xFFE8, 0xFFF8, 0xFFC8, 0xFFD8, 0xFF28, 0xFF38, 0xFF08, 0xFF18, 0xFF68, 0xFF78, 0xFF48, 0xFF58, + 0xFAA0, 0xFAE0, 0xFA20, 0xFA60, 0xFBA0, 0xFBE0, 0xFB20, 0xFB60, 0xF8A0, 0xF8E0, 0xF820, 0xF860, 0xF9A0, 0xF9E0, 0xF920, 0xF960, + 0xFD50, 0xFD70, 0xFD10, 0xFD30, 0xFDD0, 0xFDF0, 0xFD90, 0xFDB0, 0xFC50, 0xFC70, 0xFC10, 0xFC30, 0xFCD0, 0xFCF0, 0xFC90, 0xFCB0, + 0x1580, 0x1480, 0x1780, 0x1680, 0x1180, 0x1080, 0x1380, 0x1280, 0x1D80, 0x1C80, 0x1F80, 0x1E80, 0x1980, 0x1880, 0x1B80, 0x1A80, + 0x0AC0, 0x0A40, 0x0BC0, 0x0B40, 0x08C0, 0x0840, 0x09C0, 0x0940, 0x0EC0, 0x0E40, 0x0FC0, 0x0F40, 0x0CC0, 0x0C40, 0x0DC0, 0x0D40, + 0x5600, 0x5200, 0x5E00, 0x5A00, 0x4600, 0x4200, 0x4E00, 0x4A00, 0x7600, 0x7200, 0x7E00, 0x7A00, 0x6600, 0x6200, 0x6E00, 0x6A00, + 0x2B00, 0x2900, 0x2F00, 0x2D00, 0x2300, 0x2100, 0x2700, 0x2500, 0x3B00, 0x3900, 0x3F00, 0x3D00, 0x3300, 0x3100, 0x3700, 0x3500, + 0x0158, 0x0148, 0x0178, 0x0168, 0x0118, 0x0108, 0x0138, 0x0128, 0x01D8, 0x01C8, 0x01F8, 0x01E8, 0x0198, 0x0188, 0x01B8, 0x01A8, + 0x0058, 0x0048, 0x0078, 0x0068, 0x0018, 0x0008, 0x0038, 0x0028, 0x00D8, 0x00C8, 0x00F8, 0x00E8, 0x0098, 0x0088, 0x00B8, 0x00A8, + 0x0560, 0x0520, 0x05E0, 0x05A0, 0x0460, 0x0420, 0x04E0, 0x04A0, 0x0760, 0x0720, 0x07E0, 0x07A0, 0x0660, 0x0620, 0x06E0, 0x06A0, + 0x02B0, 0x0290, 0x02F0, 0x02D0, 0x0230, 0x0210, 0x0270, 0x0250, 0x03B0, 0x0390, 0x03F0, 0x03D0, 0x0330, 0x0310, 0x0370, 0x0350 +}; + +static const unsigned short g_drwavMulawTable[256] = { + 0x8284, 0x8684, 0x8A84, 0x8E84, 0x9284, 0x9684, 0x9A84, 0x9E84, 0xA284, 0xA684, 0xAA84, 0xAE84, 0xB284, 0xB684, 0xBA84, 0xBE84, + 0xC184, 0xC384, 0xC584, 0xC784, 0xC984, 0xCB84, 0xCD84, 0xCF84, 0xD184, 0xD384, 0xD584, 0xD784, 0xD984, 0xDB84, 0xDD84, 0xDF84, + 0xE104, 0xE204, 0xE304, 0xE404, 0xE504, 0xE604, 0xE704, 0xE804, 0xE904, 0xEA04, 0xEB04, 0xEC04, 0xED04, 0xEE04, 0xEF04, 0xF004, + 0xF0C4, 0xF144, 0xF1C4, 0xF244, 0xF2C4, 0xF344, 0xF3C4, 0xF444, 0xF4C4, 0xF544, 0xF5C4, 0xF644, 0xF6C4, 0xF744, 0xF7C4, 0xF844, + 0xF8A4, 0xF8E4, 0xF924, 0xF964, 0xF9A4, 0xF9E4, 0xFA24, 0xFA64, 0xFAA4, 0xFAE4, 0xFB24, 0xFB64, 0xFBA4, 0xFBE4, 0xFC24, 0xFC64, + 0xFC94, 0xFCB4, 0xFCD4, 0xFCF4, 0xFD14, 0xFD34, 0xFD54, 0xFD74, 0xFD94, 0xFDB4, 0xFDD4, 0xFDF4, 0xFE14, 0xFE34, 0xFE54, 0xFE74, + 0xFE8C, 0xFE9C, 0xFEAC, 0xFEBC, 0xFECC, 0xFEDC, 0xFEEC, 0xFEFC, 0xFF0C, 0xFF1C, 0xFF2C, 0xFF3C, 0xFF4C, 0xFF5C, 0xFF6C, 0xFF7C, + 0xFF88, 0xFF90, 0xFF98, 0xFFA0, 0xFFA8, 0xFFB0, 0xFFB8, 0xFFC0, 0xFFC8, 0xFFD0, 0xFFD8, 0xFFE0, 0xFFE8, 0xFFF0, 0xFFF8, 0x0000, + 0x7D7C, 0x797C, 0x757C, 0x717C, 0x6D7C, 0x697C, 0x657C, 0x617C, 0x5D7C, 0x597C, 0x557C, 0x517C, 0x4D7C, 0x497C, 0x457C, 0x417C, + 0x3E7C, 0x3C7C, 0x3A7C, 0x387C, 0x367C, 0x347C, 0x327C, 0x307C, 0x2E7C, 0x2C7C, 0x2A7C, 0x287C, 0x267C, 0x247C, 0x227C, 0x207C, + 0x1EFC, 0x1DFC, 0x1CFC, 0x1BFC, 0x1AFC, 0x19FC, 0x18FC, 0x17FC, 0x16FC, 0x15FC, 0x14FC, 0x13FC, 0x12FC, 0x11FC, 0x10FC, 0x0FFC, + 0x0F3C, 0x0EBC, 0x0E3C, 0x0DBC, 0x0D3C, 0x0CBC, 0x0C3C, 0x0BBC, 0x0B3C, 0x0ABC, 0x0A3C, 0x09BC, 0x093C, 0x08BC, 0x083C, 0x07BC, + 0x075C, 0x071C, 0x06DC, 0x069C, 0x065C, 0x061C, 0x05DC, 0x059C, 0x055C, 0x051C, 0x04DC, 0x049C, 0x045C, 0x041C, 0x03DC, 0x039C, + 0x036C, 0x034C, 0x032C, 0x030C, 0x02EC, 0x02CC, 0x02AC, 0x028C, 0x026C, 0x024C, 0x022C, 0x020C, 0x01EC, 0x01CC, 0x01AC, 0x018C, + 0x0174, 0x0164, 0x0154, 0x0144, 0x0134, 0x0124, 0x0114, 0x0104, 0x00F4, 0x00E4, 0x00D4, 0x00C4, 0x00B4, 0x00A4, 0x0094, 0x0084, + 0x0078, 0x0070, 0x0068, 0x0060, 0x0058, 0x0050, 0x0048, 0x0040, 0x0038, 0x0030, 0x0028, 0x0020, 0x0018, 0x0010, 0x0008, 0x0000 +}; + +static DRWAV_INLINE drwav_int16 drwav__alaw_to_s16(drwav_uint8 sampleIn) +{ + return (short)g_drwavAlawTable[sampleIn]; +} + +static DRWAV_INLINE drwav_int16 drwav__mulaw_to_s16(drwav_uint8 sampleIn) +{ + return (short)g_drwavMulawTable[sampleIn]; +} + + + +DRWAV_PRIVATE void drwav__pcm_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t totalSampleCount, unsigned int bytesPerSample) +{ + size_t i; + + /* Special case for 8-bit sample data because it's treated as unsigned. */ + if (bytesPerSample == 1) { + drwav_u8_to_s16(pOut, pIn, totalSampleCount); + return; + } + + + /* Slightly more optimal implementation for common formats. */ + if (bytesPerSample == 2) { + for (i = 0; i < totalSampleCount; ++i) { + *pOut++ = ((const drwav_int16*)pIn)[i]; + } + return; + } + if (bytesPerSample == 3) { + drwav_s24_to_s16(pOut, pIn, totalSampleCount); + return; + } + if (bytesPerSample == 4) { + drwav_s32_to_s16(pOut, (const drwav_int32*)pIn, totalSampleCount); + return; + } + + + /* Anything more than 64 bits per sample is not supported. */ + if (bytesPerSample > 8) { + DRWAV_ZERO_MEMORY(pOut, totalSampleCount * sizeof(*pOut)); + return; + } + + + /* Generic, slow converter. */ + for (i = 0; i < totalSampleCount; ++i) { + drwav_uint64 sample = 0; + unsigned int shift = (8 - bytesPerSample) * 8; + + unsigned int j; + for (j = 0; j < bytesPerSample; j += 1) { + DRWAV_ASSERT(j < 8); + sample |= (drwav_uint64)(pIn[j]) << shift; + shift += 8; + } + + if (!drwav__is_little_endian()) { + sample = drwav__bswap64(sample); + } + + pIn += j; + *pOut++ = (drwav_int16)((drwav_int64)sample >> 48); + } +} + +DRWAV_PRIVATE void drwav__ieee_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t totalSampleCount, unsigned int bytesPerSample) +{ + if (bytesPerSample == 4) { + drwav_f32_to_s16(pOut, (const float*)pIn, totalSampleCount); + return; + } else if (bytesPerSample == 8) { + drwav_f64_to_s16(pOut, (const double*)pIn, totalSampleCount); + return; + } else { + /* Only supporting 32- and 64-bit float. Output silence in all other cases. Contributions welcome for 16-bit float. */ + DRWAV_ZERO_MEMORY(pOut, totalSampleCount * sizeof(*pOut)); + return; + } +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s16__pcm(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + /* Fast path. */ + if ((pWav->translatedFormatTag == DR_WAVE_FORMAT_PCM && pWav->bitsPerSample == 16) || pBufferOut == NULL) { + return drwav_read_pcm_frames(pWav, framesToRead, pBufferOut); + } + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav__pcm_to_s16(pBufferOut, sampleData, (size_t)samplesRead, bytesPerSample); + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s16__ieee(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + if (pBufferOut == NULL) { + return drwav_read_pcm_frames(pWav, framesToRead, NULL); + } + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav__ieee_to_s16(pBufferOut, sampleData, (size_t)samplesRead, bytesPerSample); /* Safe cast. */ + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s16__alaw(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + if (pBufferOut == NULL) { + return drwav_read_pcm_frames(pWav, framesToRead, NULL); + } + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav_alaw_to_s16(pBufferOut, sampleData, (size_t)samplesRead); + + /* + For some reason libsndfile seems to be returning samples of the opposite sign for a-law, but only + with AIFF files. For WAV files it seems to be the same as dr_wav. This is resulting in dr_wav's + automated tests failing. I'm not sure which is correct, but will assume dr_wav. If we're enforcing + libsndfile compatibility we'll swap the signs here. + */ + #ifdef DR_WAV_LIBSNDFILE_COMPAT + { + if (pWav->container == drwav_container_aiff) { + drwav_uint64 iSample; + for (iSample = 0; iSample < samplesRead; iSample += 1) { + pBufferOut[iSample] = -pBufferOut[iSample]; + } + } + } + #endif + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s16__mulaw(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + if (pBufferOut == NULL) { + return drwav_read_pcm_frames(pWav, framesToRead, NULL); + } + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav_mulaw_to_s16(pBufferOut, sampleData, (size_t)samplesRead); + + /* + Just like with alaw, for some reason the signs between libsndfile and dr_wav are opposite. We just need to + swap the sign if we're compiling with libsndfile compatiblity so our automated tests don't fail. + */ + #ifdef DR_WAV_LIBSNDFILE_COMPAT + { + if (pWav->container == drwav_container_aiff) { + drwav_uint64 iSample; + for (iSample = 0; iSample < samplesRead; iSample += 1) { + pBufferOut[iSample] = -pBufferOut[iSample]; + } + } + } + #endif + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s16(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + if (pWav == NULL || framesToRead == 0) { + return 0; + } + + if (pBufferOut == NULL) { + return drwav_read_pcm_frames(pWav, framesToRead, NULL); + } + + /* Don't try to read more samples than can potentially fit in the output buffer. */ + if (framesToRead * pWav->channels * sizeof(drwav_int16) > DRWAV_SIZE_MAX) { + framesToRead = DRWAV_SIZE_MAX / sizeof(drwav_int16) / pWav->channels; + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_PCM) { + return drwav_read_pcm_frames_s16__pcm(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_IEEE_FLOAT) { + return drwav_read_pcm_frames_s16__ieee(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ALAW) { + return drwav_read_pcm_frames_s16__alaw(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_MULAW) { + return drwav_read_pcm_frames_s16__mulaw(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM) { + return drwav_read_pcm_frames_s16__msadpcm(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_DVI_ADPCM) { + return drwav_read_pcm_frames_s16__ima(pWav, framesToRead, pBufferOut); + } + + return 0; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s16le(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + drwav_uint64 framesRead = drwav_read_pcm_frames_s16(pWav, framesToRead, pBufferOut); + if (pBufferOut != NULL && drwav__is_little_endian() == DRWAV_FALSE) { + drwav__bswap_samples_s16(pBufferOut, framesRead*pWav->channels); + } + + return framesRead; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s16be(drwav* pWav, drwav_uint64 framesToRead, drwav_int16* pBufferOut) +{ + drwav_uint64 framesRead = drwav_read_pcm_frames_s16(pWav, framesToRead, pBufferOut); + if (pBufferOut != NULL && drwav__is_little_endian() == DRWAV_TRUE) { + drwav__bswap_samples_s16(pBufferOut, framesRead*pWav->channels); + } + + return framesRead; +} + + +DRWAV_API void drwav_u8_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + int r; + size_t i; + for (i = 0; i < sampleCount; ++i) { + int x = pIn[i]; + r = x << 8; + r = r - 32768; + pOut[i] = (short)r; + } +} + +DRWAV_API void drwav_s24_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + int r; + size_t i; + for (i = 0; i < sampleCount; ++i) { + int x = ((int)(((unsigned int)(((const drwav_uint8*)pIn)[i*3+0]) << 8) | ((unsigned int)(((const drwav_uint8*)pIn)[i*3+1]) << 16) | ((unsigned int)(((const drwav_uint8*)pIn)[i*3+2])) << 24)) >> 8; + r = x >> 8; + pOut[i] = (short)r; + } +} + +DRWAV_API void drwav_s32_to_s16(drwav_int16* pOut, const drwav_int32* pIn, size_t sampleCount) +{ + int r; + size_t i; + for (i = 0; i < sampleCount; ++i) { + int x = pIn[i]; + r = x >> 16; + pOut[i] = (short)r; + } +} + +DRWAV_API void drwav_f32_to_s16(drwav_int16* pOut, const float* pIn, size_t sampleCount) +{ + int r; + size_t i; + for (i = 0; i < sampleCount; ++i) { + float x = pIn[i]; + float c; + c = ((x < -1) ? -1 : ((x > 1) ? 1 : x)); + c = c + 1; + r = (int)(c * 32767.5f); + r = r - 32768; + pOut[i] = (short)r; + } +} + +DRWAV_API void drwav_f64_to_s16(drwav_int16* pOut, const double* pIn, size_t sampleCount) +{ + int r; + size_t i; + for (i = 0; i < sampleCount; ++i) { + double x = pIn[i]; + double c; + c = ((x < -1) ? -1 : ((x > 1) ? 1 : x)); + c = c + 1; + r = (int)(c * 32767.5); + r = r - 32768; + pOut[i] = (short)r; + } +} + +DRWAV_API void drwav_alaw_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + for (i = 0; i < sampleCount; ++i) { + pOut[i] = drwav__alaw_to_s16(pIn[i]); + } +} + +DRWAV_API void drwav_mulaw_to_s16(drwav_int16* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + for (i = 0; i < sampleCount; ++i) { + pOut[i] = drwav__mulaw_to_s16(pIn[i]); + } +} + + +DRWAV_PRIVATE void drwav__pcm_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount, unsigned int bytesPerSample) +{ + unsigned int i; + + /* Special case for 8-bit sample data because it's treated as unsigned. */ + if (bytesPerSample == 1) { + drwav_u8_to_f32(pOut, pIn, sampleCount); + return; + } + + /* Slightly more optimal implementation for common formats. */ + if (bytesPerSample == 2) { + drwav_s16_to_f32(pOut, (const drwav_int16*)pIn, sampleCount); + return; + } + if (bytesPerSample == 3) { + drwav_s24_to_f32(pOut, pIn, sampleCount); + return; + } + if (bytesPerSample == 4) { + drwav_s32_to_f32(pOut, (const drwav_int32*)pIn, sampleCount); + return; + } + + + /* Anything more than 64 bits per sample is not supported. */ + if (bytesPerSample > 8) { + DRWAV_ZERO_MEMORY(pOut, sampleCount * sizeof(*pOut)); + return; + } + + + /* Generic, slow converter. */ + for (i = 0; i < sampleCount; ++i) { + drwav_uint64 sample = 0; + unsigned int shift = (8 - bytesPerSample) * 8; + + unsigned int j; + for (j = 0; j < bytesPerSample; j += 1) { + DRWAV_ASSERT(j < 8); + sample |= (drwav_uint64)(pIn[j]) << shift; + shift += 8; + } + + if (!drwav__is_little_endian()) { + sample = drwav__bswap64(sample); + } + + pIn += j; + *pOut++ = (float)((drwav_int64)sample / 9223372036854775807.0); + } +} + +DRWAV_PRIVATE void drwav__ieee_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount, unsigned int bytesPerSample) +{ + if (bytesPerSample == 4) { + unsigned int i; + for (i = 0; i < sampleCount; ++i) { + *pOut++ = ((const float*)pIn)[i]; + } + return; + } else if (bytesPerSample == 8) { + drwav_f64_to_f32(pOut, (const double*)pIn, sampleCount); + return; + } else { + /* Only supporting 32- and 64-bit float. Output silence in all other cases. Contributions welcome for 16-bit float. */ + DRWAV_ZERO_MEMORY(pOut, sampleCount * sizeof(*pOut)); + return; + } +} + + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_f32__pcm(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav__pcm_to_f32(pBufferOut, sampleData, (size_t)samplesRead, bytesPerSample); + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_f32__msadpcm_ima(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut) +{ + /* + We're just going to borrow the implementation from the drwav_read_s16() since ADPCM is a little bit more complicated than other formats and I don't + want to duplicate that code. + */ + drwav_uint64 totalFramesRead; + drwav_int16 samples16[2048]; + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, drwav_countof(samples16)/pWav->channels); + drwav_uint64 framesRead = drwav_read_pcm_frames_s16(pWav, framesToReadThisIteration, samples16); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + drwav_s16_to_f32(pBufferOut, samples16, (size_t)(framesRead*pWav->channels)); /* <-- Safe cast because we're clamping to 2048. */ + + pBufferOut += framesRead*pWav->channels; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_f32__ieee(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + /* Fast path. */ + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_IEEE_FLOAT && pWav->bitsPerSample == 32) { + return drwav_read_pcm_frames(pWav, framesToRead, pBufferOut); + } + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav__ieee_to_f32(pBufferOut, sampleData, (size_t)samplesRead, bytesPerSample); + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_f32__alaw(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav_alaw_to_f32(pBufferOut, sampleData, (size_t)samplesRead); + + #ifdef DR_WAV_LIBSNDFILE_COMPAT + { + if (pWav->container == drwav_container_aiff) { + drwav_uint64 iSample; + for (iSample = 0; iSample < samplesRead; iSample += 1) { + pBufferOut[iSample] = -pBufferOut[iSample]; + } + } + } + #endif + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_f32__mulaw(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav_mulaw_to_f32(pBufferOut, sampleData, (size_t)samplesRead); + + #ifdef DR_WAV_LIBSNDFILE_COMPAT + { + if (pWav->container == drwav_container_aiff) { + drwav_uint64 iSample; + for (iSample = 0; iSample < samplesRead; iSample += 1) { + pBufferOut[iSample] = -pBufferOut[iSample]; + } + } + } + #endif + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_f32(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut) +{ + if (pWav == NULL || framesToRead == 0) { + return 0; + } + + if (pBufferOut == NULL) { + return drwav_read_pcm_frames(pWav, framesToRead, NULL); + } + + /* Don't try to read more samples than can potentially fit in the output buffer. */ + if (framesToRead * pWav->channels * sizeof(float) > DRWAV_SIZE_MAX) { + framesToRead = DRWAV_SIZE_MAX / sizeof(float) / pWav->channels; + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_PCM) { + return drwav_read_pcm_frames_f32__pcm(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM || pWav->translatedFormatTag == DR_WAVE_FORMAT_DVI_ADPCM) { + return drwav_read_pcm_frames_f32__msadpcm_ima(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_IEEE_FLOAT) { + return drwav_read_pcm_frames_f32__ieee(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ALAW) { + return drwav_read_pcm_frames_f32__alaw(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_MULAW) { + return drwav_read_pcm_frames_f32__mulaw(pWav, framesToRead, pBufferOut); + } + + return 0; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_f32le(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut) +{ + drwav_uint64 framesRead = drwav_read_pcm_frames_f32(pWav, framesToRead, pBufferOut); + if (pBufferOut != NULL && drwav__is_little_endian() == DRWAV_FALSE) { + drwav__bswap_samples_f32(pBufferOut, framesRead*pWav->channels); + } + + return framesRead; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_f32be(drwav* pWav, drwav_uint64 framesToRead, float* pBufferOut) +{ + drwav_uint64 framesRead = drwav_read_pcm_frames_f32(pWav, framesToRead, pBufferOut); + if (pBufferOut != NULL && drwav__is_little_endian() == DRWAV_TRUE) { + drwav__bswap_samples_f32(pBufferOut, framesRead*pWav->channels); + } + + return framesRead; +} + + +DRWAV_API void drwav_u8_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + +#ifdef DR_WAV_LIBSNDFILE_COMPAT + /* + It appears libsndfile uses slightly different logic for the u8 -> f32 conversion to dr_wav, which in my opinion is incorrect. It appears + libsndfile performs the conversion something like "f32 = (u8 / 256) * 2 - 1", however I think it should be "f32 = (u8 / 255) * 2 - 1" (note + the divisor of 256 vs 255). I use libsndfile as a benchmark for testing, so I'm therefore leaving this block here just for my automated + correctness testing. This is disabled by default. + */ + for (i = 0; i < sampleCount; ++i) { + *pOut++ = (pIn[i] / 256.0f) * 2 - 1; + } +#else + for (i = 0; i < sampleCount; ++i) { + float x = pIn[i]; + x = x * 0.00784313725490196078f; /* 0..255 to 0..2 */ + x = x - 1; /* 0..2 to -1..1 */ + + *pOut++ = x; + } +#endif +} + +DRWAV_API void drwav_s16_to_f32(float* pOut, const drwav_int16* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = pIn[i] * 0.000030517578125f; + } +} + +DRWAV_API void drwav_s24_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + double x; + drwav_uint32 a = ((drwav_uint32)(pIn[i*3+0]) << 8); + drwav_uint32 b = ((drwav_uint32)(pIn[i*3+1]) << 16); + drwav_uint32 c = ((drwav_uint32)(pIn[i*3+2]) << 24); + + x = (double)((drwav_int32)(a | b | c) >> 8); + *pOut++ = (float)(x * 0.00000011920928955078125); + } +} + +DRWAV_API void drwav_s32_to_f32(float* pOut, const drwav_int32* pIn, size_t sampleCount) +{ + size_t i; + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = (float)(pIn[i] / 2147483648.0); + } +} + +DRWAV_API void drwav_f64_to_f32(float* pOut, const double* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = (float)pIn[i]; + } +} + +DRWAV_API void drwav_alaw_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = drwav__alaw_to_s16(pIn[i]) / 32768.0f; + } +} + +DRWAV_API void drwav_mulaw_to_f32(float* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = drwav__mulaw_to_s16(pIn[i]) / 32768.0f; + } +} + + + +DRWAV_PRIVATE void drwav__pcm_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t totalSampleCount, unsigned int bytesPerSample) +{ + unsigned int i; + + /* Special case for 8-bit sample data because it's treated as unsigned. */ + if (bytesPerSample == 1) { + drwav_u8_to_s32(pOut, pIn, totalSampleCount); + return; + } + + /* Slightly more optimal implementation for common formats. */ + if (bytesPerSample == 2) { + drwav_s16_to_s32(pOut, (const drwav_int16*)pIn, totalSampleCount); + return; + } + if (bytesPerSample == 3) { + drwav_s24_to_s32(pOut, pIn, totalSampleCount); + return; + } + if (bytesPerSample == 4) { + for (i = 0; i < totalSampleCount; ++i) { + *pOut++ = ((const drwav_int32*)pIn)[i]; + } + return; + } + + + /* Anything more than 64 bits per sample is not supported. */ + if (bytesPerSample > 8) { + DRWAV_ZERO_MEMORY(pOut, totalSampleCount * sizeof(*pOut)); + return; + } + + + /* Generic, slow converter. */ + for (i = 0; i < totalSampleCount; ++i) { + drwav_uint64 sample = 0; + unsigned int shift = (8 - bytesPerSample) * 8; + + unsigned int j; + for (j = 0; j < bytesPerSample; j += 1) { + DRWAV_ASSERT(j < 8); + sample |= (drwav_uint64)(pIn[j]) << shift; + shift += 8; + } + + if (!drwav__is_little_endian()) { + sample = drwav__bswap64(sample); + } + + pIn += j; + *pOut++ = (drwav_int32)((drwav_int64)sample >> 32); + } +} + +DRWAV_PRIVATE void drwav__ieee_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t totalSampleCount, unsigned int bytesPerSample) +{ + if (bytesPerSample == 4) { + drwav_f32_to_s32(pOut, (const float*)pIn, totalSampleCount); + return; + } else if (bytesPerSample == 8) { + drwav_f64_to_s32(pOut, (const double*)pIn, totalSampleCount); + return; + } else { + /* Only supporting 32- and 64-bit float. Output silence in all other cases. Contributions welcome for 16-bit float. */ + DRWAV_ZERO_MEMORY(pOut, totalSampleCount * sizeof(*pOut)); + return; + } +} + + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s32__pcm(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + /* Fast path. */ + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_PCM && pWav->bitsPerSample == 32) { + return drwav_read_pcm_frames(pWav, framesToRead, pBufferOut); + } + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav__pcm_to_s32(pBufferOut, sampleData, (size_t)samplesRead, bytesPerSample); + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s32__msadpcm_ima(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut) +{ + /* + We're just going to borrow the implementation from the drwav_read_s16() since ADPCM is a little bit more complicated than other formats and I don't + want to duplicate that code. + */ + drwav_uint64 totalFramesRead = 0; + drwav_int16 samples16[2048]; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, drwav_countof(samples16)/pWav->channels); + drwav_uint64 framesRead = drwav_read_pcm_frames_s16(pWav, framesToReadThisIteration, samples16); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + drwav_s16_to_s32(pBufferOut, samples16, (size_t)(framesRead*pWav->channels)); /* <-- Safe cast because we're clamping to 2048. */ + + pBufferOut += framesRead*pWav->channels; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s32__ieee(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav__ieee_to_s32(pBufferOut, sampleData, (size_t)samplesRead, bytesPerSample); + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s32__alaw(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav_alaw_to_s32(pBufferOut, sampleData, (size_t)samplesRead); + + #ifdef DR_WAV_LIBSNDFILE_COMPAT + { + if (pWav->container == drwav_container_aiff) { + drwav_uint64 iSample; + for (iSample = 0; iSample < samplesRead; iSample += 1) { + pBufferOut[iSample] = -pBufferOut[iSample]; + } + } + } + #endif + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_PRIVATE drwav_uint64 drwav_read_pcm_frames_s32__mulaw(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut) +{ + drwav_uint64 totalFramesRead; + drwav_uint8 sampleData[4096] = {0}; + drwav_uint32 bytesPerFrame; + drwav_uint32 bytesPerSample; + drwav_uint64 samplesRead; + + bytesPerFrame = drwav_get_bytes_per_pcm_frame(pWav); + if (bytesPerFrame == 0) { + return 0; + } + + bytesPerSample = bytesPerFrame / pWav->channels; + if (bytesPerSample == 0 || (bytesPerFrame % pWav->channels) != 0) { + return 0; /* Only byte-aligned formats are supported. */ + } + + totalFramesRead = 0; + + while (framesToRead > 0) { + drwav_uint64 framesToReadThisIteration = drwav_min(framesToRead, sizeof(sampleData)/bytesPerFrame); + drwav_uint64 framesRead = drwav_read_pcm_frames(pWav, framesToReadThisIteration, sampleData); + if (framesRead == 0) { + break; + } + + DRWAV_ASSERT(framesRead <= framesToReadThisIteration); /* If this fails it means there's a bug in drwav_read_pcm_frames(). */ + + /* Validation to ensure we don't read too much from out intermediary buffer. This is to protect from invalid files. */ + samplesRead = framesRead * pWav->channels; + if ((samplesRead * bytesPerSample) > sizeof(sampleData)) { + DRWAV_ASSERT(DRWAV_FALSE); /* This should never happen with a valid file. */ + break; + } + + drwav_mulaw_to_s32(pBufferOut, sampleData, (size_t)samplesRead); + + #ifdef DR_WAV_LIBSNDFILE_COMPAT + { + if (pWav->container == drwav_container_aiff) { + drwav_uint64 iSample; + for (iSample = 0; iSample < samplesRead; iSample += 1) { + pBufferOut[iSample] = -pBufferOut[iSample]; + } + } + } + #endif + + pBufferOut += samplesRead; + framesToRead -= framesRead; + totalFramesRead += framesRead; + } + + return totalFramesRead; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s32(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut) +{ + if (pWav == NULL || framesToRead == 0) { + return 0; + } + + if (pBufferOut == NULL) { + return drwav_read_pcm_frames(pWav, framesToRead, NULL); + } + + /* Don't try to read more samples than can potentially fit in the output buffer. */ + if (framesToRead * pWav->channels * sizeof(drwav_int32) > DRWAV_SIZE_MAX) { + framesToRead = DRWAV_SIZE_MAX / sizeof(drwav_int32) / pWav->channels; + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_PCM) { + return drwav_read_pcm_frames_s32__pcm(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ADPCM || pWav->translatedFormatTag == DR_WAVE_FORMAT_DVI_ADPCM) { + return drwav_read_pcm_frames_s32__msadpcm_ima(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_IEEE_FLOAT) { + return drwav_read_pcm_frames_s32__ieee(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_ALAW) { + return drwav_read_pcm_frames_s32__alaw(pWav, framesToRead, pBufferOut); + } + + if (pWav->translatedFormatTag == DR_WAVE_FORMAT_MULAW) { + return drwav_read_pcm_frames_s32__mulaw(pWav, framesToRead, pBufferOut); + } + + return 0; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s32le(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut) +{ + drwav_uint64 framesRead = drwav_read_pcm_frames_s32(pWav, framesToRead, pBufferOut); + if (pBufferOut != NULL && drwav__is_little_endian() == DRWAV_FALSE) { + drwav__bswap_samples_s32(pBufferOut, framesRead*pWav->channels); + } + + return framesRead; +} + +DRWAV_API drwav_uint64 drwav_read_pcm_frames_s32be(drwav* pWav, drwav_uint64 framesToRead, drwav_int32* pBufferOut) +{ + drwav_uint64 framesRead = drwav_read_pcm_frames_s32(pWav, framesToRead, pBufferOut); + if (pBufferOut != NULL && drwav__is_little_endian() == DRWAV_TRUE) { + drwav__bswap_samples_s32(pBufferOut, framesRead*pWav->channels); + } + + return framesRead; +} + + +DRWAV_API void drwav_u8_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = ((int)pIn[i] - 128) << 24; + } +} + +DRWAV_API void drwav_s16_to_s32(drwav_int32* pOut, const drwav_int16* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = pIn[i] << 16; + } +} + +DRWAV_API void drwav_s24_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + unsigned int s0 = pIn[i*3 + 0]; + unsigned int s1 = pIn[i*3 + 1]; + unsigned int s2 = pIn[i*3 + 2]; + + drwav_int32 sample32 = (drwav_int32)((s0 << 8) | (s1 << 16) | (s2 << 24)); + *pOut++ = sample32; + } +} + +DRWAV_API void drwav_f32_to_s32(drwav_int32* pOut, const float* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = (drwav_int32)(2147483648.0f * pIn[i]); + } +} + +DRWAV_API void drwav_f64_to_s32(drwav_int32* pOut, const double* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = (drwav_int32)(2147483648.0 * pIn[i]); + } +} + +DRWAV_API void drwav_alaw_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i = 0; i < sampleCount; ++i) { + *pOut++ = ((drwav_int32)drwav__alaw_to_s16(pIn[i])) << 16; + } +} + +DRWAV_API void drwav_mulaw_to_s32(drwav_int32* pOut, const drwav_uint8* pIn, size_t sampleCount) +{ + size_t i; + + if (pOut == NULL || pIn == NULL) { + return; + } + + for (i= 0; i < sampleCount; ++i) { + *pOut++ = ((drwav_int32)drwav__mulaw_to_s16(pIn[i])) << 16; + } +} + + + +DRWAV_PRIVATE drwav_int16* drwav__read_pcm_frames_and_close_s16(drwav* pWav, unsigned int* channels, unsigned int* sampleRate, drwav_uint64* totalFrameCount) +{ + drwav_uint64 sampleDataSize; + drwav_int16* pSampleData; + drwav_uint64 framesRead; + + DRWAV_ASSERT(pWav != NULL); + + /* Check for overflow before multiplication. */ + if (pWav->channels == 0 || pWav->totalPCMFrameCount > DRWAV_SIZE_MAX / pWav->channels / sizeof(drwav_int16)) { + drwav_uninit(pWav); + return NULL; /* Overflow or invalid channels. */ + } + + sampleDataSize = pWav->totalPCMFrameCount * pWav->channels * sizeof(drwav_int16); + if (sampleDataSize > DRWAV_SIZE_MAX) { + drwav_uninit(pWav); + return NULL; /* File's too big. */ + } + + pSampleData = (drwav_int16*)drwav__malloc_from_callbacks((size_t)sampleDataSize, &pWav->allocationCallbacks); /* <-- Safe cast due to the check above. */ + if (pSampleData == NULL) { + drwav_uninit(pWav); + return NULL; /* Failed to allocate memory. */ + } + + framesRead = drwav_read_pcm_frames_s16(pWav, (size_t)pWav->totalPCMFrameCount, pSampleData); + if (framesRead != pWav->totalPCMFrameCount) { + drwav__free_from_callbacks(pSampleData, &pWav->allocationCallbacks); + drwav_uninit(pWav); + return NULL; /* There was an error reading the samples. */ + } + + drwav_uninit(pWav); + + if (sampleRate) { + *sampleRate = pWav->sampleRate; + } + if (channels) { + *channels = pWav->channels; + } + if (totalFrameCount) { + *totalFrameCount = pWav->totalPCMFrameCount; + } + + return pSampleData; +} + +DRWAV_PRIVATE float* drwav__read_pcm_frames_and_close_f32(drwav* pWav, unsigned int* channels, unsigned int* sampleRate, drwav_uint64* totalFrameCount) +{ + drwav_uint64 sampleDataSize; + float* pSampleData; + drwav_uint64 framesRead; + + DRWAV_ASSERT(pWav != NULL); + + /* Check for overflow before multiplication. */ + if (pWav->channels == 0 || pWav->totalPCMFrameCount > DRWAV_SIZE_MAX / pWav->channels / sizeof(float)) { + drwav_uninit(pWav); + return NULL; /* Overflow or invalid channels. */ + } + + sampleDataSize = pWav->totalPCMFrameCount * pWav->channels * sizeof(float); + if (sampleDataSize > DRWAV_SIZE_MAX) { + drwav_uninit(pWav); + return NULL; /* File's too big. */ + } + + pSampleData = (float*)drwav__malloc_from_callbacks((size_t)sampleDataSize, &pWav->allocationCallbacks); /* <-- Safe cast due to the check above. */ + if (pSampleData == NULL) { + drwav_uninit(pWav); + return NULL; /* Failed to allocate memory. */ + } + + framesRead = drwav_read_pcm_frames_f32(pWav, (size_t)pWav->totalPCMFrameCount, pSampleData); + if (framesRead != pWav->totalPCMFrameCount) { + drwav__free_from_callbacks(pSampleData, &pWav->allocationCallbacks); + drwav_uninit(pWav); + return NULL; /* There was an error reading the samples. */ + } + + drwav_uninit(pWav); + + if (sampleRate) { + *sampleRate = pWav->sampleRate; + } + if (channels) { + *channels = pWav->channels; + } + if (totalFrameCount) { + *totalFrameCount = pWav->totalPCMFrameCount; + } + + return pSampleData; +} + +DRWAV_PRIVATE drwav_int32* drwav__read_pcm_frames_and_close_s32(drwav* pWav, unsigned int* channels, unsigned int* sampleRate, drwav_uint64* totalFrameCount) +{ + drwav_uint64 sampleDataSize; + drwav_int32* pSampleData; + drwav_uint64 framesRead; + + DRWAV_ASSERT(pWav != NULL); + + /* Check for overflow before multiplication. */ + if (pWav->channels == 0 || pWav->totalPCMFrameCount > DRWAV_SIZE_MAX / pWav->channels / sizeof(drwav_int32)) { + drwav_uninit(pWav); + return NULL; /* Overflow or invalid channels. */ + } + + sampleDataSize = pWav->totalPCMFrameCount * pWav->channels * sizeof(drwav_int32); + if (sampleDataSize > DRWAV_SIZE_MAX) { + drwav_uninit(pWav); + return NULL; /* File's too big. */ + } + + pSampleData = (drwav_int32*)drwav__malloc_from_callbacks((size_t)sampleDataSize, &pWav->allocationCallbacks); /* <-- Safe cast due to the check above. */ + if (pSampleData == NULL) { + drwav_uninit(pWav); + return NULL; /* Failed to allocate memory. */ + } + + framesRead = drwav_read_pcm_frames_s32(pWav, (size_t)pWav->totalPCMFrameCount, pSampleData); + if (framesRead != pWav->totalPCMFrameCount) { + drwav__free_from_callbacks(pSampleData, &pWav->allocationCallbacks); + drwav_uninit(pWav); + return NULL; /* There was an error reading the samples. */ + } + + drwav_uninit(pWav); + + if (sampleRate) { + *sampleRate = pWav->sampleRate; + } + if (channels) { + *channels = pWav->channels; + } + if (totalFrameCount) { + *totalFrameCount = pWav->totalPCMFrameCount; + } + + return pSampleData; +} + + + +DRWAV_API drwav_int16* drwav_open_and_read_pcm_frames_s16(drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init(&wav, onRead, onSeek, onTell, pUserData, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_s16(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +DRWAV_API float* drwav_open_and_read_pcm_frames_f32(drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init(&wav, onRead, onSeek, onTell, pUserData, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_f32(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +DRWAV_API drwav_int32* drwav_open_and_read_pcm_frames_s32(drwav_read_proc onRead, drwav_seek_proc onSeek, drwav_tell_proc onTell, void* pUserData, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init(&wav, onRead, onSeek, onTell, pUserData, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_s32(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +#ifndef DR_WAV_NO_STDIO +DRWAV_API drwav_int16* drwav_open_file_and_read_pcm_frames_s16(const char* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_file(&wav, filename, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_s16(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +DRWAV_API float* drwav_open_file_and_read_pcm_frames_f32(const char* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_file(&wav, filename, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_f32(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +DRWAV_API drwav_int32* drwav_open_file_and_read_pcm_frames_s32(const char* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_file(&wav, filename, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_s32(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + + +#ifndef DR_WAV_NO_WCHAR +DRWAV_API drwav_int16* drwav_open_file_and_read_pcm_frames_s16_w(const wchar_t* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (channelsOut) { + *channelsOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_file_w(&wav, filename, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_s16(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +DRWAV_API float* drwav_open_file_and_read_pcm_frames_f32_w(const wchar_t* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (channelsOut) { + *channelsOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_file_w(&wav, filename, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_f32(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +DRWAV_API drwav_int32* drwav_open_file_and_read_pcm_frames_s32_w(const wchar_t* filename, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (channelsOut) { + *channelsOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_file_w(&wav, filename, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_s32(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} +#endif /* DR_WAV_NO_WCHAR */ +#endif /* DR_WAV_NO_STDIO */ + +DRWAV_API drwav_int16* drwav_open_memory_and_read_pcm_frames_s16(const void* data, size_t dataSize, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_memory(&wav, data, dataSize, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_s16(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +DRWAV_API float* drwav_open_memory_and_read_pcm_frames_f32(const void* data, size_t dataSize, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_memory(&wav, data, dataSize, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_f32(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} + +DRWAV_API drwav_int32* drwav_open_memory_and_read_pcm_frames_s32(const void* data, size_t dataSize, unsigned int* channelsOut, unsigned int* sampleRateOut, drwav_uint64* totalFrameCountOut, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + drwav wav; + + if (channelsOut) { + *channelsOut = 0; + } + if (sampleRateOut) { + *sampleRateOut = 0; + } + if (totalFrameCountOut) { + *totalFrameCountOut = 0; + } + + if (!drwav_init_memory(&wav, data, dataSize, pAllocationCallbacks)) { + return NULL; + } + + return drwav__read_pcm_frames_and_close_s32(&wav, channelsOut, sampleRateOut, totalFrameCountOut); +} +#endif /* DR_WAV_NO_CONVERSION_API */ + + +DRWAV_API void drwav_free(void* p, const drwav_allocation_callbacks* pAllocationCallbacks) +{ + if (pAllocationCallbacks != NULL) { + drwav__free_from_callbacks(p, pAllocationCallbacks); + } else { + drwav__free_default(p, NULL); + } +} + +DRWAV_API drwav_uint16 drwav_bytes_to_u16(const drwav_uint8* data) +{ + return ((drwav_uint16)data[0] << 0) | ((drwav_uint16)data[1] << 8); +} + +DRWAV_API drwav_int16 drwav_bytes_to_s16(const drwav_uint8* data) +{ + return (drwav_int16)drwav_bytes_to_u16(data); +} + +DRWAV_API drwav_uint32 drwav_bytes_to_u32(const drwav_uint8* data) +{ + return drwav_bytes_to_u32_le(data); +} + +DRWAV_API float drwav_bytes_to_f32(const drwav_uint8* data) +{ + union { + drwav_uint32 u32; + float f32; + } value; + + value.u32 = drwav_bytes_to_u32(data); + return value.f32; +} + +DRWAV_API drwav_int32 drwav_bytes_to_s32(const drwav_uint8* data) +{ + return (drwav_int32)drwav_bytes_to_u32(data); +} + +DRWAV_API drwav_uint64 drwav_bytes_to_u64(const drwav_uint8* data) +{ + return + ((drwav_uint64)data[0] << 0) | ((drwav_uint64)data[1] << 8) | ((drwav_uint64)data[2] << 16) | ((drwav_uint64)data[3] << 24) | + ((drwav_uint64)data[4] << 32) | ((drwav_uint64)data[5] << 40) | ((drwav_uint64)data[6] << 48) | ((drwav_uint64)data[7] << 56); +} + +DRWAV_API drwav_int64 drwav_bytes_to_s64(const drwav_uint8* data) +{ + return (drwav_int64)drwav_bytes_to_u64(data); +} + + +DRWAV_API drwav_bool32 drwav_guid_equal(const drwav_uint8 a[16], const drwav_uint8 b[16]) +{ + int i; + for (i = 0; i < 16; i += 1) { + if (a[i] != b[i]) { + return DRWAV_FALSE; + } + } + + return DRWAV_TRUE; +} + +DRWAV_API drwav_bool32 drwav_fourcc_equal(const drwav_uint8* a, const char* b) +{ + return + a[0] == b[0] && + a[1] == b[1] && + a[2] == b[2] && + a[3] == b[3]; +} + +#ifdef __MRC__ +/* Undo the pragma at the beginning of this file. */ +#pragma options opt reset +#endif + +} // namespace QtPrivate +QT_END_NAMESPACE + +#endif /* dr_wav_c */ +#endif /* DR_WAV_IMPLEMENTATION */ + +/* +REVISION HISTORY +================ +v0.14.6 - TBD + - Fix an error when loading files with a malformed "bext" chunk. + - Fix an error when loading files with a malformed "fmt" chunk. + - Fix an underflow error with badly formed ADPCM encoded files. + - Fix an underflow error with badly formed W64 files. + - Fix an error when converting from >32 bit samples to s16/f32/s32 on big-endian architectures. + +v0.14.5 - 2026-03-03 + - Fix a crash when loading files with a malformed "smpl" chunk. + - Fix a signed overflow bug with the MS-ADPCM decoder. + +v0.14.4 - 2026-01-17 + - Fix some compilation warnings. + +v0.14.3 - 2025-12-14 + - Fix a possible out-of-bounds read when reading from MS-ADPCM encoded files. + - Fix a possible integer overflow error. + +v0.14.2 - 2025-12-02 + - Fix a compilation warning. + +v0.14.1 - 2025-09-10 + - Fix an error with the NXDK build. + +v0.14.0 - 2025-07-23 + - API CHANGE: Seek origin enums have been renamed to the following: + - drwav_seek_origin_start -> DRWAV_SEEK_SET + - drwav_seek_origin_current -> DRWAV_SEEK_CUR + - DRWAV_SEEK_END (new) + - API CHANGE: A new seek origin has been added to allow seeking from the end of the file. If you implement your own `onSeek` callback, you must now handle `DRWAV_SEEK_END`. If you only use `*_init_file()` or `*_init_memory()`, you need not change anything. + - API CHANGE: An `onTell` callback has been added to the following functions: + - drwav_init() + - drwav_init_ex() + - drwav_init_with_metadata() + - drwav_open_and_read_pcm_frames_s16() + - drwav_open_and_read_pcm_frames_f32() + - drwav_open_and_read_pcm_frames_s32() + - API CHANGE: The `firstSampleByteOffset`, `lastSampleByteOffset` and `sampleByteOffset` members of `drwav_cue_point` have been renamed to `firstSampleOffset`, `lastSampleOffset` and `sampleOffset`, respectively. + - Fix a static analysis warning. + - Fix compilation for AIX OS. + +v0.13.17 - 2024-12-17 + - Fix a possible crash when reading from MS-ADPCM encoded files. + - Improve detection of ARM64EC + +v0.13.16 - 2024-02-27 + - Fix a Wdouble-promotion warning. + +v0.13.15 - 2024-01-23 + - Relax some unnecessary validation that prevented some files from loading. + +v0.13.14 - 2023-12-02 + - Fix a warning about an unused variable. + +v0.13.13 - 2023-11-02 + - Fix a warning when compiling with Clang. + +v0.13.12 - 2023-08-07 + - Fix a possible crash in drwav_read_pcm_frames(). + +v0.13.11 - 2023-07-07 + - AIFF compatibility improvements. + +v0.13.10 - 2023-05-29 + - Fix a bug where drwav_init_with_metadata() does not decode any frames after initializtion. + +v0.13.9 - 2023-05-22 + - Add support for AIFF decoding (writing and metadata not supported). + - Add support for RIFX decoding (writing and metadata not supported). + - Fix a bug where metadata is not processed if it's located before the "fmt " chunk. + - Add a workaround for a type of malformed WAV file where the size of the "RIFF" and "data" chunks + are incorrectly set to 0xFFFFFFFF. + +v0.13.8 - 2023-03-25 + - Fix a possible null pointer dereference. + - Fix a crash when loading files with badly formed metadata. + +v0.13.7 - 2022-09-17 + - Fix compilation with DJGPP. + - Add support for disabling wchar_t with DR_WAV_NO_WCHAR. + +v0.13.6 - 2022-04-10 + - Fix compilation error on older versions of GCC. + - Remove some dependencies on the standard library. + +v0.13.5 - 2022-01-26 + - Fix an error when seeking to the end of the file. + +v0.13.4 - 2021-12-08 + - Fix some static analysis warnings. + +v0.13.3 - 2021-11-24 + - Fix an incorrect assertion when trying to endian swap 1-byte sample formats. This is now a no-op + rather than a failed assertion. + - Fix a bug with parsing of the bext chunk. + - Fix some static analysis warnings. + +v0.13.2 - 2021-10-02 + - Fix a possible buffer overflow when reading from compressed formats. + +v0.13.1 - 2021-07-31 + - Fix platform detection for ARM64. + +v0.13.0 - 2021-07-01 + - Improve support for reading and writing metadata. Use the `_with_metadata()` APIs to initialize + a WAV decoder and store the metadata within the `drwav` object. Use the `pMetadata` and + `metadataCount` members of the `drwav` object to read the data. The old way of handling metadata + via a callback is still usable and valid. + - API CHANGE: drwav_target_write_size_bytes() now takes extra parameters for calculating the + required write size when writing metadata. + - Add drwav_get_cursor_in_pcm_frames() + - Add drwav_get_length_in_pcm_frames() + - Fix a bug where drwav_read_raw() can call the read callback with a byte count of zero. + +v0.12.20 - 2021-06-11 + - Fix some undefined behavior. + +v0.12.19 - 2021-02-21 + - Fix a warning due to referencing _MSC_VER when it is undefined. + - Minor improvements to the management of some internal state concerning the data chunk cursor. + +v0.12.18 - 2021-01-31 + - Clean up some static analysis warnings. + +v0.12.17 - 2021-01-17 + - Minor fix to sample code in documentation. + - Correctly qualify a private API as private rather than public. + - Code cleanup. + +v0.12.16 - 2020-12-02 + - Fix a bug when trying to read more bytes than can fit in a size_t. + +v0.12.15 - 2020-11-21 + - Fix compilation with OpenWatcom. + +v0.12.14 - 2020-11-13 + - Minor code clean up. + +v0.12.13 - 2020-11-01 + - Improve compiler support for older versions of GCC. + +v0.12.12 - 2020-09-28 + - Add support for RF64. + - Fix a bug in writing mode where the size of the RIFF chunk incorrectly includes the header section. + +v0.12.11 - 2020-09-08 + - Fix a compilation error on older compilers. + +v0.12.10 - 2020-08-24 + - Fix a bug when seeking with ADPCM formats. + +v0.12.9 - 2020-08-02 + - Simplify sized types. + +v0.12.8 - 2020-07-25 + - Fix a compilation warning. + +v0.12.7 - 2020-07-15 + - Fix some bugs on big-endian architectures. + - Fix an error in s24 to f32 conversion. + +v0.12.6 - 2020-06-23 + - Change drwav_read_*() to allow NULL to be passed in as the output buffer which is equivalent to a forward seek. + - Fix a buffer overflow when trying to decode invalid IMA-ADPCM files. + - Add include guard for the implementation section. + +v0.12.5 - 2020-05-27 + - Minor documentation fix. + +v0.12.4 - 2020-05-16 + - Replace assert() with DRWAV_ASSERT(). + - Add compile-time and run-time version querying. + - DRWAV_VERSION_MINOR + - DRWAV_VERSION_MAJOR + - DRWAV_VERSION_REVISION + - DRWAV_VERSION_STRING + - drwav_version() + - drwav_version_string() + +v0.12.3 - 2020-04-30 + - Fix compilation errors with VC6. + +v0.12.2 - 2020-04-21 + - Fix a bug where drwav_init_file() does not close the file handle after attempting to load an erroneous file. + +v0.12.1 - 2020-04-13 + - Fix some pedantic warnings. + +v0.12.0 - 2020-04-04 + - API CHANGE: Add container and format parameters to the chunk callback. + - Minor documentation updates. + +v0.11.5 - 2020-03-07 + - Fix compilation error with Visual Studio .NET 2003. + +v0.11.4 - 2020-01-29 + - Fix some static analysis warnings. + - Fix a bug when reading f32 samples from an A-law encoded stream. + +v0.11.3 - 2020-01-12 + - Minor changes to some f32 format conversion routines. + - Minor bug fix for ADPCM conversion when end of file is reached. + +v0.11.2 - 2019-12-02 + - Fix a possible crash when using custom memory allocators without a custom realloc() implementation. + - Fix an integer overflow bug. + - Fix a null pointer dereference bug. + - Add limits to sample rate, channels and bits per sample to tighten up some validation. + +v0.11.1 - 2019-10-07 + - Internal code clean up. + +v0.11.0 - 2019-10-06 + - API CHANGE: Add support for user defined memory allocation routines. This system allows the program to specify their own memory allocation + routines with a user data pointer for client-specific contextual data. This adds an extra parameter to the end of the following APIs: + - drwav_init() + - drwav_init_ex() + - drwav_init_file() + - drwav_init_file_ex() + - drwav_init_file_w() + - drwav_init_file_w_ex() + - drwav_init_memory() + - drwav_init_memory_ex() + - drwav_init_write() + - drwav_init_write_sequential() + - drwav_init_write_sequential_pcm_frames() + - drwav_init_file_write() + - drwav_init_file_write_sequential() + - drwav_init_file_write_sequential_pcm_frames() + - drwav_init_file_write_w() + - drwav_init_file_write_sequential_w() + - drwav_init_file_write_sequential_pcm_frames_w() + - drwav_init_memory_write() + - drwav_init_memory_write_sequential() + - drwav_init_memory_write_sequential_pcm_frames() + - drwav_open_and_read_pcm_frames_s16() + - drwav_open_and_read_pcm_frames_f32() + - drwav_open_and_read_pcm_frames_s32() + - drwav_open_file_and_read_pcm_frames_s16() + - drwav_open_file_and_read_pcm_frames_f32() + - drwav_open_file_and_read_pcm_frames_s32() + - drwav_open_file_and_read_pcm_frames_s16_w() + - drwav_open_file_and_read_pcm_frames_f32_w() + - drwav_open_file_and_read_pcm_frames_s32_w() + - drwav_open_memory_and_read_pcm_frames_s16() + - drwav_open_memory_and_read_pcm_frames_f32() + - drwav_open_memory_and_read_pcm_frames_s32() + Set this extra parameter to NULL to use defaults which is the same as the previous behaviour. Setting this NULL will use + DRWAV_MALLOC, DRWAV_REALLOC and DRWAV_FREE. + - Add support for reading and writing PCM frames in an explicit endianness. New APIs: + - drwav_read_pcm_frames_le() + - drwav_read_pcm_frames_be() + - drwav_read_pcm_frames_s16le() + - drwav_read_pcm_frames_s16be() + - drwav_read_pcm_frames_f32le() + - drwav_read_pcm_frames_f32be() + - drwav_read_pcm_frames_s32le() + - drwav_read_pcm_frames_s32be() + - drwav_write_pcm_frames_le() + - drwav_write_pcm_frames_be() + - Remove deprecated APIs. + - API CHANGE: The following APIs now return native-endian data. Previously they returned little-endian data. + - drwav_read_pcm_frames() + - drwav_read_pcm_frames_s16() + - drwav_read_pcm_frames_s32() + - drwav_read_pcm_frames_f32() + - drwav_open_and_read_pcm_frames_s16() + - drwav_open_and_read_pcm_frames_s32() + - drwav_open_and_read_pcm_frames_f32() + - drwav_open_file_and_read_pcm_frames_s16() + - drwav_open_file_and_read_pcm_frames_s32() + - drwav_open_file_and_read_pcm_frames_f32() + - drwav_open_file_and_read_pcm_frames_s16_w() + - drwav_open_file_and_read_pcm_frames_s32_w() + - drwav_open_file_and_read_pcm_frames_f32_w() + - drwav_open_memory_and_read_pcm_frames_s16() + - drwav_open_memory_and_read_pcm_frames_s32() + - drwav_open_memory_and_read_pcm_frames_f32() + +v0.10.1 - 2019-08-31 + - Correctly handle partial trailing ADPCM blocks. + +v0.10.0 - 2019-08-04 + - Remove deprecated APIs. + - Add wchar_t variants for file loading APIs: + drwav_init_file_w() + drwav_init_file_ex_w() + drwav_init_file_write_w() + drwav_init_file_write_sequential_w() + - Add drwav_target_write_size_bytes() which calculates the total size in bytes of a WAV file given a format and sample count. + - Add APIs for specifying the PCM frame count instead of the sample count when opening in sequential write mode: + drwav_init_write_sequential_pcm_frames() + drwav_init_file_write_sequential_pcm_frames() + drwav_init_file_write_sequential_pcm_frames_w() + drwav_init_memory_write_sequential_pcm_frames() + - Deprecate drwav_open*() and drwav_close(): + drwav_open() + drwav_open_ex() + drwav_open_write() + drwav_open_write_sequential() + drwav_open_file() + drwav_open_file_ex() + drwav_open_file_write() + drwav_open_file_write_sequential() + drwav_open_memory() + drwav_open_memory_ex() + drwav_open_memory_write() + drwav_open_memory_write_sequential() + drwav_close() + - Minor documentation updates. + +v0.9.2 - 2019-05-21 + - Fix warnings. + +v0.9.1 - 2019-05-05 + - Add support for C89. + - Change license to choice of public domain or MIT-0. + +v0.9.0 - 2018-12-16 + - API CHANGE: Add new reading APIs for reading by PCM frames instead of samples. Old APIs have been deprecated and + will be removed in v0.10.0. Deprecated APIs and their replacements: + drwav_read() -> drwav_read_pcm_frames() + drwav_read_s16() -> drwav_read_pcm_frames_s16() + drwav_read_f32() -> drwav_read_pcm_frames_f32() + drwav_read_s32() -> drwav_read_pcm_frames_s32() + drwav_seek_to_sample() -> drwav_seek_to_pcm_frame() + drwav_write() -> drwav_write_pcm_frames() + drwav_open_and_read_s16() -> drwav_open_and_read_pcm_frames_s16() + drwav_open_and_read_f32() -> drwav_open_and_read_pcm_frames_f32() + drwav_open_and_read_s32() -> drwav_open_and_read_pcm_frames_s32() + drwav_open_file_and_read_s16() -> drwav_open_file_and_read_pcm_frames_s16() + drwav_open_file_and_read_f32() -> drwav_open_file_and_read_pcm_frames_f32() + drwav_open_file_and_read_s32() -> drwav_open_file_and_read_pcm_frames_s32() + drwav_open_memory_and_read_s16() -> drwav_open_memory_and_read_pcm_frames_s16() + drwav_open_memory_and_read_f32() -> drwav_open_memory_and_read_pcm_frames_f32() + drwav_open_memory_and_read_s32() -> drwav_open_memory_and_read_pcm_frames_s32() + drwav::totalSampleCount -> drwav::totalPCMFrameCount + - API CHANGE: Rename drwav_open_and_read_file_*() to drwav_open_file_and_read_*(). + - API CHANGE: Rename drwav_open_and_read_memory_*() to drwav_open_memory_and_read_*(). + - Add built-in support for smpl chunks. + - Add support for firing a callback for each chunk in the file at initialization time. + - This is enabled through the drwav_init_ex(), etc. family of APIs. + - Handle invalid FMT chunks more robustly. + +v0.8.5 - 2018-09-11 + - Const correctness. + - Fix a potential stack overflow. + +v0.8.4 - 2018-08-07 + - Improve 64-bit detection. + +v0.8.3 - 2018-08-05 + - Fix C++ build on older versions of GCC. + +v0.8.2 - 2018-08-02 + - Fix some big-endian bugs. + +v0.8.1 - 2018-06-29 + - Add support for sequential writing APIs. + - Disable seeking in write mode. + - Fix bugs with Wave64. + - Fix typos. + +v0.8 - 2018-04-27 + - Bug fix. + - Start using major.minor.revision versioning. + +v0.7f - 2018-02-05 + - Restrict ADPCM formats to a maximum of 2 channels. + +v0.7e - 2018-02-02 + - Fix a crash. + +v0.7d - 2018-02-01 + - Fix a crash. + +v0.7c - 2018-02-01 + - Set drwav.bytesPerSample to 0 for all compressed formats. + - Fix a crash when reading 16-bit floating point WAV files. In this case dr_wav will output silence for + all format conversion reading APIs (*_s16, *_s32, *_f32 APIs). + - Fix some divide-by-zero errors. + +v0.7b - 2018-01-22 + - Fix errors with seeking of compressed formats. + - Fix compilation error when DR_WAV_NO_CONVERSION_API + +v0.7a - 2017-11-17 + - Fix some GCC warnings. + +v0.7 - 2017-11-04 + - Add writing APIs. + +v0.6 - 2017-08-16 + - API CHANGE: Rename dr_* types to drwav_*. + - Add support for custom implementations of malloc(), realloc(), etc. + - Add support for Microsoft ADPCM. + - Add support for IMA ADPCM (DVI, format code 0x11). + - Optimizations to drwav_read_s16(). + - Bug fixes. + +v0.5g - 2017-07-16 + - Change underlying type for booleans to unsigned. + +v0.5f - 2017-04-04 + - Fix a minor bug with drwav_open_and_read_s16() and family. + +v0.5e - 2016-12-29 + - Added support for reading samples as signed 16-bit integers. Use the _s16() family of APIs for this. + - Minor fixes to documentation. + +v0.5d - 2016-12-28 + - Use drwav_int* and drwav_uint* sized types to improve compiler support. + +v0.5c - 2016-11-11 + - Properly handle JUNK chunks that come before the FMT chunk. + +v0.5b - 2016-10-23 + - A minor change to drwav_bool8 and drwav_bool32 types. + +v0.5a - 2016-10-11 + - Fixed a bug with drwav_open_and_read() and family due to incorrect argument ordering. + - Improve A-law and mu-law efficiency. + +v0.5 - 2016-09-29 + - API CHANGE. Swap the order of "channels" and "sampleRate" parameters in drwav_open_and_read*(). Rationale for this is to + keep it consistent with dr_audio and dr_flac. + +v0.4b - 2016-09-18 + - Fixed a typo in documentation. + +v0.4a - 2016-09-18 + - Fixed a typo. + - Change date format to ISO 8601 (YYYY-MM-DD) + +v0.4 - 2016-07-13 + - API CHANGE. Make onSeek consistent with dr_flac. + - API CHANGE. Rename drwav_seek() to drwav_seek_to_sample() for clarity and consistency with dr_flac. + - Added support for Sony Wave64. + +v0.3a - 2016-05-28 + - API CHANGE. Return drwav_bool32 instead of int in onSeek callback. + - Fixed a memory leak. + +v0.3 - 2016-05-22 + - Lots of API changes for consistency. + +v0.2a - 2016-05-16 + - Fixed Linux/GCC build. + +v0.2 - 2016-05-11 + - Added support for reading data as signed 32-bit PCM for consistency with dr_flac. + +v0.1a - 2016-05-07 + - Fixed a bug in drwav_open_file() where the file handle would not be closed if the loader failed to initialize. + +v0.1 - 2016-05-04 + - Initial versioned release. +*/ + +/* +This software is available as a choice of the following licenses. Choose +whichever you prefer. + +=============================================================================== +ALTERNATIVE 1 - Public Domain (www.unlicense.org) +=============================================================================== +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or distribute this +software, either in source code form or as a compiled binary, for any purpose, +commercial or non-commercial, and by any means. + +In jurisdictions that recognize copyright laws, the author or authors of this +software dedicate any and all copyright interest in the software to the public +domain. We make this dedication for the benefit of the public at large and to +the detriment of our heirs and successors. We intend this dedication to be an +overt act of relinquishment in perpetuity of all present and future rights to +this software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to + +=============================================================================== +ALTERNATIVE 2 - MIT No Attribution +=============================================================================== +Copyright 2023 David Reid + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ diff --git a/src/3rdparty/dr_libs/qt_attribution.json b/src/3rdparty/dr_libs/qt_attribution.json new file mode 100644 index 0000000..c5820b8 --- /dev/null +++ b/src/3rdparty/dr_libs/qt_attribution.json @@ -0,0 +1,19 @@ +{ + "Id": "dr_libs", + "Name": "DR Libs", + "QDocModule": "qtmultimedia", + "Description": "Public domain, single file audio decoding libraries for C and C++", + "QtUsage": "Wave file decoder for QSoundEffect", + "SecurityCritical": true, + + "Homepage": "https://github.com/mackron/dr_libs", + "Version": "0.14.5", + "DownloadLocation": "https://github.com/mackron/dr_libs/releases/wav-0.14.5", + + "License": "The Unlicense or MIT No Attribution", + "LicenseId": "Unlicense OR MIT-0", + "LicenseFiles": [ + "LICENSE" + ], + "PURL": "pkg:github/mackron/dr_libs@wav-$" +} diff --git a/src/3rdparty/eigen/.clang-format b/src/3rdparty/eigen/.clang-format new file mode 100644 index 0000000..1f33cbe --- /dev/null +++ b/src/3rdparty/eigen/.clang-format @@ -0,0 +1,19 @@ +--- +BasedOnStyle: Google +ColumnLimit: 120 +--- +Language: Cpp +BasedOnStyle: Google +ColumnLimit: 120 +StatementMacros: + - EIGEN_STATIC_ASSERT + - EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + - EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN +SortIncludes: false +AttributeMacros: +- EIGEN_STRONG_INLINE +- EIGEN_ALWAYS_INLINE +- EIGEN_DEVICE_FUNC +- EIGEN_DONT_INLINE +- EIGEN_DEPRECATED +- EIGEN_UNUSED diff --git a/src/3rdparty/eigen/CHANGELOG.md b/src/3rdparty/eigen/CHANGELOG.md new file mode 100644 index 0000000..4626552 --- /dev/null +++ b/src/3rdparty/eigen/CHANGELOG.md @@ -0,0 +1,1916 @@ +# Changelog + +## [5.0.1] - 2025-11-11 + +A few bug-fixes from the master branch, including +- Dirty git state [#2995] +- Failing geo_homogeneous tests [#2977] +- Alignment issues [#2982, #2984] +- Missing C++20 `` header [#2986] +- BLAS/LAPACK build on windows [#2980] + +See the full lists of [addressed bugs](https://gitlab.com/libeigen/eigen/-/issues?state=all&label_name%5B%5D=release%3A%3A5.0.1) and [merge requests](https://gitlab.com/libeigen/eigen/-/merge_requests?state=all&label_name%5B%5D=release%3A%3A5.0.1) for more details. + +## [5.0.0] - 2025-09-30 + +Eigen 5.0 provides many new features, performance enhancements, and bugfixes throughout Eigen’s core template expression infrastructure and linear algebra facilities. The full set of changes and related issues are too large to list here, but can be accessed via the release milestone %"5.0". + +This is the last major release to support the C++14 language standard. The master branch and subsequent releases will require support for C++17. + +### Versioning + +This release marks a transition to [Semantic Versioning](https://semver.org/). Previously, Eigen used a WORLD.MAJOR.MINOR scheme. From now on, version numbers will follow the MAJOR.MINOR.PATCH format, indicating breaking changes, new features, and bug fixes, respectively. The WORLD version will remain 3 for this and subsequent releases for posterity. See the table below: +``` +╔═════════╦═════╦═════╗ +║ Release ║ 3.4 ║ 5.0 ║ +╠═════════╬═════╬═════╣ +║ WORLD ║ 3 ║ 3 ║ +║ MAJOR ║ 4 ║ 5 ║ +║ MINOR ║ 0 ║ 0 ║ +║ PATCH ║ - ║ 0 ║ +╚═════════╩═════╩═════╝ +``` + +### Breaking changes + +* Eigen 5.X.X requires C++14. When building with GNU-compatible compilers, set `-std=c++14` or later. As part of this change, some macros such as `EIGEN_HAS_CXX11` have also been removed. +* The CMake build system has been modernized and older properties have been removed - projects relying on CMake may need to update their configurations [!485]. +* All LGPL-licensed code has been removed (i.e. Constrained Conjugate Gradient) [!1197]. These were "unsupported" anyways, and weren't widely used. +* Due to name conflicts with other projects, `Eigen::all` and `Eigen::last` have been moved to `Eigen::placeholders::all` and `Eigen::placeholders::last` [!649]. +* Any direct inclusion of an internal header (i.e. under a `../src/..` path) will result in a compilation error [!631]. +* Runtime SVD options for computing thin/full U/V have been deprecated: use compile-time options instead [!826]. +* Scalar (i.e. non-vectorized) comparisons now return masks with values of `Scalar(1)` rather than having all bits set to avoid undefined behavior [!1862]. +* BLAS return types have been changed for Eigen BLAS to `void` instead of `int` for compatibility with other BLAS implementations [!1497]. +* `Eigen::aligned_allocator` no longer inherits from `std::allocator` due to a change in the standard and the use of `allocate_at_least` [!1795]. +* Euler angles are now returned in a more canonical form, potentially resulting in a change of behavior [!1301, !1314]. +* Eigen's random number generation has changed, resulting in a change of behavior. Please do not rely on specific random numbers from Eigen - these were never guaranteed to be consistent across Eigen versions, nor are they generally consistent across platforms [!1437]. + +## [3.4.0] - 2021-08-18 + +**Notice:** 3.4.x will be the last major release series of Eigen that will support c++03. + +### Breaking changes + +* Using float or double for indexing matrices, vectors and arrays will now fail to compile +* **Behavioral change:** `Transform::computeRotationScaling()` and `Transform::computeScalingRotation()` are now more continuous across degeneracies (see !349). + +### New features + +* Add c++11 **`initializer_list` constructors** to Matrix and Array [\[doc\]](http://eigen.tuxfamily.org/dox-devel/group__TutorialMatrixClass.html#title3) +* Add STL-compatible **iterators** for dense expressions [\[doc\]](http://eigen.tuxfamily.org/dox-devel/group__TutorialSTL.html). +* New versatile API for sub-matrices, **slices**, and **indexed views** [\[doc\]](http://eigen.tuxfamily.org/dox-devel/group__TutorialSlicingIndexing.html). +* Add C++11 **template aliases** for Matrix, Vector, and Array of common sizes, including generic `Vector` and `RowVector` aliases [\[doc\]](http://eigen.tuxfamily.org/dox-devel/group__matrixtypedefs.html). +* New support for `bfloat16`. + +### New backends + +* **Arm SVE:** fixed-length [Scalable Vector Extensions](https://developer.arm.com/Architectures/Scalable%20Vector%20Extensions) vectors for `uint32_t` and `float` are available. +* **MIPS MSA:**: [MIPS SIMD Architecture (MSA)](https://www.mips.com/products/architectures/ase/simd/) +* **AMD ROCm/HIP:** generic GPU backend that unifies support for [NVIDIA/CUDA](https://developer.nvidia.com/cuda-toolkit) and [AMD/HIP](https://rocmdocs.amd.com/en/latest/). +* **Power 10 MMA:** initial support for [Power 10 matrix multiplication assist instructions](https://arxiv.org/pdf/2104.03142.pdf) for float32 and float64, real and complex. + +### Improvements + +* Eigen now uses the c++11 **alignas** keyword for static alignment. Users targeting C++17 only and recent compilers (e.g., GCC>=7, clang>=5, MSVC>=19.12) will thus be able to completely forget about all [issues](http://eigen.tuxfamily.org/dox-devel/group__TopicUnalignedArrayAssert.html) related to static alignment, including `EIGEN_MAKE_ALIGNED_OPERATOR_NEW`. +* Various performance improvements for products and Eigen's GEBP and GEMV kernels have been implemented: + * By using half and quater-packets the performance of matrix multiplications of small to medium sized matrices has been improved + * Eigen's GEMM now falls back to GEMV if it detects that a matrix is a run-time vector + * The performance of matrix products using Arm Neon has been drastically improved (up to 20%) + * Performance of many special cases of matrix products has been improved +* Large speed up from blocked algorithm for `transposeInPlace`. +* Speed up misc. operations by propagating compile-time sizes (col/row-wise reverse, PartialPivLU, and others) +* Faster specialized SIMD kernels for small fixed-size inverse, LU decomposition, and determinant. +* Improved or added vectorization of partial or slice reductions along the outer-dimension, for instance: `colmajor_mat.rowwise().mean()`. + +### Elementwise math functions + +* Many functions are now implemented and vectorized in generic (backend-agnostic) form. +* Many improvements to correctness, accuracy, and compatibility with c++ standard library. + * Much improved implementation of `ldexp`. + * Misc. fixes for corner cases, NaN/Inf inputs and singular points of many functions. + * New implementation of the Payne-Hanek for argument reduction algorithm for `sin` and `cos` with huge arguments. + * New faithfully rounded algorithm for `pow(x,y)`. +* Speedups from (new or improved) vectorized versions of `pow`, `log`, `sin`, `cos`, `arg`, `pow`, `log2`, complex `sqrt`, `erf`, `expm1`, `logp1`, `logistic`, `rint`, `gamma` and `bessel` functions, and more. +* Improved special function support (Bessel and gamma functions, `ndtri`, `erfc`, inverse hyperbolic functions and more) +* New elementwise functions for `absolute_difference`, `rint`. + +### Dense matrix decompositions and solvers + +* All dense linear solvers (i.e., Cholesky, *LU, *QR, CompleteOrthogonalDecomposition, *SVD) now inherit SolverBase and thus support `.transpose()`, `.adjoint()` and `.solve()` APIs. +* SVD implementations now have an `info()` method for checking convergence. +* Most decompositions now fail quickly when invalid inputs are detected. +* Optimized the product of a `HouseholderSequence` with the identity, as well as the evaluation of a `HouseholderSequence` to a dense matrix using faster blocked product. +* Fixed aliasing issues with in-place small matrix inversions. +* Fixed several edge-cases with empty or zero inputs. + +### Sparse matrix support, decompositions and solvers + +* Enabled assignment and addition with diagonal matrix expressions. +* Support added for SuiteSparse KLU routines via the `KLUSupport` module. SuiteSparse must be installed to use this module. +* `SparseCholesky` now works with row-major matrices. +* Various bug fixes and performance improvements. + +### Type support + +* Improved support for `half` + * Native support added for ARM `__fp16`, CUDA/HIP `__half`, and `F16C` conversion intrinsics. + * Better vectorization support added across all backends. +* Improved bool support + * Partial vectorization support added for boolean operations. + * Significantly improved performance (x25) for logical operations with `Matrix` or `Tensor` of `bool`. +* Improved support for custom types + * More custom types work out-of-the-box (see #2201). + +### Backend-specific improvements + +* **Arm NEON** + * Now provides vectorization for `uint64_t`, `int64_t`, `uint32_t`, `int16_t`, `uint16_t`, `int16_t`, `int8_t`, and `uint8_t` + * Emulates `bfloat16` support when using `Eigen::bfloat16` + * Supports emulated and native `float16` when using `Eigen::half` +* **SSE/AVX/AVX512** + * General performance improvements and bugfixes. + * Enabled AVX512 instructions by default if available. + * New `std::complex`, `half`, and `bfloat16` vectorization support added. + * Many missing packet functions added. +* **Altivec/Power** + * General performance improvement and bugfixes. + * Enhanced vectorization of real and complex scalars. + * Changes to the `gebp_kernel` specific to Altivec, using VSX implementation of the MMA instructions that gain speed improvements up to 4x for matrix-matrix products. + * Dynamic dispatch for GCC greater than 10 enabling selection of MMA or VSX instructions based on `__builtin_cpu_supports`. +* **GPU (CUDA and HIP)** + * Several optimized math functions added, better support for `std::complex`. + * Added option to disable CUDA entirely by defining `EIGEN_NO_CUDA`. + * Many more functions can now be used in device code (e.g. comparisons, small matrix inversion). +* **ZVector** + * Vectorized `float` and `std::complex` support added. + * Added z14 support. +* **SYCL** + * Redesigned SYCL implementation for use with the [https://eigen.tuxfamily.org/dox/unsupported/eigen_tensors.html Tensor] module, which can be enabled by defining `EIGEN_USE_SYCL`. + * New generic memory model introduced used by `TensorDeviceSycl`. + * Better integration with OpenCL devices. + * Added many math function specializations. + +### Miscellaneous API Changes + +* New `setConstant(...)` methods for preserving one dimension of a matrix by passing in `NoChange`. +* Added `setUnit(Index i)` for vectors that sets the ''i'' th coefficient to one and all others to zero. +* Added `transpose()`, `adjoint()`, `conjugate()` methods to `SelfAdjointView`. +* Added `shiftLeft()` and `shiftRight()` coefficient-wise arithmetic shift functions to Arrays. +* Enabled adding and subtracting of diagonal expressions. +* Allow user-defined default cache sizes via defining `EIGEN_DEFAULT_L1_CACHE_SIZE`, ..., `EIGEN_DEFAULT_L3_CACHE_SIZE`. +* Added `EIGEN_ALIGNOF(X)` macro for determining alignment of a provided variable. +* Allow plugins for `VectorwiseOp` by defining a file `EIGEN_VECTORWISEOP_PLUGIN` (e.g. `-DEIGEN_VECTORWISEOP_PLUGIN=my_vectorwise_op_plugins.h`). +* Allow disabling of IO operations by defining `EIGEN_NO_IO`. + +### Improvement to NaN propagation + +* Improvements to NaN correctness for elementwise functions. +* New `NaNPropagation` template argument to control whether NaNs are propagated or suppressed in elementwise `min/max` and corresponding reductions on `Array`, `Matrix`, and `Tensor`. + +### New low-latency non-blocking ThreadPool module +* Originally a part of the Tensor module, `Eigen::ThreadPool` is now separate and more portable, and forms the basis for multi-threading in TensorFlow, for example. + +### Changes to Tensor module + +* Support for c++03 was officially dropped in Tensor module, since most of the code was written in c++11 anyway. This will prevent building the code for CUDA with older version of `nvcc`. +* Performance optimizations of Tensor contraction + * Speed up "outer-product-like" operations by parallelizing over the contraction dimension, using thread_local buffers and recursive work splitting. + * Improved threading heuristics. + * Support for fusing element-wise operations into contraction during evaluation. +* Performance optimizations of other Tensor operator + * Speedups from improved vectorization, block evaluation, and multi-threading for most operators. + * Significant speedup to broadcasting. + * Reduction of index computation overhead, e.g. using fast divisors in TensorGenerator, squeezing dimensions in TensorPadding. +* Complete rewrite of the block (tiling) evaluation framework for tensor expressions lead to significant speedups and reduced number of memory allocations. +* Added new API for asynchronous evaluation of tensor expressions. +* Misc. minor behavior changes & fixes: + * Fix const correctness for TensorMap. + * Modify tensor argmin/argmax to always return first occurrence. + * More numerically stable tree reduction. + * Improve randomness of the tensor random generator. + * Update the padding computation for `PADDING_SAME` to be consistent with TensorFlow. + * Support static dimensions (aka IndexList) in resizing/reshape/broadcast. + * Improved accuracy of Tensor FFT. + +### Changes to sparse iterative solvers +* Added new IDRS iterative linear solver. + +### Other relevant changes + +* Eigen now provides an option to test with an external BLAS library + +See the [announcement](https://www.eigen.tuxfamily.org/index.php?title=3.4) for more details. + +## [3.3.9] - 2020-12-04 + +Changes since 3.3.8: + +* Commit 4e5385c90: Introduce rendering Doxygen math formulas with MathJax and the option `EIGEN_DOC_USE_MATHJAX` to control this. +* #1746: Removed implementation of standard copy-constructor and standard copy-assign-operator from PermutationMatrix and Transpositions to allow malloc-less `std::move`. +* #2036: Make sure the find_standard_math_library_test_program compiles and doesn't optimize away functions we try to test for. +* #2046: Rename test/array.cpp to test/array_cwise.cpp to fix an issue with the C++ standard library header "array" +* #2040: Fix an issue in test/ctorleak that occured when disabling exceptions. +* #2011: Remove error counting in OpenMP parallel section in Eigen's GEMM parallelizing logic. +* #2012: Define coeff-wise binary array operators for base class to fix an issue when using Eigen with C++20 +* Commit bfdd4a990: Fix an issue with Intel® MKL PARDISO support. + +## [3.3.8] - 2020-10-05 + +Changes since 3.3.7: + +* General bug fixes + * #1995: Fix a failure in the GEBP kernel when using small L1 cache sizes, OpenMP and FMA. + * #1990: Make CMake accept installation paths relative to `CMAKE_INSTALL_PREFIX`. + * #1974: Fix issue when reserving an empty sparse matrix + * #1823: Fix incorrect use of `std::abs` + * #1788: Fix rule-of-three violations inside the stable modules. This fixes deprecated-copy warnings when compiling with GCC>=9 Also protect some additional Base-constructors from getting called by user code code (#1587) + * #1796: Make matrix squareroot usable for Map and Ref types + * #1281: Fix AutoDiffScalar's make_coherent for nested expression of constant ADs. + * #1761: Fall back `is_integral` to `std::is_integral` in c++11 and fix `internal::is_integral` with MSVC 2013 and older. + * #1741: Fix `self_adjoint*matrix`, `triangular*matrix`, and `triangular^1*matrix` with a destination having a non-trivial inner-stride + * #1741: Fix SelfAdjointView::rankUpdate and product to triangular part for destination with non-trivial inner stride + * #1741: Fix `C.noalias() = A*C;` with `C.innerStride()!=1` + * #1695: Fix a numerical robustness issue in BDCSVD + * #1692: Enable enum as sizes of Matrix and Array + * #1689: Fix used-but-marked-unused warning + * #1679: Avoid possible division by 0 in complex-schur + * #1676: Fix C++17 template deduction in DenseBase + * #1669: Fix PartialPivLU/inverse with zero-sized matrices. + * #1557: Fix RealSchur and EigenSolver for matrices with only zeros on the diagonal. +* Performance related fixes + * #1562: Optimize evaluation of small products of the form s*A*B by rewriting them as: s*(A.lazyProduct(B)) to save a costly temporary. Measured speedup from 2x to 5x... + * Commit 165db26dc and 8ee2e10af: Fix performance issue with SimplicialLDLT for complexes coefficients +* Misc commits + * Commit 5f1082d0b: Fix `QuaternionBase::cast` for quaternion map and wrapper. + * Commit a153dbae9: Fix case issue with Lapack unit tests. + * Commit 3d7e2a1f3: Fix possible conflict with an externally defined "real" type when using gcc-5. + * Commit 1760432f6: Provide `numext::[u]int{32,64}_t`. + * Commit 3d18879fc: Initialize isometric transforms like affine transforms. + * Commit 160c0a340: Change typedefs from private to protected to fix MSVC compilation. + * Commit 3cf273591: Fix compilation of FFTW unit test. + * Commit 6abc9e537: Fix compilation of BLAS backend and frontend. + * Commit 47e2f8a42: Fix real/imag namespace conflict. + * Commit 71d0402e3: Avoid throwing in destructors. + * Commit 0dd9643ad: Fix precision issue in `SelfAdjointEigenSolver.h` + * Commit 6ed74ac97: Make `digits10()` return an integer. + * Commit 841d844f9: Use pade for matrix exponential also for complex values. + * Commit 4387298e8: Cast Index to RealScalar in SVDBase to fix an issue when RealScalar is not implicitly convertible to Index. + * Commit fe8cd812b: Provide `EIGEN_HAS_C99_MATH` when using MSVC. + * Commit 7c4208450: Various fixes in polynomial solver and its unit tests. + * Commit e777674a8 and 4415d4e2d: Extend polynomial solver unit tests to complexes. + * Commit 222ce4b49: Automatically switch between EigenSolver and ComplexEigenSolver, and fix a few Real versus Scalar issues. + * Commit 7b93328ba: Enable construction of `Ref` from a runtime vector. + * Commit c28ba89fe: Fix a problem of old gcc versions having problems with recursive #pragma GCC diagnostic push/pop. + * Commit 210d510a9: Fix compilation with expression template scalar type. + * Commit efd72cddc: Backport AVX512 implementation to 3.3. + * Commit 5e484fa11: Fix StlDeque compilation issue with GCC 10. + * Commit a796be81a: Avoid false-positive test results in non-linear optimization tests + * Commit 9f202c6f1: Fix undefined behaviour caused by uncaught exceptions in OMP section of parallel GEBP kernel. + * Commit 4707c3aa8: Fix a bug with half-precision floats on GPUs. +* Fixed warnings + * Commit 14db78c53: Fix some maybe-uninitialized warnings in AmbiVector.h and test bdcsvd. + * Commit f1b1f13d3: silent cmake warnings in Lapack CMakeLists.txt + * Commit 8fb28db12: Rename variable which shadows class name in Polynomials module. + * Commit f1c12d8ff: Workaround gcc's `alloc-size-larger-than=` warning in DenseStorage.h + * Commit 6870a39fe: Hide some unused variable warnings in g++8.1 in Tensor contraction mapper. + * Commit bb9981e24: Fix gcc 8.1 warning: "maybe use uninitialized" in std tests + * Commit eea99eb4e: Fix always true warning with gcc 4.7in test numext. + * Commit 65a6d4151: Fix nonnull-compare warning in test geo_alignedbox. + * Commit 74a0c08d7: Disable ignoring attributes warning in vectorization logic test. + * Commit 6c4d57dc9: Fix a gcc7 warning about bool * bool in abs2 default implementation. + * Commit 89a86ed42: Fix a warning in SparseSelfAdjointView about a branch statement always evaluation to false. + +## [3.3.8-rc1] - 2020-09-14 + +Changes since 3.3.7: + +* General bug fixes + * #1974: Fix issue when reserving an empty sparse matrix + * #1823: Fix incorrect use of `std::abs` + * #1788: Fix rule-of-three violations inside the stable modules. This fixes deprecated-copy warnings when compiling with GCC>=9 Also protect some additional Base-constructors from getting called by user code code (#1587) + * #1796: Make matrix squareroot usable for Map and Ref types + * #1281: Fix AutoDiffScalar's `make_coherent` for nested expression of constant ADs. + * #1761: Fall back `is_integral` to `std::is_integral` in c++11 and fix `internal::is_integral` with MSVC 2013 and older. + * #1741: Fix `self_adjoint*matrix`, `triangular*matrix`, and `triangular^1*matrix` with a destination having a non-trivial inner-stride + * #1741: Fix SelfAdjointView::rankUpdate and product to triangular part for destination with non-trivial inner stride + * #1741: Fix `C.noalias() = A*C;` with `C.innerStride()!=1` + * #1695: Fix a numerical robustness issue in BDCSVD + * #1692: Enable enum as sizes of Matrix and Array + * #1689: Fix used-but-marked-unused warning + * #1679: Avoid possible division by 0 in complex-schur + * #1676: Fix C++17 template deduction in DenseBase + * #1669: Fix PartialPivLU/inverse with zero-sized matrices. + * #1557: Fix RealSchur and EigenSolver for matrices with only zeros on the diagonal. +* Performance related fixes + * #1562: Optimize evaluation of small products of the form s*A*B by rewriting them as: s*(A.lazyProduct(B)) to save a costly temporary. Measured speedup from 2x to 5x... + * Commit 165db26dc and 8ee2e10af: Fix performance issue with SimplicialLDLT for complexes coefficients +* Misc commits + * Commit 5f1082d0b: Fix `QuaternionBase::cast` for quaternion map and wrapper. + * Commit a153dbae9: Fix case issue with Lapack unit tests. + * Commit 3d7e2a1f3: Fix possible conflict with an externally defined "real" type when using gcc-5. + * Commit 1760432f6: Provide `numext::[u]int{32,64}_t`. + * Commit 3d18879fc: Initialize isometric transforms like affine transforms. + * Commit 160c0a340: Change typedefs from private to protected to fix MSVC compilation. + * Commit 3cf273591: Fix compilation of FFTW unit test. + * Commit 6abc9e537: Fix compilation of BLAS backend and frontend. + * Commit 47e2f8a42: Fix real/imag namespace conflict. + * Commit 71d0402e3: Avoid throwing in destructors. + * Commit 0dd9643ad: Fix precision issue in SelfAdjointEigenSolver.h + * Commit 6ed74ac97: Make digits10() return an integer. + * Commit 841d844f9: Use pade for matrix exponential also for complex values. + * Commit 4387298e8: Cast Index to RealScalar in SVDBase to fix an issue when RealScalar is not implicitly convertible to Index. + * Commit fe8cd812b: Provide `EIGEN_HAS_C99_MATH` when using MSVC. + * Commit 7c4208450: Various fixes in polynomial solver and its unit tests. + * Commit e777674a8 and 4415d4e2d: Extend polynomial solver unit tests to complexes. + * Commit 222ce4b49: Automatically switch between EigenSolver and ComplexEigenSolver, and fix a few Real versus Scalar issues. + * Commit 5110d803e: Change license from LGPL to MPL2 with agreement from David Harmon. (grafted from 2df4f0024666a9085fe47f14e2290bd61676dbbd ) + * Commit 7b93328ba: Enable construction of `Ref` from a runtime vector. + * Commit c28ba89fe: Fix a problem of old gcc versions having problems with recursive #pragma GCC diagnostic push/pop. + * Commit 210d510a9: Fix compilation with expression template scalar type. +* Fixed warnings + * Commit 14db78c53: Fix some maybe-uninitialized warnings in AmbiVector.h and test bdcsvd. + * Commit f1b1f13d3: silent cmake warnings in Lapack CMakeLists.txt + * Commit 8fb28db12: Rename variable which shadows class name in Polynomials module. + * Commit f1c12d8ff: Workaround gcc's `alloc-size-larger-than=` warning in DenseStorage.h + * Commit 6870a39fe: Hide some unused variable warnings in g++8.1 in Tensor contraction mapper. + * Commit bb9981e24: Fix gcc 8.1 warning: "maybe use uninitialized" in std tests + * Commit eea99eb4e: Fix always true warning with gcc 4.7in test `numext`. + * Commit 65a6d4151: Fix nonnull-compare warning in test `geo_alignedbox`. + * Commit 74a0c08d7: Disable ignoring attributes warning in vectorization logic test. + * Commit 6c4d57dc9: Fix a gcc7 warning about bool * bool in abs2 default implementation. + * Commit efd72cddc: Backport AVX512 implementation to 3.3. + * Commit 5e484fa11: Fix StlDeque compilation issue with GCC 10. + * Commit 89a86ed42: Fix a warning in SparseSelfAdjointView about a branch statement always evaluation to false. + * Commit dd6de618: Fix a bug with half-precision floats on GPUs. + +## [3.3.7] - 2018-12-11 +¸¸¸¸ +Changes since 3.3.6: + +* #1643: Fix compilation with GCC>=6 and compiler optimization turned off. + +## [3.3.6] - 2018-12-10 + +Changes since 3.3.5: + +* #1617: Fix triangular solve crashing for empty matrix. +* #785: Make dense Cholesky decomposition work for empty matrices. +* #1634: Remove double copy in move-ctor of non movable Matrix/Array. +* Changeset a2d6c106a450: Workaround weird MSVC bug. +* #1637 Workaround performance regression in matrix products with gcc>=6 and clang>=6.0. +* Changeset 9ccbaaf3dd4c: Fix some implicit 0 to Scalar conversions. +* #1605: Workaround ABI issue with vector types (aka `__m128`) versus scalar types (aka float). +* Changeset 148e579cc004: Fix for gcc<4.6 regarding usage of #pragma GCC diagnostic push/pop. +* Changeset bc000deaae45: Fix conjugate-gradient for right-hand-sides with a very small magnitude. +* Changeset 5be00b0e2964: Fix product of empty arrays (returned 0 instead of 1). +* #1590: Fix collision with some system headers defining the macro FP32. +* #1584: Fix possible undefined behavior in random generation. +* Changeset e4127b0f7d3b: Fix fallback to BLAS for rankUpdate. +* Fixes for NVCC 9. +* Fix matrix-market IO. +* Various fixes in the doc. +* Various minor warning fixes/workarounds. + +## [3.3.5] - 2018-07-23 + +Changes since 3.3.4: + +* General bug fixes: + * Fix GeneralizedEigenSolver when requesting for eigenvalues only (ab3fa2e12308) + * #1560 fix product with a 1x1 diagonal matrix (483beabab9bf) + * #1543: fix linear indexing in generic block evaluation + * Fix compilation of product with inverse transpositions (e.g., `mat * Transpositions().inverse()`) (170914dbbcc3) + * #1509: fix `computeInverseWithCheck` for complexes (a2a2c3c86507) + * #1521: avoid signalling `NaN` in hypot and make it std::complex<> friendly (b18e2d422b09). + * #1517: fix triangular product with unit diagonal and nested scaling factor: `(s*A).triangularView()*B` (c24844195d90) + * Fix compilation of stableNorm for some odd expressions as input (33b972d8b384) + * #1485: fix linking issue of non template functions (d18877f18d8e) + * Fix overflow issues in BDCSVD (7a875acfb05f) + * #1468: add missing `std::` to `memcpy` (32a6db0f8cd5) + * #1453: fix Map with non-default inner-stride but no outer-stride (1ca9072b51d8) + * Fix mixing types in sparse matrix products (4ead16cdd6c8) + * #1544: Generate correct Q matrix in complex case (39125654ce9e) + * #1461: fix compilation of `Map::x()` (9a266e5118cf) + +* Backends: + * Fix MKL backend for symmetric eigenvalues on row-major matrices (eab7afe25273) + * #1527: fix support for MKL's VML (86a939451c75) + * Fix incorrect ldvt in LAPACKE call from JacobiSVD (bfc66e8b9a3b) + * Fix support for MKL's BLAS when using `MKL_DIRECT_CALL` (9df7f3d8e9cd, 3108fbf76708, 292dea7922e7) + * Use MKL's lapacke.h header when using MKL (070b5958e0ae) + +* Diagnostics: + * #1516: add assertion for out-of-range diagonal index in `MatrixBase::diagonal(i)` (273738ba6f6e) + * Add static assertion for fixed sizes `Ref<>` (1724dae8b834) + * Add static assertion on selfadjoint-view's UpLo parameter. (74daf12e525e, 190b46dd1f05) + * #1479: fix failure detection in LDLT (c20043c8fd64) + +* Compiler support: + * #1555: compilation fix with XLC + * Workaround MSVC 2013 ambiguous calls (c92536d92647) + * Adds missing `EIGEN_STRONG_INLINE` to help MSVC properly inlining small vector calculations (01fb6217335b) + * Several minor warning fixes: f90d136c8445, 542fb03968c2, "used uninitialized" (7634a44bfe11), Wint-in-bool-context (3d1795da28c2, d1c2d6683c55) + * #1428: make NEON vectorization compilable by MSVC. (* 1e2d2693b911, 927d023ceaab) + * Fix compilation and SSE support with PGI compiler (bb87f618bfc3 450c5e5d2771) + * #1555: compilation fix with XLC (20ca86888e70) + * #1520: workaround some `-Wfloat-equal` warnings by calling `std::equal_to` (1c4fdad7bd6f) + * Make the TensorStorage class compile with clang 3.9 (a7144f8d6a94) + * Misc: some old compiler fixes (b60cbbef3791) + * Fix MSVC warning C4290: C++ exception specification ignored except to indicate a function is not `__declspec(nothrow)` (3df78d5afc1e) + +* Architecture support: + * Several AVX512 fixes for `log`, `sqrt`, `rsqrt`, non `AVX512ER` CPUs, `apply_rotation_in_the_plane` 5c59564bfb92 1939c971a3db c2f9e6cb37e5, 609e425166f6. + * AltiVec fixes: 1641a6cdd5a4 + * NEON fixes: const-cast (877a2b64c9ba), compilation of Jacobi rotations (bc837b797559,#1436). + * Changeset 971b32440c74: Define `pcast<>` for SSE types even when AVX is enabled. (otherwise float are silently reinterpreted as int instead of being converted) + * #1494: makes `pmin`/`pmax` behave on Altivec/VSX as on x86 regarding NaNs (892c0a79ce93) + +* Documentation: + * Update manual pages regarding BDCSVD (#1538) + * Add aliasing in common pitfaffs (656712d48f6b) + * Update `aligned_allocator` (6fc0f2be70a4) + * #1456: add perf recommendation for LLT and storage format (55fbf4fedd04, 9fd138e2b333) + * #1455: Cholesky module depends on Jacobi for rank-updates (b87875abf8dc) + * #1458: fix documentation of LLT and LDLT `info()` method (ac2c97edff07) + * Warn about constness in `LLT::solveInPlace` (51e1aa153957) + * Fix lazyness of `operator*` with CUDA (fa77d713359d) + * #336: improve doc for `PlainObjectBase::Map` (18868228adae) + +* Other general improvements: + * Enable linear indexing in generic block evaluation (15752027ec2f, 80af7d6a47c1, #1543). + * Fix packet and alignment propagation logic of `Block` expressions. In particular, `(A+B).col(j)` now preserve vectorisation. (9c9e90f6db7e) + * Several fixes regarding custom scalar type support: hypot (385d8b5e42c2), boost-multiprec (5f71579a2d3f), literal casts (e6577f3c3049, fbb0c510c52f), + * LLT: avoid making a copy when decomposing in place (9d03711df8bc), const the arg to `solveInPlace()` to allow passing `.transpose()`, `.block()`, etc. (0137ed4f19b6). + * Add possibility to overwrite `EIGEN_STRONG_INLINE` (6d6e5fcd4356) + * #1528: use `numeric_limits::min()` instead of `1/highest()` that might underflow (9ff315024335) + * #1532: disable `stl::*_negate` in C++17 (they are deprecated) (3fb42ff7b278) + * Add C++11 `max_digits10` for half (70ac6c923001) + * Make sparse QR result sizes consistent with dense QR (2136cfa17e28) + +* Unsupported/unit-tests/cmake/unvisible internals/etc. + * #1484: restore deleted line for 128 bits long doubles, and improve dispatching logic. (c8e663fe87ec) + * #1462: remove all occurences of the deprecated `__CUDACC_VER__` macro by introducing `EIGEN_CUDACC_VER` (e7c065ec717b) + * Changeset fea50d40ea79: Fix oversharding bug in parallelFor. + * Changeset 866d222d6065: commit 45e9c9996da790b55ed9c4b0dfeae49492ac5c46 (HEAD -> memory_fix) + * Changeset 48048172e5aa: Fix int versus Index + * Changeset 906a98fe39c3: fix linking issue + * Changeset 352489edbe36: Fix short vs long + * Changeset 81e94eea024c: Fix cmake scripts with no fortran compiler + * Changeset 8bd392ca0e3f: add cmake-option to enable/disable creation of tests + * Changeset 02c0cef97fb5: Use col method for column-major matrix + * Changeset a8d2459f8e1f: #1449: fix `redux_3` unit test + * Changeset e90a14609a56: Fix uninitialized output argument. + * Changeset 5d40715db6a7: Handle min/max/inf/etc issue in `cuda_fp16.h` directly in `test/main.h` + * Changeset 2f9de522457b: Add tests for sparseQR results (value and size) covering bugs 1522 and 1544 + * Changeset 4662c610c13c: `SelfAdjointView<...,Mode>` causes a static assert since commit d820ab9edc0b + * Changeset 96134409fc91: weird compilation issue in `mapped_matrix.cpp` + +## [3.3.4] - 2017-06-15 + +Changes since 3.3.3: + +* General: + * Improve speed of Jacobi rotation when mixing complex and real types. + * #1405: enable StrictlyLower/StrictlyUpper triangularView as the destination of matrix*matrix products. + * UmfPack support: enable changes in the control settings and add report functions. + * #1423: fix LSCG's Jacobi preconditioner for row-major matrices. + * #1424: fix compilation issue with abs and unsigned integers as scalar type. + * #1410: fix lvalue propagation of Array/Matrix-Wrapper with a const nested expression. + * #1403: fix several implicit scalar type conversion making SVD decompositions compatible with ceres::Jet. + * Fix some real-to-scalar-to-real useless conversions in `ColPivHouseholderQR`. +* Regressions: + * Fix `dense * sparse_selfadjoint_view` product. + * #1417: make LinSpace compatible with std::complex. + * #1400: fix `stableNorm` alignment issue with `EIGEN_DONT_ALIGN_STATICALLY`. + * #1411: fix alignment issue in `Quaternion`. + * Fix compilation of operations between nested Arrays. + * #1435: fix aliasing issue in expressions like: `A = C - B*A`. +* Others: + * Fix compilation with gcc 4.3 and ARM NEON. + * Fix prefetches on ARM64 and ARM32. + * Fix out-of-bounds check in COLAMD. + * Few minor fixes regarding nvcc/CUDA support, including #1396. + * Improve cmake scripts for Pastix and BLAS detection. + * #1401: fix compilation of `cond ? x : -x` with `x` an `AutoDiffScalar` + * Fix compilation of matrix log with Map as input. + * Add specializations of `std::numeric_limits` for `Eigen::half` and and `AutoDiffScalar` + * Fix compilation of streaming nested Array, i.e., `std::cout << Array>` + +## [3.3.3] - 2017-02-21 + +Changes since 3.3.2: + +* General: + * Improve multi-threading heuristic for matrix products with a small number of columns. + * #1395: fix compilation of JacobiSVD for vectors type. + * Fix pruning in `(sparse*sparse).pruned()` when the result is nearly dense. + * #1382: move using `std::size_t`/`ptrdiff_t` to Eigen's namespace. + * Fix compilation and inlining when using clang-cl with visual studio. + * #1392: fix `#include ` with mpl2-only. +* Regressions: + * #1379: fix compilation in `sparse*diagonal*dense` with OpenMP. + * #1373: add missing assertion on size mismatch with compound assignment operators (e.g., mat += mat.col(j)) + * #1375: fix cmake installation with cmake 2.8. + * #1383: fix LinSpaced with integers for `LinPspaced(n,0,n-1)` with `n==0` or the `high(sparse*sparse)`. +* Others: + * Fix ARM NEON wrapper for 16 byte systems. + * #1391: include IO.h before DenseBase to enable its usage in DenseBase plugins. + * #1389: fix std containers support with MSVC and AVX. + * #1380: fix matrix exponential with `Map<>`. + * #1369: fix type mismatch warning with OpenMP. + * Fix usage of `size_t` instead of Index in sefl-adjoint `matrix * vector` + * #1378: fix doc (`DiagonalIndex` vs `Diagonal`). + +## [3.3.2] - 2017-01-18 +Changes since 3.3.1: + +* General: + * Add `transpose`, `adjoint`, `conjugate` methods to `SelfAdjointView` (useful to write generic code) + * Make sure that `HyperPlane::transform` maintains a unit normal vector in the Affine case. + * Several documentation improvements, including: several doxygen workarounds, #1336, #1370, StorageIndex, selfadjointView, sparseView(), sparse triangular solve, AsciiQuickReference.txt, ... +* Regressions: + * #1358: fix compilation of `sparse += sparse.selfadjointView()`. + * #1359: fix compilation of `sparse /=scalar`, `sparse *=scalar`, and `col_major_sparse.row() *= scalar`. + * #1361: fix compilation of mat=perm.inverse() + * Some fixes in sparse coeff-wise binary operations: add missing `.outer()` member to iterators, and properly report storage order. + * Fix aliasing issue in code as `A.triangularView() = B*A.sefladjointView()*B.adjoint()` +* Performance: + * Improve code generation for `mat*vec` on some compilers. + * Optimize horizontal adds in SSE3 and AVX. + * Speed up row-major TRSM (triangular solve with a matrix as right-hand-side) by reverting `vec/y` to `vec*(1/y)`. The rationale is: + * div is extremely costly + * this is consistent with the column-major case + * this is consistent with all other BLAS implementations + * Remove one temporary in `SparseLU::solve()` +* Others: + * Fix BLAS backend for symmetric rank K updates. + * #1360: fix `-0` vs `+0` issue with Altivec + * #1363: fix mingw's ABI issue + * #1367: fix compilation with gcc 4.1. + * Fix ABI issue with AVX and old gcc versions. + * Fix some warnings with ICC, Power8, etc. + * Fix compilation with MSVC 2017 + +## [3.3.1] - 2016-12-06 + +Changes since 3.3.0: + +* #426: add operators `&&` and `||` to dense and sparse matrices (only dense arrays were supported) +* #1319: add support for CMake's imported targets. +* #1343: fix compilation regression in `array = matrix_product` and `mat+=selfadjoint_view` +* Fix regression in assignment of sparse block to sparse block. +* Fix a memory leak in `Ref` and `Ref`. +* #1351: fix compilation of random with old compilers. +* Fix a performance regression in (mat*mat)*vec for which mat*mat was evaluated multiple times. +* Fix a regression in `SparseMatrix::ReverseInnerIterator` +* Fix performance issue of products for dynamic size matrices with fixed max size. +* implement `float`/`std::complex` for ZVector +* Some fixes for expression-template scalar-types +* #1356: fix undefined behavior with nullptr. +* Workaround some compilation errors with MSVC and MSVC/clr +* #1348: document `EIGEN_MAX_ALIGN_BYTES` and `EIGEN_MAX_STATIC_ALIGN_BYTES`, and reflect in the doc that `EIGEN_DONT_ALIGN*` are deprecated. +* Bugs #1346,#1347: make Eigen's installation relocatable. +* Fix some harmless compilation warnings. + +## [3.3] - 2016-11-10 + +For a comprehensive list of change since the 3.2 series, see this [page](https://www.eigen.tuxfamily.org/index.php?title=3.3). + + +Main changes since 3.3-rc2: +* Fix regression in printing sparse expressions. +* Fix sparse solvers when using a SparseVector as the result and/or right-hand-side. + +## [3.3-rc2] - 2016-11-04 + +For a comprehensive list of change since the 3.2 series, see this [page](https://www.eigen.tuxfamily.org/index.php?title=3.3). + +Main changes since 3.3-rc1: +* Core module + * Add supports for AVX512 SIMD instruction set. + * Bugs #698 and #1004: Improve numerical robustness of LinSpaced methods for both real and integer scalar types ([details](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1DenseBase.html#aaef589c1dbd7fad93f97bd3fa1b1e768)). + * Fix a regression in `X = (X*X.transpose())/scalar` with `X` rectangular (`X` was resized before the evaluation). + * #1311: Fix alignment logic in some cases of `(scalar*small).lazyProduct(small)` + * #1317: fix a performance regression from 3.2 with clang and some nested block expressions. + * #1308: fix compilation of some small products involving nullary-expressions. + * #1333: Fix a regression with `mat.array().sum()` + * #1328: Fix a compilation issue with old compilers introduced in 3.3-rc1. + * #1325: Fix compilation on NEON with clang + * Properly handle negative inputs in vectorized sqrt. + * Improve cost-model to determine the ideal number of threads in matrix-matrix products. +* Geometry module + * #1304: Fix `Projective * scaling` and `Projective *= scaling`. + * #1310: Workaround a compilation regression from 3.2 regarding triangular * homogeneous + * #1312: Quaternion to AxisAngle conversion now ensures the angle will be in the range `[0,pi]`. This also increases accuracy when `q_w` is negative. +* Tensor module + * Add support for OpenCL. + * Improved random number generation. +* Other + * #1330: SuiteSparse, explicitly handle the fact that Cholmod does not support single precision float numbers. + * SuiteSparse, fix SPQR for rectangular matrices + * Fix compilation of `qr.inverse()` for column and full pivoting variants + +## [3.2.10] - 2016-10-04 + +Changes since 3.2.9: + +Main fixes and improvements: +* #1272: Core module, improve comma-initializer in handling empty matrices. +* #1276: Core module, remove all references to `std::binder*` when C++11 is enabled (those are deprecated). +* #1304: Geometry module, fix `Projective * scaling` and `Projective *= scaling`. +* #1300: Sparse module, compilation fix for some block expression and SPQR support. +* Sparse module, fix support for row (resp. column) of a column-major (resp. row-major) sparse matrix. +* LU module, fix 4x4 matrix inversion for non-linear destinations. +* Core module, a few fixes regarding custom complex types. +* #1275: backported improved random generator from 3.3 +* Workaround MSVC 2013 compilation issue in Reverse +* Fix UmfPackLU constructor for expressions. +* #1273: fix shortcoming in eigen_assert macro +* #1249: disable the use of `__builtin_prefetch` for compilers other than GCC, clang, and ICC. +* #1265: fix doc of QR decompositions + +## [3.3-rc1] - 2016-09-22 + +For a comprehensive list of change since the 3.2 series, see this [page](https://www.eigen.tuxfamily.org/index.php?title=3.3). + +Main changes since 3.3-beta2: + +* New features and improvements: + * #645: implement eigenvector computation in GeneralizedEigenSolver + * #1271: add a `SparseMatrix::coeffs()` method returning a linear view of the non-zeros (for compressed mode only). + * #1286: Improve support for custom nullary functors: now the functor only has to expose one relevant operator among `f()`, `f(i)`, `f(i,j)`. + * #1272: improve comma-initializer in handling empty matrices. + * #1268: detect failure in LDLT and report them through info() + * Add support for scalar factor in sparse-selfadjoint `*` dense products, and enable `+=`/`-=` assignment for such products. + * Remove temporaries in product expressions matching `d?=a-b*c` by rewriting them as `d?=a; d?=b*c;` + * Vectorization improvements for some small product cases. + +* Doc: + * #1265: fix outdated doc in QR facto + * #828: improve documentation of sparse block methods, and sparse unary methods. + * Improve documentation regarding nullary functors, and add an example demonstrating the use of nullary expression to perform fancy matrix manipulations. + * Doc: explain how to use Accelerate as a LAPACK backend. + +* Bug fixes and internal changes: + * Numerous fixes regarding support for custom complex types. + * #1273: fix shortcoming in `eigen_assert` macro + * #1278: code formatting + * #1270: by-pass hand written `pmadd` with recent clang versions. + * #1282: fix implicit double to float conversion warning + * #1167: simplify installation of header files using cmake's `install(DIRECTORY ...)` command + * #1283: fix products involving an uncommon `vector.block(..)` expressions. + * #1285: fix a minor regression in LU factorization. + * JacobiSVD now consider any denormal number as zero. + * Numerous fixes regarding support for CUDA/NVCC (including bugs #1266) + * Fix an alignment issue in gemv, symv, and trmv for statically allocated temporaries. + * Fix 4x4 matrix inversion for non-linear destinations. + * Numerous improvements and fixes in half precision scalar type. + * Fix vectorization logic for coeff-based product for some corner cases + * Bugs #1260, #1261, #1264: several fixes in AutoDiffScalar. + +## [3.3-beta2] - 2016-08-26 + +For a comprehensive list of change since the 3.2 series, see this [page](https://www.eigen.tuxfamily.org/index.php?title=3.3). + +Main changes since 3.3-beta1: + +* Dense features: + * #707: Add support for [inplace](http://eigen.tuxfamily.org/dox-devel/group__InplaceDecomposition.html) dense decompositions. + * #977: normalize(d) left the input unchanged if its norm is 0 or too close to 0. + * #977: add stableNormalize[d] methods: they are analogues to normalize[d] but with carefull handling of under/over-flow. + * #279: Implement generic scalar*expr and expr*scalar operators. This is especially useful for custom scalar types, e.g., to enable `float*expr` without conversion. + * New unsupported/Eigen/SpecialFunctions module providing the following coefficient-wise math functions: erf, erfc, lgamma, digamma, polygamma, igamma, igammac, zeta, betainc. + * Add fast reciprocal condition estimators in dense LU and Cholesky factorizations. + * #1230: add support for `SelfadjointView::triangularView()` and `diagonal()` + * #823: add `Quaternion::UnitRandom()` method. + * Add exclusive or operator for bool arrays. + * Relax dependency on MKL for `EIGEN_USE_BLAS` and `EIGEN_USE_LAPACKE`: any BLAS and LAPACK libraries can now be used as backend (see [doc](http://eigen.tuxfamily.org/dox-devel/TopicUsingBlasLapack.html)). + * Add static assertion to `x()`, `y()`, `z()`, `w()` accessors + * #51: avoid dynamic memory allocation in fixed-size rank-updates, matrix products evaluated within a triangular part, and selfadjoint times matrix products. + * #696: enable zero-sized block at compile-time by relaxing the respective assertion + * #779: in `Map`, allows non aligned buffers for buffers smaller than the requested alignment. + * Add a complete orthogonal decomposition class: [CompleteOrthogonalDecomposition](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1CompleteOrthogonalDecomposition.html) + * Improve robustness of JacoviSVD with complexes (underflow, noise amplification in complex to real conversion, compare off-diagonal entries to the current biggest diagonal entry instead of the global biggest, null inputs). + * Change Eigen's ColPivHouseholderQR to use a numerically stable norm downdate formula (changeset acce4dd0500f) + * #1214: consider denormals as zero in D&C SVD. This also workaround infinite binary search when compiling with ICC's unsafe optimizations. + * Add log1p for arrays. + * #1193: now `lpNorm` supports empty inputs. + * #1151: remove useless critical section in matrix product + * Add missing non-const reverse method in `VectorwiseOp` (e.g., this enables `A.rowwise().reverse() = ...`) + * Update RealQZ to reduce 2x2 diagonal block of T corresponding to non reduced diagonal block of S to positive diagonal form. + +* Sparse features: + * #632: add support for "dense +/- sparse" operations. The current implementation is based on SparseView to make the dense subexpression compatible with the sparse one. + * #1095: add Cholmod*::logDeterminant/determinant functions. + * Add `SparseVector::conservativeResize()` method + * #946: generalize `Cholmod::solve` to handle any rhs expressions. + * #1150: make IncompleteCholesky more robust by iteratively increase the shift until the factorization succeed (with at most 10 attempts) + * #557: make InnerIterator of sparse storage types more versatile by adding default-ctor, copy-ctor/assignment. + * #694: document that `SparseQR::matrixR` is not sorted. + * Block expressions now expose all the information defining the block. + * Fix GMRES returned error. + * #1119: add support for SuperLU 5 + +* Performance improvements: + * #256: enable vectorization with unaligned loads/stores. This concerns all architectures and all sizes. This new behavior can be disabled by defining `EIGEN_UNALIGNED_VECTORIZE=0` + * Add support for s390x(zEC13) ZVECTOR instruction set. + * Optimize mixing of real with complex matrices by avoiding a conversion from real to complex when the real types do not match exactly. (see 76faf4a9657e) + * Speedup square roots in performance critical methods such as norm, normalize(d). + * #1154: use dynamic scheduling for spmv products. + * #667, #1181: improve perf with MSVC and ICC through `FORCE_INLINE` + * Improve heuristics for switching between coeff-based and general matrix product implementation at compile-time. + * Add vectorization of tanh for float (SSE/AVX) + * Improve cost estimates of numerous functors. + * Numerous improvements regarding half-packet vectorization: coeff-based products (e.g., `Matrix4f*Vector4f` is now vectorized again when using AVX), reductions, linear vs inner traversals. + * Fix performance regression: with AVX, unaligned stores were emitted instead of aligned ones for fixed size assignment. + * #1201: optimize `affine*vector` products. + * #1191: prevent Clang/ARM from rewriting VMLA into VMUL+VADD. + * Small speed-up in `Quaternion::slerp`. + * #1201: improve code generation of affine*vec with MSVC + +* Doc: + * Add [documentation and exemple](http://eigen.tuxfamily.org/dox-devel/group__MatrixfreeSolverExample.html) for matrix-free solving. + * A new documentation [page](http://eigen.tuxfamily.org/dox-devel/group__CoeffwiseMathFunctions.html) summarizing coefficient-wise math functions. + * #1144: clarify the doc about aliasing in case of resizing and matrix product. + * A new documentation [page](http://eigen.tuxfamily.org/dox-devel/group__DenseDecompositionBenchmark.html) summarizing the true performance of Eigen's dense decomposition algorithms. + +* Misc improvements: + * Allow one generic scalar argument for all binary operators/functions. + * Add a `EIGEN_MAX_CPP_VER` option to limit the C++ version to be used, as well as [fine grained options](http://eigen.tuxfamily.org/dox-devel/TopicPreprocessorDirectives.html#title1) to control individual language features. + * A new [ScalarBinaryOpTraits](http://eigen.tuxfamily.org/dox-devel/structEigen_1_1ScalarBinaryOpTraits.html) class allowing to control how different scalar types are mixed. + * `NumTraits` now exposes a `digits10` function making `internal::significant_decimals_impl` deprecated. + * Countless improvements and fixes in Tensors module. + * #1156: fix several function declarations whose arguments were passed by value instead of being passed by reference + * #1164: fix `std::list` and `std::deque` specializations such that our aligned allocator is automatically activated only when the user did not specified an allocator (or specified the default std::allocator). + * #795: mention allocate_shared as a candidate for aligned_allocator. + * #1170: skip calls to memcpy/memmove for empty inputs. + * #1203: by-pass large stack-allocation in stableNorm if `EIGEN_STACK_ALLOCATION_LIMIT` is too small + * Improve constness of blas level-2/3 interface. + * Implement stricter argument checking for SYRK and SY2K + * Countless improvements in the documentations. + * Internal: Remove `posix_memalign`, `_mm_malloc`, and `_aligned_malloc` special paths. + * Internal: Remove custom unaligned loads for SSE + * Internal: introduce `[U]IntPtr` types to be used for casting pointers to integers. + * Internal: `NumTraits` now exposes `infinity()` + * Internal: `EvalBeforeNestingBit` is now deprecated. + * #1213: workaround gcc linking issue with anonymous enums. + * #1242: fix comma initializer with empty matrices. + * #725: make move ctor/assignment noexcept + * Add minimal support for `Array` + * Improve support for custom scalar types bases on expression template (e.g., `boost::multiprecision::number<>` type). All dense decompositions are successfully tested. + +* Most visible fixes: + * #1144: fix regression in `x=y+A*x` (aliasing issue) + * #1140: fix usage of `_mm256_set_m128` and `_mm256_setr_m128` in AVX support + * #1141: fix some missing initializations in CholmodSupport + * #1143: workaround gcc bug #10200 + * #1145, #1147, #1148, #1149: numerous fixes in PastixSupport + * #1153: don't rely on `__GXX_EXPERIMENTAL_CXX0X__` to detect C++11 support. + * #1152: fix data race in static initialization of blas routines. + * fix some buffer overflow in product block size computation. + * #96, #1006: fix by value argument in result_of + * #178: clean several `const_cast`. + * Fix compilation in `ceil()` function. + * #698: fix linspaced for integer types. + * #1161: fix division by zero for huge scalar types in cache block size computation. + * #774: fix a numerical issue in Umeyama algorithm that produced unwanted reflections. + * #901: fix triangular-view with unit diagonal of sparse rectangular matrices. + * #1166: fix shortcoming in gemv when the destination is not a vector at compile-time. + * #1172: make `SparseMatrix::valuePtr` and `innerIndexPtr` properly return null for empty matrices + * #537: fix a compilation issue in Quaternion with Apples's compiler + * #1186: fix usage of `vreinterpretq_u64_f64` (NEON) + * #1190: fix usage of `__ARM_FEATURE_FMA` on Clang/ARM + * #1189: fix pow/atan2 compilation for `AutoDiffScalar` + * Fix detection of same input-output when applied permutations, or on solve operations. + * Workaround a division by zero in triangular solve when outerstride==0 + * Fix compilation of s`parse.cast<>().transpose()`. + * Fix double-conversion warnings throughout the code. + * #1207: fix logical-op warnings + * #1222, #1223: fix compilation in `AutoDiffScalar`. + * #1229: fix usage of `Derived::Options` in MatrixFunctions. + * #1224: fix regression in `(dense*dense).sparseView()`. + * #1231: fix compilation regression regarding complex_array/=real_array. + * #1221: disable gcc 6 warning: ignoring attributes on template argument. + * Workaround clang/llvm bug 27908 + * #1236: fix possible integer overflow in sparse matrix product. + * #1238: fix `SparseMatrix::sum()` overload for un-compressed mode + * #1240: remove any assumption on NEON vector types + * Improves support for MKL's PARDISO solver. + * Fix support for Visual 2010. + * Fix support for gcc 4.1. + * Fix support for ICC 2016 + * Various Altivec/VSX fixes: exp, support for clang 3.9, + * #1258: fix compilation of `Map::coeffRef` + * #1249: fix compilation with compilers that do not support `__builtin_prefetch` . + * #1250: fix `pow()` for `AutoDiffScalar` with custom nested scalar type. + +## [3.2.9] - 2016-08-18 + +Changes since 3.2.8: + +* Main fixes and improvements: + * Improve numerical robustness of JacobiSVD (backported from 3.3) + * #1017: prevents underflows in `makeHouseholder` + * Fix numerical accuracy issue in the extraction of complex eigenvalue pairs in real generalized eigenvalue problems. + * Fix support for `vector.homogeneous().asDiagonal()` + * #1238: fix `SparseMatrix::sum()` overload for un-compressed mode + * #1213: workaround gcc linking issue with anonymous enums. + * #1236: fix possible integer overflow in sparse-sparse product + * Improve detection of identical matrices when applying a permutation (e.g., `mat = perm * mat`) + * Fix usage of nesting type in blas_traits. In practice, this fixes compilation of expressions such as `A*(A*A)^T` + * CMake: fixes support of Ninja generator + * Add a StorageIndex typedef to sparse matrices and expressions to ease porting code to 3.3 (see http://eigen.tuxfamily.org/index.php?title=3.3#Index_typedef) + * #1200: make `aligned_allocator` c++11 compatible (backported from 3.3) + * #1182: improve generality of `abs2` (backported from 3.3) + * #537: fix compilation of Quaternion with Apples's compiler + * #1176: allow products between compatible scalar types + * #1172: make `valuePtr` and `innerIndexPtr` properly return null for empty sparse matrices. + * #1170: skip calls to `memcpy`/`memmove` for empty inputs. + +* Others: + * #1242: fix comma initializer with empty matrices. + * Improves support for MKL's PARDISO solver. + * Fix a compilation issue with Pastix solver. + * Add some missing explicit scalar conversions + * Fix a compilation issue with matrix exponential (unsupported MatrixFunctions module). + * #734: fix a storage order issue in unsupported Spline module + * #1222: fix a compilation issue in AutoDiffScalar + * #1221: shutdown some GCC6's warnings. + * #1175: fix index type conversion warnings in sparse to dense conversion. + +## [3.2.8] - 2016-02-16 +Changes since 3.2.7: + +* Main fixes and improvements: + * Make `FullPivLU::solve` use `rank()` instead of `nonzeroPivots()`. + * Add `EIGEN_MAPBASE_PLUGIN` + * #1166: fix issue in matrix-vector products when the destination is not a vector at compile-time. + * #1100: Improve cmake/pkg-config support. + * #1113: fix name conflict with C99's "I". + * Add missing delete operator overloads in `EIGEN_MAKE_ALIGNED_OPERATOR_NEW` + * Fix `(A*B).maxCoeff(i)` and similar. + * Workaround an ICE with VC2015 Update1 x64. + * #1156: fix several function declarations whose arguments were passed by value instead of being passed by reference + * #1164: fix `std::list` and `std::deque` specializations such that our aligned allocator is automatically activatived only when the user did not specified an allocator (or specified the default `std::allocator`). + +* Others: + * Fix BLAS backend (aka MKL) for empty matrix products. + * #1134: fix JacobiSVD pre-allocation. + * #1111: fix infinite recursion in `sparse_column_major.row(i).nonZeros()` (it now produces a compilation error) + * #1106: workaround a compilation issue in Sparse module for msvc-icc combo + * #1153: remove the usage of `__GXX_EXPERIMENTAL_CXX0X__` to detect C++11 support + * #1143: work-around gcc bug in COLAMD + * Improve support for matrix products with empty factors. + * Fix and clarify documentation of Transform wrt `operator*(MatrixBase)` + * Add a matrix-free conjugate gradient example. + * Fix cost computation in CwiseUnaryView (internal) + * Remove custom unaligned loads for SSE. + * Some warning fixes. + * Several other documentation clarifications. + +## [3.3-beta1] - 2015-12-16 + +For a comprehensive list of change since the 3.2 series, see this [page](https://www.eigen.tuxfamily.org/index.php?title=3.3). + +Main changes since 3.3-alpha1: + +* Dense features: + * Add `LU::transpose().solve()` and `LU::adjoint().solve()` API. + * Add `Array::rsqrt()` method as a more efficient shorcut for `sqrt().inverse()`. + * Add `Array::sign()` method for real and complexes. + * Add `lgamma`, `erf`, and `erfc` functions for arrays. + * Add support for row/col-wise `lpNorm()`. + * Add missing `Rotation2D::operator=(Matrix2x2)`. + * Add support for `permutation * homogenous`. + * Improve numerical accuracy in LLT and triangular solve by using true scalar divisions (instead of x * (1/y)). + * Add `EIGEN_MAPBASE_PLUGIN` and `EIGEN_QUATERNION_PLUGIN`. + * #1074: forbid the creation of PlainObjectBase objects. + +* Sparse features: + * Add IncompleteCholesky preconditioner. + * Improve support for [matrix-free iterative solvers](http://eigen.tuxfamily.org/dox/group__MatrixfreeSolverExample.html) + * Extend `setFromTriplets` API to allow passing a functor object controlling how to collapse duplicated entries. + * #918: add access to UmfPack return code and parameters. + * Add support for `dense.cwiseProduct(sparse)`, thus enabling `(dense*sparse).diagonal()` expressions. + * Add support to directly evaluate the product of two sparse matrices within a dense matrix. + * #1064: add support for `Ref`. + * Add supports for real mul/div `sparse` operations. + * #1086: replace deprecated `UF_long` by `SuiteSparse_long`. + * Make `Ref` more versatile. + +* Performance improvements: + * #1115: enable static alignment and thus small size vectorization on ARM. + * Add temporary-free evaluation of `D.nolias() *= C + A*B`. + * Add vectorization of round, ceil and floor for SSE4.1/AVX. + * Optimize assignment into a `Block` by using Ref and avoiding useless updates in non-compressed mode. This make row-by-row filling of a row-major sparse matrix very efficient. + * Improve internal cost model leading to faster code in some cases (see changeset 77ff3386b7d2). + * #1090: improve redux evaluation logic. + * Enable unaligned vectorization of small fixed size matrix products. + +* Misc improvements: + * Improve support for `isfinite`/`isnan`/`isinf` in fast-math mode. + * Make the IterativeLinearSolvers module compatible with MPL2-only mode by defaulting to COLAMDOrdering and NaturalOrdering for ILUT and ILLT respectively. + * Avoid any OpenMP calls if multi-threading is explicitly disabled at runtime. + * Make abs2 compatible with custom complex types. + * #1109: use noexcept instead of throw for C++11 compilers. + * #1100: Improve cmake/pkg-config support. + * Countless improvements and fixes in Tensors module. + +* Most visible fixes: + * #1105: fix default preallocation when moving from compressed to uncompressed mode in SparseMatrix. + * Fix UmfPackLU constructor for expressions. + * Fix degenerate cases in syrk and trsm BLAS API. + * Fix matrix to quaternion (and angleaxis) conversion for matrix expression. + * Fix compilation of sparse-triangular to dense assignment. + * Fix several minor performance issues in the nesting of matrix products. + * #1092: fix iterative solver ctors for expressions as input. + * #1099: fix missing include for CUDA. + * #1102: fix multiple definition linking issue. + * #1088: fix setIdenity for non-compressed sparse-matrix. + * Fix `SparseMatrix::insert`/`coeffRef` for non-empty compressed matrix. + * #1113: fix name conflict with C99's "I". + * #1075: fix `AlignedBox::sample` for runtime dimension. + * #1103: fix NEON vectorization of `complex` multiplication. + * #1134: fix JacobiSVD pre-allocation. + * Fix ICE with VC2015 Update1. + * Improve cmake install scripts. + +## [3.2.7] - 2015-11-05 + +Changes since 3.2.6: + +* Main fixes and improvements: + * Add support for `dense.cwiseProduct(sparse)`. + * Fix a regression regarding `(dense*sparse).diagonal()`. + * Make the `IterativeLinearSolvers` module compatible with MPL2-only mode by defaulting to `COLAMDOrdering` and `NaturalOrdering` for ILUT and ILLT respectively. + * #266: backport support for c++11 move semantic + * `operator/=(Scalar)` now performs a true division (instead of `mat*(1/s)`) + * Improve numerical accuracy in LLT and triangular solve by using true scalar divisions (instead of `mat * (1/s)`) + * #1092: fix iterative solver constructors for expressions as input + * #1088: fix `setIdenity` for non-compressed sparse-matrix + * #1086: add support for recent SuiteSparse versions + +* Others: + * Add overloads for real-scalar times `SparseMatrix` operations. This avoids real to complex conversions, and also fixes a compilation issue with MSVC. + * Use explicit Scalar types for AngleAxis initialization + * Fix several shortcomings in cost computation (avoid multiple re-evaluation in some very rare cases). + * #1090: fix a shortcoming in redux logic for which slice-vectorization plus unrolling might happen. + * Fix compilation issue with MSVC by backporting `DenseStorage::operator=` from devel branch. + * #1063: fix nesting of unsupported/AutoDiffScalar to prevent dead references when computing second-order derivatives + * #1100: remove explicit `CMAKE_INSTALL_PREFIX` prefix to conform to cmake install's `DESTINATION` parameter. + * unsupported/ArpackSupport is now properly installed by make install. + * #1080: warning fixes + +## [3.2.6] - 2015-10-01 + +Changes since 3.2.5: + +* fix some compilation issues with MSVC 2013, including bugs #1000 and #1057 +* SparseLU: fixes to support `EIGEN_DEFAULT_TO_ROW_MAJOR` (#1053), and for empty (#1026) and some structurally rank deficient matrices (#792) +* #1075: fix `AlignedBox::sample()` for Dynamic dimension +* fix regression in AMD ordering when a column has only one off-diagonal non-zero (used in sparse Cholesky) +* fix Jacobi preconditioner with zero diagonal entries +* fix Quaternion identity initialization for non-implicitly convertible types +* #1059: fix `predux_max` for NEON +* #1039: fix some issues when redefining `EIGEN_DEFAULT_DENSE_INDEX_TYPE` +* #1062: fix SelfAdjointEigenSolver for RowMajor matrices +* MKL: fix support for the 11.2 version, and fix a naming conflict (#1067) + * #1033: explicit type conversion from 0 to RealScalar + +## [3.3-alpha1] - 2015-09-04 + +See the [announcement](https://www.eigen.tuxfamily.org/index.php?title=3.3). + +## [3.2.5] - 2015-06-16 + +Changes since 3.2.4: + +* Changes with main impact: + * Improve robustness of SimplicialLDLT to semidefinite problems by correctly handling structural zeros in AMD reordering + * Re-enable supernodes in SparseLU (fix a performance regression in SparseLU) + * Use zero guess in `ConjugateGradients::solve` + * Add `PermutationMatrix::determinant` method + * Fix `SparseLU::signDeterminant()` method, and add a SparseLU::determinant() method + * Allows Lower|Upper as a template argument of CG and MINRES: in this case the full matrix will be considered + * #872: remove usage of std::bind* functions (deprecated in c++11) + +* Numerical robustness improvements: + * #1014: improve numerical robustness of the 3x3 direct eigenvalue solver + * #1013: fix 2x2 direct eigenvalue solver for identical eigenvalues + * #824: improve accuracy of `Quaternion::angularDistance` + * #941: fix an accuracy issue in ColPivHouseholderQR by continuing the decomposition on a small pivot + * #933: improve numerical robustness in RealSchur + * Fix default threshold value in SPQR + +* Other changes: + * Fix usage of `EIGEN_NO_AUTOMATIC_RESIZING` + * Improved support for custom scalar types in SparseLU + * Improve cygwin compatibility + * #650: fix an issue with sparse-dense product and rowmajor matrices + * #704: fix MKL support (HouseholderQR) + * #705: fix handling of Lapack potrf return code (LLT) + * #714: fix matrix product with OpenMP support + * #949: add static assertions for incompatible scalar types in many of the dense decompositions + * #957, #1000: workaround MSVC/ICC compilation issues when using sparse blocks + * #969: fix ambiguous calls to Ref + * #972, #986: add support for coefficient-based product with 0 depth + * #980: fix taking a row (resp. column) of a column-major (resp. row-major) sparse matrix + * #983: fix an alignement issue in Quaternion + * #985: fix RealQZ when either matrix had zero rows or columns + * #987: fix alignement guess in diagonal product + * #993: fix a pitfall with matrix.inverse() + * #996, #1016: fix scalar conversions + * #1003: fix handling of pointers non aligned on scalar boundary in slice-vectorization + * #1010: fix member initialization in IncompleteLUT + * #1012: enable alloca on Mac OS or if alloca is defined as macro + * Doc and build system: #733, #914, #952, #961, #999 + +## [3.2.4] - 2015-01-21 + +Changes since 3.2.3: + +* Fix compilation regression in Rotation2D +* #920: fix compilation issue with MSVC 2015. +* #921: fix utilization of bitwise operation on enums in `first_aligned`. +* Fix compilation with NEON on some platforms. + +## [3.2.3] - 2014-12-16 + +Changes since 3.2.2: + +* Core: + * Enable `Mx0 * 0xN` matrix products. + * #859: fix returned values for vectorized versions of `exp(NaN)`, `log(NaN)`, `sqrt(NaN)` and `sqrt(-1)`. + * #879: tri1 = mat * tri2 was compiling and running incorrectly if tri2 was not numerically triangular. Workaround the issue by evaluating mat*tri2 into a temporary. + * #854: fix numerical issue in SelfAdjointEigenSolver::computeDirect for 3x3 matrices. + * #884: make sure there no call to malloc for zero-sized matrices or for a Ref<> without temporaries. + * #890: fix aliasing detection when applying a permutation. + * #898: MSVC optimization by adding inline hint to const_cast_ptr. + * #853: remove enable_if<> in Ref<> ctor. + +* Dense solvers: + * #894: fix the sign returned by LDLT for multiple calls to `compute()`. + * Fix JacobiSVD wrt underflow and overflow. + * #791: fix infinite loop in JacobiSVD in the presence of NaN. + +* Sparse: + * Fix out-of-bounds memory write when the product of two sparse matrices is completely dense and performed using pruning. + * UmfPack support: fix redundant evaluation/copies when calling `compute()`, add support for generic expressions as input, and fix extraction of the L and U factors (#911). + * Improve `SparseMatrix::block` for const matrices (the generic path was used). + * Fix memory pre-allocation when permuting inner vectors of a sparse matrix. + * Fix `SparseQR::rank` for a completely empty matrix. + * Fix `SparseQR` for row-major inputs. + * Fix `SparseLU::absDeterminant` and add respective unit test. + * BiCGSTAB: make sure that good initial guesses are not destroyed by a bad preconditioner. + +* Geometry: + * Fix `Hyperplane::Through(a,b,c)` when points are aligned or identical. + * Fix linking issues in OpenGLSupport. + +* OS, build system and doc: + * Various compilation fixes including: #821, #822, #857, #871, #873. + * Fix many compilation warnings produced by recent compilers including: #909. + * #861: enable posix_memalign with PGI. + * Fix BiCGSTAB doc example. + +## [3.2.2] - 2014-08-04 + +Changes since 3.2.1: + +* Core: + * Relax Ref such that `Ref` accepts a `RowVectorXf` which can be seen as a degenerate `MatrixXf(1,N)` + * Fix performance regression for the vectorization of sub columns/rows of matrices. + * `EIGEN_STACK_ALLOCATION_LIMIT`: Raise its default value to 128KB, make use of it to assert on maximal fixed size object, and allows it to be 0 to mean "no limit". + * #839: Fix 1x1 triangular matrix-vector product. + * #755: `CommaInitializer` produced wrong assertions in absence of Return-Value-Optimization. + +* Dense solvers: + * Add a `rank()` method with threshold control to JacobiSVD, and make solve uses it to return the minimal norm solution for rank-deficient problems. + * Various numerical fixes in JacobiSVD, including:#843, and the move from Lapack to Matlab strategy for the default threshold. + * Various numerical fixes in LDLT, including the case of semi-definite complex matrices. + * Fix `ColPivHouseholderQR::rank()`. + * #222: Make temporary matrix column-major independently of `EIGEN_DEFAULT_TO_ROW_MAJOR` in BlockHouseholder. + +* Sparse: + * #838: Fix `dense * sparse` and `sparse * dense` outer products and detect outer products from either the lhs or rhs. + * Make the ordering method of SimplicialL[D]LT configurable. + * Fix regression in the restart mechanism of BiCGSTAB. + * #836: extend SparseQR to support more columns than rows. + * #808: Use double instead of float for the increasing size ratio in `CompressedStorage::resize`, fix implicit conversions from int/longint to float/double, and fix `set_from_triplets` temporary matrix type. + * #647: Use `smart_copy` instead of bitwise memcpy in CompressedStorage. + * GMRES: Initialize essential Householder vector with correct dimension. + +* Geometry: + * #807: Missing scalar type cast in `umeyama()` + * #806: Missing scalar type cast in `Quaternion::setFromTwoVectors()` + * #759: Removed hard-coded double-math from `Quaternion::angularDistance`. + +* OS, build system and doc: + * Fix compilation with Windows CE. + * Fix some ICEs with VC11. + * Check IMKL version for compatibility with Eigen + * #754: Only inserted (`!defined(_WIN32_WCE)`) analog to alloc and free implementation. + * #803: Avoid `char*` to `int*` conversion. + * #819: Include path of details.h file. + * #738: Use the "current" version of cmake project directories to ease the inclusion of Eigen within other projects. + * #815: Fix doc of FullPivLU wrt permutation matrices. + * #632: doc: Note that `dm2 = sm1 + dm1` is not possible + * Extend AsciiQuickReference (real, imag, conjugate, rot90) + +## [3.2.1] - 2014-02-26 + +Changes since 3.2.0: + +* Eigen2 support is now deprecated and will be removed in version 3.3. +* Core: + * Bug fix for Ref object containing a temporary matrix. + * #654: Allow construction of row vector from 1D array. + * #679: Support `cwiseMin()` and `cwiseMax()` on maps. + * Support `conservativeResize()` on vectors. + * Improve performance of vectorwise and replicate expressions. + * #642: Add vectorization of sqrt for doubles, and make sqrt really safe if `EIGEN_FAST_MATH` is disabled. + * #616: Try harder to align columns when printing matrices and arrays. + * #579: Add optional run-time parameter to fixed-size block methods. + * Implement `.all()` and `.any()` for zero-sized objects + * #708: Add placement new and delete for arrays. + * #503: Better C++11 support. +* Dense linear algebra: + * #689: Speed up some matrix-vector products by using aligned loads if possible. + * Make solve in `FullPivHouseholderQR` return least-square solution if there is no exact solution. + * #678: Fix `fullPivHouseholderQR` for rectangular matrices. + * Fix a 0/0 issue in JacobiSVD. + * #736: Wrong result in `LDLT::isPositiveDefinite()` for semi-definite matrices. + * #740: Fix overflow issue in `stableNorm()`. + * Make pivoting HouseholderQR compatible with custom scalar types. +* Geometry: + * Fix compilation of Transform * UniformScaling +* Sparse matrices: + * Fix elimination tree and SparseQR for fat rectangular matrices. + * #635: add `isCompressed` to `MappedSparseMatrix` for compatibility. + * #664: Support iterators without `operator<` in `setFromTriplets()`. + * Fixes in SparseLU: infinite loop, aliasing issue when solving, overflow in memory allocation, use exceptions only if enabled (#672). + * Fixes in SparseQR: reduce explicit zero, assigning result to map, assert catching non-conforming sizes, memory leak. + * #681: Uninitialized value in CholmodSupport which may lead to incorrect results. + * Fix some issues when using a non-standard index type (#665 and more) + * Update constrained CG (unsupported module) to Eigen3. +* OS and build system: + * MacOS put OpenGL header files somewhere else from where we expected it. + * Do not assume that `alloca()` is 16-byte aligned on Windows. + * Compilation fixes when using ICC with Visual Studio. + * Fix Fortran compiler detection in CMake files. +* Fix some of our tests (bugs #744 and #748 and more). +* Fix a few compiler warnings (bug #317 and more). +* Documentation fixes (bugs #609, #638 and #739 and more). + +## [3.1.4] - 2013-08-02 + +Changes since 3.1.3: + +* #620: Fix robustness and performance issues in JacobiSVD::solve. +* #613: Fix accuracy of SSE sqrt for very small numbers. +* #608: Fix sign computation in LDLT. +* Fix write access to CwiseUnaryView expressions. +* Fix compilation of `transposeInPlace()` for Array expressions. +* Fix non const `data()` member in Array and Matrix wrappers. +* Fix a few warnings and compilation issues with recent compiler versions. +* Documentation fixes. + +## [3.0.7] - 2013-08-02 + +Changes since 3.0.6: + +* Fix traits of `Map`. +* Fix a few warnings (#507) and documentation (#531). + +## [3.2.0] - 2013-07-24 + +Major new features and optimizations since 3.1: + +* Dense world + * New [`Ref<>`](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1Ref.html) class allowing to write non templated function taking various kind of Eigen dense objects without copies. + * New [RealQZ](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1RealQZ.html) factorization and [GeneralizedEigenSolver](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1GeneralizedEigenSolver.html). + * Add vector-wise normalized and normalize functions, and hasNaN/allFinite members. + * Add mixed static/dynamic-size `.block<.,.>()` functions. + * Optimize outer products for non rank-1 update operations. + * Optimize diagonal products (enable vectorization in more cases). + * Improve robustness and performance in `JacobiSVD::solve()`. +* Sparse world + * New [SparseLU](http://eigen.tuxfamily.org/dox-devel/group__SparseLU__Module.html) module: built-in sparse LU with supernodes and numerical row pivoting (port of SuperLU making the SuperLUSupport module obsolete). + * New [SparseQR](http://eigen.tuxfamily.org/dox-devel/group__SparseQR__Module.html) module: rank-revealing sparse QR factorization with numerical column pivoting. + * New [COLAMD](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1COLAMDOrdering.html) ordering and unified [ordering API](http://eigen.tuxfamily.org/dox-devel/group__OrderingMethods__Module.html). + * Add support for generic blocks of sparse matrices (read-only). + * Add conservative resize feature on sparse matrices. + * Add uniform support for solving sparse systems with sparse right hand sides. + * Add support for sparse matrix time sparse self-adjoint view products. + * Improve BiCGSTAB robustness with restart. +* Support to external libraries + * New [MetisSupport](http://eigen.tuxfamily.org/dox-devel/group__MetisSupport__Module.html) module: wrapper to the famous graph partitioning library. + * New [SPQRSupport](http://eigen.tuxfamily.org/dox-devel/group__SPQRSupport__Module.html) module: wrapper to suitesparse's supernodal QR solver. + +Eigen 3.2 represents about 600 commits since Eigen 3.1. + +## [3.2-rc2] - 2013-07-19 + +Changes since 3.2-rc1: + +* Rename `DenseBase::isFinite()` to `allFinite()` to avoid a future naming collision. +* Fix an ICE with ICC 11.1. + +## [3.2-rc1] - 2013-07-17 + +Main changes since 3.2-beta1: +* New features: + * #562: Add vector-wise normalized and normalize functions. + * #564: Add `hasNaN` and `isFinite` members. + * #579: Add support for mixed static/dynamic-size `.block()`. + * #588: Add support for determinant in SparseLU. + * Add support in SparseLU to solve with L and U factors independently. + * Allow multiplication-like binary operators to be applied on type combinations supported by `scalar_product_traits`. + * #596: Add conversion from `SparseQR::matrixQ()` to a `SparseMatrix`. + * #553: Add support for sparse matrix time sparse self-adjoint view products. + +* Accuracy and performance: + * Improve BiCGSTAB robustness: fix a divide by zero and allow to restart with a new initial residual reference. + * #71: Enable vectorization of diagonal products in more cases. + * #620: Fix robustness and performance issues in JacobiSVD::solve. + * #609: Improve accuracy and consistency of the eulerAngles functions. + * #613: Fix accuracy of SSE sqrt for very small numbers. + * Enable SSE with ICC even when it mimics a gcc version lower than 4.2. + * Add SSE4 min/max for integers. + * #590 & #591: Minor improvements in NEON vectorization. + +* Bug fixes: + * Fix `HouseholderSequence::conjugate()` and `::adjoint()`. + * Fix SparseLU for dense matrices and matrices in non compressed mode. + * Fix `SparseMatrix::conservativeResize()` when one dimension is null. + * Fix `transposeInpPlace` for arrays. + * Fix `handmade_aligned_realloc`. + * #554: Fix detection of the presence of `posix_memalign` with mingw. + * #556: Workaround mingw bug with `-O3` or `-fipa-cp-clone` options. + * #608: Fix sign computation in LDLT. + * #567: Fix iterative solvers to immediately return when the initial guess is the true solution and for trivial solution. + * #607: Fix support for implicit transposition from dense to sparse vectors. + * #611: Fix support for products of the form `diagonal_matrix * sparse_matrix * diagonal_matrix`. + +* Others: + * #583: Add compile-time assertion to check DenseIndex is signed. + * #63: Add lapack unit tests. They are automatically downloaded and configured if `EIGEN_ENABLE_LAPACK_TESTS` is ON. + * #563: Assignment to `Block` is now allowed on non-compressed matrices. + * #626: Add assertion on input ranges for coeff* and insert members for sparse objects. + * #314: Move special math functions from internal to numext namespace. + * Fix many warnings and compilation issues with recent compiler versions. + * Many other fixes including #230, #482, #542, #561, #564, #565, #566, #578, #581, #595, #597, #598, #599, #605, #606, #615. + +## [3.1.3] - 2013-04-16 +Changes since 3.1.2: + +* #526 - Fix linear vectorized transversal in linspace. +* #551 - Fix compilation issue when using `EIGEN_DEFAULT_DENSE_INDEX_TYPE`. +* #533 - Fix some missing const qualifiers in Transpose +* Fix a compilation with CGAL::Gmpq by adding explicit internal:: namespace when calling `abs()`. +* Fix computation of outer-stride when calling `.real()` or `.imag()`. +* Fix `handmade_aligned_realloc` (affected `conservativeResize()`). +* Fix sparse vector assignment from a sparse matrix. +* Fix `log(0)` with SSE. +* Fix bug in aligned_free with windows CE. +* Fix traits of `Map`. +* Fix a few warnings (#507, #535, #581). +* Enable SSE with ICC even when it mimics a gcc version lower than 4.2 +* Workaround [gcc-4.7 bug #53900](http://gcc.gnu.org/bugzilla/show_bug.cgi?id=53900) (too aggressive optimization in our alignment check) + +## [3.2-beta1] - 2013-03-07 + +Main changes since 3.1: + +* Dense modules + * A new [`Ref<>`](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1Ref.html) class allowing to write non templated function taking various kind of Eigen dense objects without copies. + * New [RealQZ](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1RealQZ.html) factorization and [GeneralizedEigenSolver](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1GeneralizedEigenSolver.html) + * Optimized outer products for non rank-1 update operations. + +* Sparse modules + * New [SparseLU](http://eigen.tuxfamily.org/dox-devel/group__SparseLU__Module.html) module: built-in sparse LU with supernodes and numerical row pivoting (port of SuperLU making the SuperLUSupport module obsolete). + * New [SparseQR](http://eigen.tuxfamily.org/dox-devel/group__SparseQR__Module.html) module: rank-revealing sparse QR factorization with numerical column pivoting. + * OrderingMethods: extended with [COLAMD](http://eigen.tuxfamily.org/dox-devel/classEigen_1_1COLAMDOrdering.html) ordering and a unified [ordering](http://eigen.tuxfamily.org/dox-devel/group__OrderingMethods__Module.html) API. + * Support for generic blocks of sparse matrices. + * Add conservative resize feature on sparse matrices. + * Add uniform support for solving sparse systems with sparse right hand sides. + +* Support to external libraries + * New [MetisSupport](http://eigen.tuxfamily.org/dox-devel/group__MetisSupport__Module.html) module: wrapper to the famous graph partitioning library. + * New [SPQRSupport](http://eigen.tuxfamily.org/dox-devel/group__SPQRSupport__Module.html) module: wrapper to suitesparse's supernodal QR solver. + +* Misc + * Improved presentation and clarity of Doxygen generated documentation (modules are now organized into chapters, treeview panel and search engine for quick navagitation). + * New compilation token `EIGEN_INITIALIZE_MATRICES_BY_NAN` to help debugging. + * All bug fixes of the 3.1 branch, plus a couple of other fixes (including 211, 479, 496, 508, 552) + +## [3.1.2] - 2012-11-05 + +Changes since 3.1.1: + +* #524 - Pardiso's parameter array does not have to be aligned! +* #521 - Disable `__cpuidex` on architectures different that x86 or x86-64 with MSVC. +* #519 - `AlignedBox::dim()` was wrong for dynamic dimensions. +* #515 - Fix missing explicit scalar conversion. +* #511 - Fix pretty printers on windows. +* #509 - Fix warnings with gcc 4.7 +* #501 - Remove aggressive mat/scalar optimization (was replaced by `mat*(1/scalar)` for non integer types). +* #479 - Use EISPACK's strategy re max number of iters in Schur decomposition. +* Add support for scalar multiple of diagonal matrices. +* Forward `resize()` function from Array/Matrix wrappers to the nested expression such that `mat.array().resize(a,b)` is now allowed. +* Windows CE: fix the lack of the `aligned_malloc` function on this platform. +* Fix comma initializer when inserting empty matrices. +* Fix `dense=sparse*diagonal` products. +* Fix compilation with `m.array().min(scalar)` and `m.array().max(scalar)`. +* Fix out-of-range memory access in GEMV (the memory was not used for the computation, only to assemble unaligned packets from aligned packet loads). +* Fix various regressions with MKL support. +* Fix aliasing issue in sparse matrix assignment. +* Remove stupid assert in blue norm. +* Workaround a weird compilation error with MSVC. + +## [3.1.1] - 2012-07-22 + +Changes since 3.1.0: +* [relicense to MPL2](https://www.eigen.tuxfamily.org/index.php?title=Main_Page#License) +* add a `EIGEN_MPL2_ONLY` build option to generate compiler errors when including non-MPL2 modules +* remove dynamic allocation for triangular matrix-matrix products of fixed size objects +* Fix possible underflow issues in SelfAdjointEigenSolver +* Fix issues with fixed-size Diagonal (sub/super diagonal size computation was wrong) +* #487 - Geometry module: `isometry * scaling` compilation error +* #486 - MKL support: fixed multiple-references linker errors with various decompositions +* #480 - work around compilation error on Android NDK due to isfinite being defined as a macro +* #485 - IterativeLinearSolvers: conflict between a typedef and template type parameter +* #479 - Eigenvalues/Schur: Adjust max iterations count to matrix size +* Fixed Geometry module compilation under MSVC +* Fixed Sparse module compilation under MSVC 2005 + +## [3.0.6] - 2012-07-09 +Changes since 3.0.5: +* #447 - fix infinite recursion in `ProductBase::coeff()` +* #478 - fix RealSchur on a zero matrix +* #477 - fix warnings with gcc 4.7 +* #475 - `.exp()` now returns `+inf` when overflow occurs (SSE) +* #466 - fix a possible race condition in OpenMP environment (for non OpenMP thread model it is recommended to upgrade to 3.1) +* #362 - fix missing specialization for affine-compact `*` projective +* #451 - fix a clang warning +* Fix compilation of `somedensematrix.llt().matrixL().transpose()` +* Fix miss-use of the cost-model in Replicate +* Fix use of int versus Index types for `Block::m_outerStride` +* Fix ambiguous calls to some std functions +* Fix geometry tutorial on scalings +* Fix RVCT 3.1 compiler errors +* Fix implicit scalar conversion in Transform +* Fix typo in NumericalDiff (unsupported module) +* Fix LevenbergMarquart for non double scalar type (unsupported module) + +## [3.1.0] - 2012-06-24 + +Major changes between Eigen 3.0 and Eigen 3.1: +* New features + * **New set of officially supported Sparse Modules** + ** This includes sparse matrix storage, assembly, and many built-in (Cholesky, CG, BiCGSTAB, ILU), and third-party (PaStiX, Cholmod, UmfPack, SuperLU, Pardiso) solvers + ** See this [page](http://eigen.tuxfamily.org/dox-devel/TutorialSparse.html) for an overview of the features + * **Optional support for Intel MKL** + ** This includes the BLAS, LAPACK, VML, and Pardiso components + ** See this [page](http://eigen.tuxfamily.org/dox-devel/TopicUsingIntelMKL.html) for the details + * Core + ** New vector-wise operators: `*`, `/`, `*=`, `/=` + ** New coefficient-wise operators: `&&`, `||`, `min(Scalar)`, `max(Scalar)`, `pow`, `operator/(Scalar,ArrayBase)` + * Decompositions + ** Add incremental rank-updates in LLTand LDLT + ** New `SelfAdjointEigenSolver::computeDirect()` function for fast eigen-decomposition through closed-form formulas (only for 2x2 and 3x3 real matrices) +* Optimizations + * Memory optimizations in JacobiSVD and triangular solves. + * Optimization of reductions via partial unrolling (e.g., dot, sum, norm, etc.) + * Improved performance of small matrix-matrix products and some Transform<> operations + +Eigen 3.1 represents about 600 commits since Eigen 3.0. + +## [3.1.0-rc2] - 2012-06-21 + +Changes since 3.1.0-rc1: +* Fix a couple of compilation warnings +* Improved documentation, in particular regarding the Geometry and Sparse tutorials, and sparse solver modules +* Fix double preconditioner allocation in `JacobiSVD` +* #466: `RealSchur` failed on a zero matrix +* Update Adolc and MPReal support modules + +## [3.1.0-rc1] - 2012-06-14 + +Main changes since 3.1.0-beta1: +* #466: fix a possible race condition issue. from now, multithreaded applications that call Eigen from multiple thread must initialize Eigen by calling `initParallel()`. +* For consistency, `SimplicialLLT` and `SimplicialLDLT` now factorizes `P A P^-1` (instead of `P^-1 A P`). +* #475: now the vectorized `exp` operator returns +inf when overflow occurs +* Fix the use of MKL with MSVC by disabling MKL's pow functions. +* Avoid dynamic allocation for fixed size triangular solving +* Fix a compilation issue with ICC 11.1 +* Fix ambiguous calls in the math functors +* Fix BTL interface. + +## [3.1.0-beta1] - 2012-06-07 + +Main changes since 3.1.0-alpha2: +* **API changes** + * `SimplicialLLt` and `SimplicialLDLt` are now renamed `SimplicialLLT` and `SimplicialLDLT` for consistency with the other modules. + * The Pardiso support module is now spelled "PardisoSupport" +* Dense modules: + * Add `operator/(Scalar,ArrayBase)` and coefficient-wise pow operator. + * Fix automatic evaluation of expressions nested by Replicate (performance improvement) + * #447 - fix infinite recursion in `ProductBase::coeff()` + * #455 - add support for c++11 in `aligned_allocator` + * `LinSpace`: add a missing variant, and fix the size=1 case +* Sparse modules: + * Add an **IncompleteLU** preconditioner with dual thresholding. + * Add an interface to the parallel **Pastix** solver + * Improve applicability of permutations (add `SparseMatrixBase::twistedBy`, handle non symmetric permutations) + * `CholmodDecomposition` now has explicit variants: `CholmodSupernodalLLT`, `CholmodSimplicialLLT`, `CholmodSimplicialLDLT` + * Add analysePattern/factorize methods to iterative solvers + * Preserve explicit zero in a sparse assignment + * Speedup `sparse * dense` products + * Fix a couple of issues with Pardiso support +* Geometry module: + * Improve performance of some `Transform<>` operations by better preserving the alignment status. + * #415 - wrong return type in `Rotation2D::operator*=` + * #439 - add `Quaternion::FromTwoVectors()` static constructor + * #362 - missing specialization for affine-compact `*` projective +* Others: + * add support for RVCT 3.1 compiler + * New tutorial page on Map + * and many other bug fixes such as: #417, #419, #450 + +## [3.0.5] - 2012-02-10 + +Changes since 3.0.4: +* #417 - fix nesting of `Map` expressions +* #415 - fix return value of `Rotation2D::operator*=` +* #410 - fix a possible out of range access in `EigenSolver` +* #406 - fix infinite loop/deadlock when using OpenMP and Eigen +* Changeset 4462 - fix broken asserts revealed by Clang +* Changeset 4457 - fix description of `rankUpdate()` in quick reference guide +* Changeset 4455 - fix out-of-range int constant in 4x4 inverse +* #398 - fix in slerp: the returned quaternion was not always normalized +* Changeset 4432 - fix asserts in eigenvalue decompositions +* Changeset 4416 - fix MSVC integer overflow warning + +## [3.1.0-alpha2] - 2012-02-06 + +Main changes since 3.0.1-alpha1: +* New optional support for Intel MKL and other BLAS including: ([details](http://eigen.tuxfamily.org/dox-devel/TopicUsingIntelMKL.html)) + * BLAS (arbitrary BLAS) + * Intel LAPACKE + * Intel VML (coefficient-wise math operations) + * Intel PARDISO (sparse direct solver) +* Dense modules: + * improved performance of small matrix-matrix products + * Feature #319 - add a rankUpdate function to LDLt and LLT for updates/downdates + * Feature #400 - new coefficient wise min/max functions taking one scalar argument +* Sparse modules: + * new fast sparse matrix assembly interface from a random list of triplets (see `SparseMatrix::setFromTriplets()`) + * new shifting feature in SimplicialCholesky (see `SimplicialCholeskyBase::setShift()`) + * add checks for positive definiteness in SimplicialCholesky + * improved heuristic to predict the nnz of a `sparse*sparse` product + * add support for uncompressed SparseMatrix in CholmodSupport +* Geometry module: + * Feature #297 - add `ParametrizedLine::intersectionPoint()` and `intersectionParam()` functions +* Others: + * fix many warnings and compilation issues with ICC 12 and -strict-ansi + * fix some ICE with MSVC10 + * add the possibility to disable calls to cpuid (`-DEIGEN_NO_CPUID`) and other asm directives + * and many other bug fixes such as: #406, #410, #398, #396, #394, #354, #352, #301, + + +## [3.1.0-alpha1] - 2011-12-06 + +Main changes since 3.0: +* Officially supported set of sparse modules. See this [page](http://eigen.tuxfamily.org/dox-devel/TutorialSparse.html) for an overview of the features. Main changes: + * new `SparseCore` module equivalent to the old `Sparse` module, the `Sparse` module is now a super module including all sparse-related modules + * the `SparseMatrix` class is now more versatile and supports an uncompressed mode for fast element insertion + * the `SparseMatrix` class now offer a unique and simplified API to insert elements + * `DynamicSparseMatrix` has been deprecated (moved into `unsupported/SparseExtra`) + * new conservative `sparse * sparse` matrix product which is also used by default + * new `SparseCholesky` module featuring the SimplicialLLT and SimplicialLDLT built-in solvers + * new `IterativeLinearSolvers` module featuring a conjugate gradient and stabilized bi-conjugate gradient iterative solvers with a basic Jacobi preconditioner +* New `SelfAdjointEigenSolver::computeDirect()` function for fast eigen-decomposition through closed-form formulas (only for 2x2 and 3x3 real matrices) +* New `LLT::rankUpdate()` function supporting both updates and down-dates +* Optimization of reduction via partial unrolling (e.g., dot, sum, norm, etc.) +* New coefficient-wise operators: `&&` and `||` +* Feature #157 - New vector-wise operations for arrays: `*`, `/`, `*=`, and `/=`. +* Feature #206 - Pre-allocation of intermediate buffers in JacobiSVD +* Feature #370 - New typedefs for AlignedBox +* All the fixes and improvements of the 3.0 branch up to the 3.0.4 release (see below) + + +## [3.0.4] - 2011-12-06 +Changes since 3.0.3: + +* #363 - check for integer overflow in size computations +* #369 - Quaternion alignment is broken (and more alignment fixes) +* #354 - Converge better in SelfAdjointEigenSolver, and allow better handling of non-convergent cases +* #347 - Fix compilation on ARM NEON with LLVM 3.0 and iOS SDK 5.0 +* #372 - Put unsupported modules documentation at the right place +* #383 - Fix C++11 compilation problem due to some constructs mis-interpreted as c++11 user-defined literals +* #373 - Compilation error with clang 2.9 when exceptions are disabled +* Fix compilation issue with `QuaternionBase::cast` + + +## [2.0.17] - 2011-12-06 + +Changes since 2.0.16: + +* Fix a compilation bug in `aligned_allocator`: the allocate method should take a void pointer +* Fix a typo in ParametrizedLine documentation + + +## [3.0.3] - 2011-10-06 + +Changes since 3.0.2: + +* Fix compilation errors when Eigen2 support is enabled. +* Fix bug in evaluating expressions of the form `matrix1 * matrix2 * scalar1 * scalar2`. +* Fix solve using LDLT for singular matrices if solution exists. +* Fix infinite loop when computing SVD of some matrices with very small numbers. +* Allow user to specify pkgconfig destination. +* Several improvements to the documentation. + + +## [3.0.2] - 2011-08-26 + +Changes since 3.0.1: + +* `Windows.h`: protect min/max calls from macros having the same name (no need to `#undef` min/max anymore). +* MinGW: fix compilation issues and pretty gdb printer. +* Standard compliance: fix aligned_allocator and remove uses of long long. +* MPReal: updates for the new version. +* Other fixes: + * fix aligned_stack_memory_handler for null pointers. + * fix std::vector support with gcc 4.6. + * fix linking issue with OpenGL support. + * fix SelfAdjointEigenSolver for 1x1 matrices. + * fix a couple of warnings with new compilers. + * fix a few documentation issues. + + +## [3.0.1] - 2011-05-30 + +Changes since 3.0.0: + +* Fix many bugs regarding ARM and NEON (Now all tests succeed on ARM/NEON). +* Fix compilation on gcc 4.6 +* Improved support for custom scalar types: + * Fix memory leak issue for scalar types throwing exceptions. + * Fix implicit scalar type conversion. + * Math functions can be defined in the scalar type's namespace. +* Fix bug in trapezoidal matrix time matrix product. +* Fix asin. +* Fix compilation with MSVC 2005 (SSE was wrongly enabled). +* Fix bug in `EigenSolver`: normalize the eigen vectors. +* Fix Qt support in Transform. +* Improved documentation. + +## [2.0.16] - 2011-05-28 + +Changes since 2.0.15: + +* Fix bug in 3x3 tridiagonlisation (and consequently in 3x3 selfadjoint eigen decomposition). +* Fix compilation for new gcc 4.6. +* Fix performance regression since 2.0.12: in some matrix-vector product, complex matrix expressions were not pre-evaluated. +* Fix documentation of Least-Square. +* New feature: support for `part`. +* Fix bug in SparseLU::setOrderingMethod. + +## [3.0.0] - 2011-03-19 + +Released at the [meeting](https://www.eigen.tuxfamily.org/index.php?title=Paris_2011_Meeting). + +See the [Eigen 3.0 release notes](https://www.eigen.tuxfamily.org/index.php?title=3.0). + +Only change since 3.0-rc1: +* Fixed compilation of the unsupported 'openglsupport' test. + +## [3.0-rc1] - 2011-03-14 + +Main changes since 3.0-beta4: + +* Core: added new `EIGEN_RUNTIME_NO_MALLOC` option and new `set_is_malloc_allowed()` option to finely control where dynamic memory allocation is allowed. Useful for unit-testing of functions that must not cause dynamic memory allocations. +* Core: SSE performance fixes (follow-up from #203). +* Core: Fixed crashes when using `EIGEN_DONT_ALIGN` or `EIGEN_DONT_ALIGN_STATICALLY` (#213 and friends). +* Core: `EIGEN_DONT_ALIGN` and `EIGEN_DONT_ALIGN_STATICALLY` are now covered by unit tests. +* Geometry: Fixed transform * matrix products (#207). +* Geometry: compilation fix for mixing CompactAffine with Homogeneous objects +* Geometry: compilation fix for 1D transform +* SVD: fix non-computing constructors (correctly forward `computationOptions`) (#206) +* Sparse: fix resizing when the destination sparse matrix is row major (#37) +* more Eigen2Support improvements +* more unit test fixes/improvements +* more documentation improvements +* more compiler warnings fixes +* fixed GDB pretty-printer for dynamic-size matrices (#210) + +## [3.0-beta4] - 2011-02-28 + +Main changes since 3.0-beta3: + +* Non-vectorization bug fixes: + * fix #89: work around an extremely evil compiler bug on old GCC (<= 4.3) with the standard `assert()` macro + * fix Umfpack back-end in the complex case +* Vectorization bug fixes: + * fix a segfault in "slice vectorization" when the destination might not be aligned on a scalar (`complex`) + * fix #195: fast SSE unaligned loads fail on GCC/i386 and on Clang + * fix #186: worked around a GCC 4.3 i386 backend issue with SSE + * fix #203: SSE: a workaround used in pset1() resulted in poor assembly + * worked around a GCC 4.2.4 internal compiler error with vectorization of complex numbers + * lots of AltiVec compilation fixes + * NEON compilation fixes +* API additions and error messages improvements + * Transform: prevent bad user code from compiling + * fix #190: directly pass Transform Options to Matrix, allowing to use RowMajor. Fix issues in Transform with non-default Options. + * factorize implementation of standard real unary math functions, and add acos, asin +* Build/tests system + * Lots of unit test improvements + * fix installation of unsupported modules + * fixed many compiler warnings, especially on the Intel compiler and on LLVM/Clang + * CTest/CMake improvements + * added option to build in 32bit mode +* BLAS/LAPACK implementation improvements + * The Blas library and tests are now automatically built as part of the tests. + * expanded LAPACK interface (including syev) + * now Sparse solver backends use our own BLAS/LAPACK implementation + * fix #189 (cblat1 test failure) +* Documentation + * improved conservativeResize methods documentation + * documented sorting of eigenvalues + * misc documentation improvements + * improve documentation of plugins + +## [3.0-beta3] - 2011-02-12 + +The biggest news is that the API is now **100% stable**. + +Main changes since 3.0-beta2: + +* The "too many to list them all" category: + * lots of bug fixes + * lots of performance fixes + * lots of compiler support fixes + * lots of warning fixes + * lots of unit tests improvements and fixes + * lots of documentation improvements + * lots of build system fixes +* API changes: + * replaced `ei_` prefix by `internal::` namespace. For example, `ei_cos(x)` becomes `internal::cos(x)`. + * renamed `PlanarRotation` -> `JacobiRotation` + * renamed `DenseStorageBase` -> `PlainObjectBase` + * HouseholderSequence API cleanup + * refactored internal metaprogramming helpers to follow closely the standard library + * made UpperBidiagonalization internal + * made BandMatrix/TridiagonalMatrix internal + * Core: also see below, "const correctness". + * Sparse: `EIGEN_YES_I_KNOW_SPARSE_MODULE_IS_NOT_STABLE_YET` must be defined to use Eigen/Sparse + * Core: `random()` now spans over range of width `RAND_MAX` +* New API: + * Core: added Map static methods taking strides + * SVD: added `jacobiSvd()` method + * Sparse: many misc improvements and new features. Improved support for Cholmod, Amd, SuperLU and other back-ends. + * Core: allow mixed real-complex dot products + * Geometry: allow mixed real-complex cross products + * Geometry: allow to pass Options parameters to Transform, Quaternion and other templates, to control memory alignment + * QR: add threshold API to FullPivHouseholderQR + * Core: added tan function +* Const correctness: + * Eigen now properly enforces const-correctness everywhere, for example with Map objects. This will break compilation of code that relied on former behavior. + * A new kind of test suite was added to check that, 'failtest'. +* BLAS/LAPACK: + * Complete BLAS library built on top of Eigen. Imported BLAS test suite, which allowed to fix many issues. + * Partial LAPACK implementation. Passing part of the LAPACK test suite, which also allowed to fix some issues. +* Eigen 2 Support: + * tons of improvements in `EIGEN2_SUPPORT` + * new incremental migration path: see http://eigen.tuxfamily.org/dox-devel/Eigen2SupportModes.html + * imported a copy of the Eigen 2 test suite, made sure that Eigen 3 passes it. That also allowed to fix several issues. + + +## [3.0-beta2] - 2010-10-15 + +Main changes since 3.0-beta1: + +* Add support for the vectorization of `std::complex<>` with SSE, AltiVec and NEON. +* Add support for mixed `real * complex` matrix products with vectorization. +* Finalize the JacobiSVD class with: compile time options, thin/full decompositions, and least-square solving. +* Several improvement of the Transform class. In particular, there is no default mode anymore. +* New methods: `middleRows()`, `middleCols()`, `TriangularMatrix::conjugate()` +* New unsupported modules: OpenGL, MPFR C++ +* Many improvements in the support of empty objects. +* Many improvements of the vectorization logic. +* Add the possibility to extend QuaternionBase. +* Vectorize Quaternion multiplication with double. +* Significant improvements of the documentation. +* Improved compile time errors. +* Enforce static allocation of temporary buffers in gemm (when possible). +* Fix aligned_delete for null pointers and non trivial dtors. +* Fix eigen decomposition of 3x3 float matrices. +* Fix 4x4 matrix inversions (vectorization). +* Many fixes in QR: solving with `m>n`, use of rank, etc. +* Fixes for MSVC for windows mobile and CLang. +* Remove the Taucs backend (obsolete). +* Remove the old SVD class (was causing too much troubles, a new decompozition based on bidiagonalisation/householder should come back soon, `JacobiSVD` can be used meanwhile). + +## [2.0.15] - 2010-07-16 + +Changes since 2.0.14: + +* Fix bug: certain cases of matrix-vector product (depending on storage order) were blocked by an assertion failure. +* Fix LU and QR solve when rank==0, fix LLT when the matrix is purely 0. +* Fix a couple of bugs with QR solving especially with rows>cols. +* Fix bug with custom scalar types that have non-trivial destructor. +* Fix for ICC in SSE code. +* Fix some C++ issues found by Clang (patch by Nick Lewycky). + +## [3.0-beta1] - 2010-07-05 + +See the [announcement](https://www.eigen.tuxfamily.org/index.php?title=3.0). + +## [2.0.14] - 2010-06-22 + +Changes since 2.0.13: + +* Fix #141: crash in SSE (alignment problem) when using dynamic-size matrices with a max-size fixed at compile time that is not a multiple of 16 bytes. For example, `Matrix`. +* Fix #142: LU of fixed-size matrices was causing dynamic memory allocation (patch by Stuart Glaser). +* Fix #127: remove useless static keywords (also fixes warnings with clang++). + +## [2.0.13] - 2010-06-10 + +Changes since 2.0.12: + +* Fix #132: crash in certain matrix-vector products. Unit test added. +* Fix #125: colwise `norm()` and `squaredNorm()` on complex types do not return real types +* Fully support the QCC/QNX compiler (thanks to Piotr Trojanek). The support in 2.0.12 was incomplete. The whole test suite is now successful. +* As part of the QCC support work, a lot of standards compliance work: put `std::` in front of a lot of things such as `size_t`, check whether the math library needs to be linked to explicitly. +* Fix precision issues in LDLT. The `isPositiveDefinite()` method is now always returning true, but it was conceptually broken anyway, since a non-pivoting LDLT decomposition can't know that. +* Compilation fix in `ldlt()` on expressions. +* Actually install the Eigen/Eigen and Eigen/Dense public headers! +* Fix readcost for complex types. +* Fix compilation of the BTL benchmarks. +* Some dox updates. + +## [2.0.12] - 2010-02-12 + +Changes since 2.0.11: + +* `EIGEN_DEFAULT_TO_ROW_MAJOR` is fully supported and tested. +* Several important fixes for row-major matrices. +* Fix support of several algorithms for mixed fixed-dynamic size matrices where the fixed dimension is greater than the dynamic dimension. For example: `Matrix(3,2)` +* fix `EIGEN_DONT_ALIGN`: now it _really_ disables vectorization (was giving a `#error` unless you also used `EIGEN_DONT_VECTORIZE`). +* Fix #92: Support QNX's QCC compiler (patch by Piotr Trojanek) +* Fix #90, missing type cast in LU, allow to use LU with MPFR (patch by 'Wolf'). +* Fix ICC compiler support: work around a bug present at least in ICC 11.1. +* Compilation fixes for `computeInverse()` on expressions. +* Fix a gap in a unit-test (thanks to Jitse Niesen) +* Backport improvements to benchmarking code. +* Documentation fixes + +## [2.0.11] - 2010-01-10 + +Changes since 2.0.10: + +* Complete rewrite of the 4x4 matrix inversion: we now use the usual cofactors approach, so no numerical stability problems anymore (bug #70) +* Still 4x4 matrix inverse: SSE path for the float case, borrowing code by Intel, giving very high performance. +* Fix crash happening on 32-bit x86 Linux with SSE, when double's were created at non-8-byte-aligned locations (bug #79). +* Fix bug in Part making it crash in certain products (bug #80). +* Precision improvements in Quaternion SLERP (bug #71). +* Fix sparse triangular solver for lower/row-major matrices (bug #74). +* Fix MSVC 2010 compatibility. +* Some documentation improvements. + +## [2.0.10] - 2009-11-25 + +Changes since 2.0.9: + +* Rewrite 4x4 matrix inverse to improve precision, and add a new unit test to guarantee that precision. It's less fast, but it's still faster than the cofactors method. +* Fix bug #62: crash in SSE code with MSVC 2008 (Thanks to Hauke Heibel). +* Fix bug #65: `MatrixBase::nonZeros()` was recursing infinitely +* Fix PowerPC platform detection on Mac OSX. +* Prevent the construction of bogus MatrixBase objects and generate good compilation errors for that. Done by making the default constructor protected, and adding some private constructors. +* Add option to initialize all matrices by zero: just #define `EIGEN_INITIALIZE_MATRICES_BY_ZERO` +* Improve Map documentation +* Install the pkg-config file to share/pkgconfig, instead of lib/pkgconfig (thanks to Thomas Capricelli) +* fix warnings +* fix compilation with MSVC 2010 +* adjust to repository name change + +## [2.0.9] - 2009-10-24 + +Changes since 2.0.8: + +* Really fix installation and the pkg-config file. +* Install the `NewStdVector` header that was introduced in 2.0.6. + +## [2.0.8] - 2009-10-23 + +Changes since 2.0.7: + +* fix installation error introduced in 2.0.7: it was choking on the pkg-config file eigen2.pc not being found. The fix had been proposed long ago by Ingmar Vanhassel for the development branch, and when recently the pkg-config support was back-ported to the 2.0 branch, nobody thought of backporting this fix too, and apparently nobody tested "make install" ! +* SVD: add default constructor. Users were relying on the compiler to generate one, and apparenty 2.0.7 triggered a little MSVC 2008 subtlety in this respect. Also added an assert. + +## [2.0.7] - 2009-10-22 + +Changes since 2.0.6: + +* fix bug #61: crash when using Qt `QVector` on Windows 32-bit. By Hauke Heibel. +* fix bug #10: the `reallocateSparse` function was half coded +* fix bug in `SparseMatrix::resize()` not correctly initializing by zero +* fix another bug in `SparseMatrix::resize()` when `outerSize==0`. By Hauke Heibel. +* fully support GCC 3.3. It was working in 2.0.2, there was a compilation error in 2.0.6, now for the first time in 2.0.7 it's 100% tested (the test suite passes without any errors, warnings, or failed tests). +* SVD: add missing assert (help catch mistakes) +* fixed warnings in unit-tests (Hauke Heibel) +* finish syncing `Memory.h` with the devel branch. This is cleaner and fixes a warning. The choice of system aligned malloc function may be affected by this change. +* add pkg-config support by Rhys Ulerich. +* documentation fix and doc-generation-script updates by Thomas Capricelli + +## [2.0.6] - 2009-09-23 + +Changes since 2.0.5: + +* fix bug: visitors didn't work on row-vectors. +* fix bug #50: compilation errors with `swap()`. +* fix bug #42: Add `Transform::Identity()` as mentioned in the tutorial. +* allow to disable all alignment code by defining `EIGEN_DONT_ALIGN` (backport from devel branch). +* backport the devel branch's `StdVector` header as `NewStdVector`. You may also #define `EIGEN_USE_NEW_STDVECTOR` to make `StdVector` use it automatically. However, by default it isn't used by `StdVector`, to preserve compatibility. +* Vectorized quaternion product (for float) by Rohit Garg (backport from devel branch). +* allow to override `EIGEN_RESTRICT` and add `EIGEN_DONT_USE_RESTRICT_KEYWORD` +* fix a warning in `ei_aligned_malloc`; fixed by backporting the body from the devel branch; may result in a different choice of system aligned malloc function. +* update the documentation. + +## [2.0.5] - 2009-08-22 + +Changes since 2.0.4: + +* fix bug: in rare situations involving mixed storage orders, a matrix product could be evaluated as its own transpose +* fix bug: `LU::solve()` crashed when called on the LU decomposition of a zero matrix +* fix bug: `EIGEN_STACK_ALLOCATION_LIMIT` was too high, resulting in stack overflow for a user. Now it is set as in the devel branch. +* fix compilation bug: our `StdVector` header didn't work with GCC 4.1. (Bug #41) +* fix compilation bug: missing return statement in `Rotation2D::operator*=` (Bug #36) +* in StdVector, a more useful `#error` message about the #including order +* add `EIGEN_TRANSFORM_PLUGIN` allowing to customize the Transform class +* fix a warning with MSVC +* fix a bug in our cmake code when building unit-tests (thanks to Marcus Hanwell) +* work around a bug in cmake that made it fail to build unit-tests when fortran wasn't installed +* in our cmake code, remove the part about retrieving the mercurial info and appending it to the version number in the dox +* dox: remove the old example list +* fix the option to build a binary library, although it's not very useful and will be removed +* add basic .hgignore file and script to build the docs (thanks to Thomas Capricelli) + +## [2.0.4] - 2009-08-01 + +Changes since 2.0.3: +* Several fixes in the overloaded new and delete operators. Thanks to Hauke Heibel. +* compilation fix: add the missing `ei_atan2` function. Thanks to Manuel Yguel. +* Use `ei_atan2` instead of using `std::atan2` directly. +* several compilation fixes in the Qt interoperability code: methods `toQTransform()` and `toQMatrix()`. Thanks to Anthony Truchet. +* compilation fix and simplification in Matrix assignment +* compilation fixes in `a *= b` and `a = a*b` when a has to be resized. +* remove a "stupid" version of `ei_pow`. for integers for gcc >= 4.3 +* bug fix in `Quaternion::setFromTwoVectors()` +* several ctest improvements: use our own dashboard, use a separate project for the 2.0 branch. +* documentation: improvement on the pages on unaligned arrays (the online copies have been updated immediately). + +## [2.0.3] - 2009-06-21 + +Changes since 2.0.2: +* precision and reliability fixes in various algorithms, especially LLT, QR, Tridiagonalization, and also a precision improvement in LU. +* fix LLT and LDLT solve() on uninitialized result (was causing an assertion). +* add Eigen/Eigen and Eigen/Dense headers for convenience +* document a newly found cause for the "unaligned array" assertion +* backport documentation improvements on transpose() and adjoint() +* updates in the Sparse module (was needed to support KDE 4.3) + +## [2.0.2] - 2009-05-22 + +Changes since 2.0.1: +* Fix `linearRegression()` compilation, actually it is reimplemented using the better fitHyperplane() which does total least-squares. +* Add missing `setZero()` etc... variants taking size parameters and resizing. These were mentioned in the tutorial but weren't implemented. +* Fix `posix_memalign` platform check. This fixes portability issues. Thanks to Ross Smith. +* Fix detection of SSE2 on the Windows 64-bit platform. +* Fix compatibility with the old GCC 3.3: it is now fully supported again. +* Fix warnings with recent GCC (4.4.0 and 4.3.3). + +## [2.0.1] - 2009-04-14 + +Changes since 2.0.0: +* disable alignment altogether on exotic platforms on which we don't vectorize anyway. This allows e.g. to use Eigen on ARM platforms. +* new StdVector header with a new workaround for the problems with std::vector. +* workarounds for MSVC internal compiler errors +* MSVC 9 compilation fix (patch by Hauke Heibel) +* fixes for various bugs in Maps/Blocks that could give wrong results +* fix bug in 4x4 matrix inverse that could give wrong results +* compilation fix in SliceVectorization +* fix wrong static assertion (patch by Markus Moll) +* add missing operators in `aligned_allocator` (thanks to Hauke Heibel) + +## [2.0.0] - 2009-02-02 + +First public release. \ No newline at end of file diff --git a/src/3rdparty/eigen/COPYING.APACHE b/src/3rdparty/eigen/COPYING.APACHE new file mode 100644 index 0000000..61e948d --- /dev/null +++ b/src/3rdparty/eigen/COPYING.APACHE @@ -0,0 +1,203 @@ +/* + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +*/ \ No newline at end of file diff --git a/src/3rdparty/eigen/COPYING.BSD b/src/3rdparty/eigen/COPYING.BSD new file mode 100644 index 0000000..8964ddf --- /dev/null +++ b/src/3rdparty/eigen/COPYING.BSD @@ -0,0 +1,26 @@ +/* + Copyright (c) 2011, Intel Corporation. All rights reserved. + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Intel Corporation nor the names of its contributors may + be used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ diff --git a/src/3rdparty/eigen/COPYING.MINPACK b/src/3rdparty/eigen/COPYING.MINPACK new file mode 100644 index 0000000..132cc3f --- /dev/null +++ b/src/3rdparty/eigen/COPYING.MINPACK @@ -0,0 +1,51 @@ +Minpack Copyright Notice (1999) University of Chicago. All rights reserved + +Redistribution and use in source and binary forms, with or +without modification, are permitted provided that the +following conditions are met: + +1. Redistributions of source code must retain the above +copyright notice, this list of conditions and the following +disclaimer. + +2. Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following +disclaimer in the documentation and/or other materials +provided with the distribution. + +3. The end-user documentation included with the +redistribution, if any, must include the following +acknowledgment: + + "This product includes software developed by the + University of Chicago, as Operator of Argonne National + Laboratory. + +Alternately, this acknowledgment may appear in the software +itself, if and wherever such third-party acknowledgments +normally appear. + +4. WARRANTY DISCLAIMER. THE SOFTWARE IS SUPPLIED "AS IS" +WITHOUT WARRANTY OF ANY KIND. THE COPYRIGHT HOLDER, THE +UNITED STATES, THE UNITED STATES DEPARTMENT OF ENERGY, AND +THEIR EMPLOYEES: (1) DISCLAIM ANY WARRANTIES, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES +OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE +OR NON-INFRINGEMENT, (2) DO NOT ASSUME ANY LEGAL LIABILITY +OR RESPONSIBILITY FOR THE ACCURACY, COMPLETENESS, OR +USEFULNESS OF THE SOFTWARE, (3) DO NOT REPRESENT THAT USE OF +THE SOFTWARE WOULD NOT INFRINGE PRIVATELY OWNED RIGHTS, (4) +DO NOT WARRANT THAT THE SOFTWARE WILL FUNCTION +UNINTERRUPTED, THAT IT IS ERROR-FREE OR THAT ANY ERRORS WILL +BE CORRECTED. + +5. LIMITATION OF LIABILITY. IN NO EVENT WILL THE COPYRIGHT +HOLDER, THE UNITED STATES, THE UNITED STATES DEPARTMENT OF +ENERGY, OR THEIR EMPLOYEES: BE LIABLE FOR ANY INDIRECT, +INCIDENTAL, CONSEQUENTIAL, SPECIAL OR PUNITIVE DAMAGES OF +ANY KIND OR NATURE, INCLUDING BUT NOT LIMITED TO LOSS OF +PROFITS OR LOSS OF DATA, FOR ANY REASON WHATSOEVER, WHETHER +SUCH LIABILITY IS ASSERTED ON THE BASIS OF CONTRACT, TORT +(INCLUDING NEGLIGENCE OR STRICT LIABILITY), OR OTHERWISE, +EVEN IF ANY OF SAID PARTIES HAS BEEN WARNED OF THE +POSSIBILITY OF SUCH LOSS OR DAMAGES. diff --git a/src/3rdparty/eigen/COPYING.MPL2 b/src/3rdparty/eigen/COPYING.MPL2 new file mode 100644 index 0000000..ee6256c --- /dev/null +++ b/src/3rdparty/eigen/COPYING.MPL2 @@ -0,0 +1,373 @@ +Mozilla Public License Version 2.0 +================================== + +1. Definitions +-------------- + +1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + +1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + +1.3. "Contribution" + means Covered Software of a particular Contributor. + +1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + +1.5. "Incompatible With Secondary Licenses" + means + + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + +1.6. "Executable Form" + means any form of the work other than Source Code Form. + +1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + +1.8. "License" + means this document. + +1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + +1.10. "Modifications" + means any of the following: + + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + + (b) any new file in Source Code Form that contains any Covered + Software. + +1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + +1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + +1.13. "Source Code Form" + means the form of the work preferred for making modifications. + +1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + +2. License Grants and Conditions +-------------------------------- + +2.1. Grants + +Each Contributor hereby grants You a world-wide, royalty-free, +non-exclusive license: + +(a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + +(b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + +2.2. Effective Date + +The licenses granted in Section 2.1 with respect to any Contribution +become effective for each Contribution on the date the Contributor first +distributes such Contribution. + +2.3. Limitations on Grant Scope + +The licenses granted in this Section 2 are the only rights granted under +this License. No additional rights or licenses will be implied from the +distribution or licensing of Covered Software under this License. +Notwithstanding Section 2.1(b) above, no patent license is granted by a +Contributor: + +(a) for any code that a Contributor has removed from Covered Software; + or + +(b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + +(c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + +This License does not grant any rights in the trademarks, service marks, +or logos of any Contributor (except as may be necessary to comply with +the notice requirements in Section 3.4). + +2.4. Subsequent Licenses + +No Contributor makes additional grants as a result of Your choice to +distribute the Covered Software under a subsequent version of this +License (see Section 10.2) or under the terms of a Secondary License (if +permitted under the terms of Section 3.3). + +2.5. Representation + +Each Contributor represents that the Contributor believes its +Contributions are its original creation(s) or it has sufficient rights +to grant the rights to its Contributions conveyed by this License. + +2.6. Fair Use + +This License is not intended to limit any rights You have under +applicable copyright doctrines of fair use, fair dealing, or other +equivalents. + +2.7. Conditions + +Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted +in Section 2.1. + +3. Responsibilities +------------------- + +3.1. Distribution of Source Form + +All distribution of Covered Software in Source Code Form, including any +Modifications that You create or to which You contribute, must be under +the terms of this License. You must inform recipients that the Source +Code Form of the Covered Software is governed by the terms of this +License, and how they can obtain a copy of this License. You may not +attempt to alter or restrict the recipients' rights in the Source Code +Form. + +3.2. Distribution of Executable Form + +If You distribute Covered Software in Executable Form then: + +(a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + +(b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + +You may create and distribute a Larger Work under terms of Your choice, +provided that You also comply with the requirements of this License for +the Covered Software. If the Larger Work is a combination of Covered +Software with a work governed by one or more Secondary Licenses, and the +Covered Software is not Incompatible With Secondary Licenses, this +License permits You to additionally distribute such Covered Software +under the terms of such Secondary License(s), so that the recipient of +the Larger Work may, at their option, further distribute the Covered +Software under the terms of either this License or such Secondary +License(s). + +3.4. Notices + +You may not remove or alter the substance of any license notices +(including copyright notices, patent notices, disclaimers of warranty, +or limitations of liability) contained within the Source Code Form of +the Covered Software, except that You may alter any license notices to +the extent required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + +You may choose to offer, and to charge a fee for, warranty, support, +indemnity or liability obligations to one or more recipients of Covered +Software. However, You may do so only on Your own behalf, and not on +behalf of any Contributor. You must make it absolutely clear that any +such warranty, support, indemnity, or liability obligation is offered by +You alone, and You hereby agree to indemnify every Contributor for any +liability incurred by such Contributor as a result of warranty, support, +indemnity or liability terms You offer. You may include additional +disclaimers of warranty and limitations of liability specific to any +jurisdiction. + +4. Inability to Comply Due to Statute or Regulation +--------------------------------------------------- + +If it is impossible for You to comply with any of the terms of this +License with respect to some or all of the Covered Software due to +statute, judicial order, or regulation then You must: (a) comply with +the terms of this License to the maximum extent possible; and (b) +describe the limitations and the code they affect. Such description must +be placed in a text file included with all distributions of the Covered +Software under this License. Except to the extent prohibited by statute +or regulation, such description must be sufficiently detailed for a +recipient of ordinary skill to be able to understand it. + +5. Termination +-------------- + +5.1. The rights granted under this License will terminate automatically +if You fail to comply with any of its terms. However, if You become +compliant, then the rights granted under this License from a particular +Contributor are reinstated (a) provisionally, unless and until such +Contributor explicitly and finally terminates Your grants, and (b) on an +ongoing basis, if such Contributor fails to notify You of the +non-compliance by some reasonable means prior to 60 days after You have +come back into compliance. Moreover, Your grants from a particular +Contributor are reinstated on an ongoing basis if such Contributor +notifies You of the non-compliance by some reasonable means, this is the +first time You have received notice of non-compliance with this License +from such Contributor, and You become compliant prior to 30 days after +Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent +infringement claim (excluding declaratory judgment actions, +counter-claims, and cross-claims) alleging that a Contributor Version +directly or indirectly infringes any patent, then the rights granted to +You by any and all Contributors for the Covered Software under Section +2.1 of this License shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all +end user license agreements (excluding distributors and resellers) which +have been validly granted by You or Your distributors under this License +prior to termination shall survive termination. + +************************************************************************ +* * +* 6. Disclaimer of Warranty * +* ------------------------- * +* * +* Covered Software is provided under this License on an "as is" * +* basis, without warranty of any kind, either expressed, implied, or * +* statutory, including, without limitation, warranties that the * +* Covered Software is free of defects, merchantable, fit for a * +* particular purpose or non-infringing. The entire risk as to the * +* quality and performance of the Covered Software is with You. * +* Should any Covered Software prove defective in any respect, You * +* (not any Contributor) assume the cost of any necessary servicing, * +* repair, or correction. This disclaimer of warranty constitutes an * +* essential part of this License. No use of any Covered Software is * +* authorized under this License except under this disclaimer. * +* * +************************************************************************ + +************************************************************************ +* * +* 7. Limitation of Liability * +* -------------------------- * +* * +* Under no circumstances and under no legal theory, whether tort * +* (including negligence), contract, or otherwise, shall any * +* Contributor, or anyone who distributes Covered Software as * +* permitted above, be liable to You for any direct, indirect, * +* special, incidental, or consequential damages of any character * +* including, without limitation, damages for lost profits, loss of * +* goodwill, work stoppage, computer failure or malfunction, or any * +* and all other commercial damages or losses, even if such party * +* shall have been informed of the possibility of such damages. This * +* limitation of liability shall not apply to liability for death or * +* personal injury resulting from such party's negligence to the * +* extent applicable law prohibits such limitation. Some * +* jurisdictions do not allow the exclusion or limitation of * +* incidental or consequential damages, so this exclusion and * +* limitation may not apply to You. * +* * +************************************************************************ + +8. Litigation +------------- + +Any litigation relating to this License may be brought only in the +courts of a jurisdiction where the defendant maintains its principal +place of business and such litigation shall be governed by laws of that +jurisdiction, without reference to its conflict-of-law provisions. +Nothing in this Section shall prevent a party's ability to bring +cross-claims or counter-claims. + +9. Miscellaneous +---------------- + +This License represents the complete agreement concerning the subject +matter hereof. If any provision of this License is held to be +unenforceable, such provision shall be reformed only to the extent +necessary to make it enforceable. Any law or regulation which provides +that the language of a contract shall be construed against the drafter +shall not be used to construe this License against a Contributor. + +10. Versions of the License +--------------------------- + +10.1. New Versions + +Mozilla Foundation is the license steward. Except as provided in Section +10.3, no one other than the license steward has the right to modify or +publish new versions of this License. Each version will be given a +distinguishing version number. + +10.2. Effect of New Versions + +You may distribute the Covered Software under the terms of the version +of the License under which You originally received the Covered Software, +or under the terms of any subsequent version published by the license +steward. + +10.3. Modified Versions + +If you create software not governed by this License, and you want to +create a new license for such software, you may create and use a +modified version of this License if you rename the license and remove +any references to the name of the license steward (except to note that +such modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary +Licenses + +If You choose to distribute Source Code Form that is Incompatible With +Secondary Licenses under the terms of this version of the License, the +notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice +------------------------------------------- + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at https://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular +file, then You may include the notice in a location (such as a LICENSE +file in a relevant directory) where a recipient would be likely to look +for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - "Incompatible With Secondary Licenses" Notice +--------------------------------------------------------- + + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. diff --git a/src/3rdparty/eigen/COPYING.README b/src/3rdparty/eigen/COPYING.README new file mode 100644 index 0000000..11af93c --- /dev/null +++ b/src/3rdparty/eigen/COPYING.README @@ -0,0 +1,6 @@ +Eigen is primarily MPL2 licensed. See COPYING.MPL2 and these links: + http://www.mozilla.org/MPL/2.0/ + http://www.mozilla.org/MPL/2.0/FAQ.html + +Some files contain third-party code under BSD or other MPL2-compatible licenses, +whence the other COPYING.* files here. \ No newline at end of file diff --git a/src/3rdparty/eigen/COPYRIGHTS b/src/3rdparty/eigen/COPYRIGHTS new file mode 100644 index 0000000..9c8b98e --- /dev/null +++ b/src/3rdparty/eigen/COPYRIGHTS @@ -0,0 +1,54 @@ +Copyright (c) 2012 Alexey Korepanov +Copyright (c) 2020 Antonio Sanchez +Copyright (c) 2020 Arm Limited and Contributors +Copyright (c) 2006-2011 Benoit Jacob +Copyright (c) 2014-2016 Benoit Steiner (benoit.steiner.goog@gmail.com) +Copyright (c) 16 BfToF32Even (c) Packet4f +Copyright (c) 16 BfToF32Odd (c) Packet4f +Copyright (c) 2021 C. Antonio Sanchez +Copyright (c) 2023-2025 Charlie Schlosser +Copyright (c) 2021, 2023 Chip Kerchner (chip.kerchner@ibm.com) +Copyright (c) 2009 Claire Maurice +Copyright (c) 2017 Codeplay Software Limited +Copyright (c) 2018 Deven Desai +Copyright (c) 2016 Dmitry Vyukov +Copyright (c) 2021 Erik Schultheis +Copyright (c) 2020 Everton Constantino (everton.constantino@ibm.com) +Copyright (c) 2016 Fabian Giesen +Copyright (c) 2008-2019 Gael Guennebaud +Copyright (c) 2013 Gauthier Brun +Copyright (c) 2009-2013 Hauke Heibel +Copyright (c) 2001, 2010-2011, 2022 Intel Corporation +Copyright (c) 2013 Jean Ceccato +Copyright (c) 2010-2013 Jitse Niesen +Copyright (c) 2007 Julien Pommier +Copyright (c) 2023 Juraj Oršulić, University of Zagreb +Copyright (c) 2009 Keir Mierle +Copyright (c) 2009 Kenneth Riddile +Copyright (c) 2008-2016 Konstantinos Margaritis +Copyright (c) 2017 Kyle Macfarlan +Copyright (c) 2009 Mathieu Gautier +Copyright (c) 2022 Melven Roehrig-Zoellner +Copyright (c) 2007 Michael Olbrich +Copyright (c) 2021 NVIDIA CORPORATION. +Copyright (c) 2013 Nicolas Carre +Copyright (c) 2014-2015 Open Source Robotics Foundation +Copyright (c) 2013 Pavel Holoborodko +Copyright (c) 2014, 2016 Pedro Gonnet (pedro.gonnet@gmail.com) +Copyright (c) 2013 Pierre Zoppitelli +Copyright (c) 2016, 2018, 2019 Rasmus Munk Larsen (rmlarsen@google.com) +Copyright (c) 2009 Ricard Marxer +Copyright (c) 2009 Rohit Garg +Copyright (c) 2025 The Eigen Authors. +Copyright (c) 2021 The Eigen Team +Copyright (c) 2017 The TensorFlow Authors +Copyright (c) 2010 Thomas Capricelli +Copyright (c) 2011 Timothy E. Holy tim.holy@gmail.com +Copyright (c) 2016 Tobias Wood +Copyright (c) 2010 Vincent Lejeune +Copyright (c) 2018 Wave Computing, Inc. +Copyright (c) 2025 Weiwei Kong +Copyright (c) 2011-2014 Willow Garage, Inc. +Copyright (c) 2024 XiWei Gu +Copyright (c) 2014 yoco +Copyright (c) 2023 Zang Ruochen diff --git a/src/3rdparty/eigen/Eigen/AccelerateSupport b/src/3rdparty/eigen/Eigen/AccelerateSupport new file mode 100644 index 0000000..533be68 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/AccelerateSupport @@ -0,0 +1,52 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ACCELERATESUPPORT_MODULE_H +#define EIGEN_ACCELERATESUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \ingroup Support_modules + * \defgroup AccelerateSupport_Module AccelerateSupport module + * + * This module provides an interface to the Apple Accelerate library. + * It provides the seven following main factorization classes: + * - class AccelerateLLT: a Cholesky (LL^T) factorization. + * - class AccelerateLDLT: the default LDL^T factorization. + * - class AccelerateLDLTUnpivoted: a Cholesky-like LDL^T factorization with only 1x1 pivots and no pivoting + * - class AccelerateLDLTSBK: an LDL^T factorization with Supernode Bunch-Kaufman and static pivoting + * - class AccelerateLDLTTPP: an LDL^T factorization with full threshold partial pivoting + * - class AccelerateQR: a QR factorization + * - class AccelerateCholeskyAtA: a QR factorization without storing Q (equivalent to A^TA = R^T R) + * + * \code + * #include + * \endcode + * + * In order to use this module, the Accelerate headers must be accessible from + * the include paths, and your binary must be linked to the Accelerate framework. + * The Accelerate library is only available on Apple hardware. + * + * Note that many of the algorithms can be influenced by the UpLo template + * argument. All matrices are assumed to be symmetric. For example, the following + * creates an LDLT factorization where your matrix is symmetric (implicit) and + * uses the lower triangle: + * + * \code + * AccelerateLDLT, Lower> ldlt; + * \endcode + */ + +// IWYU pragma: begin_exports +#include "src/AccelerateSupport/AccelerateSupport.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_ACCELERATESUPPORT_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Cholesky b/src/3rdparty/eigen/Eigen/Cholesky new file mode 100644 index 0000000..b05ed82 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Cholesky @@ -0,0 +1,43 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CHOLESKY_MODULE_H +#define EIGEN_CHOLESKY_MODULE_H + +#include "Core" +#include "Jacobi" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Cholesky_Module Cholesky module + * + * + * + * This module provides two variants of the Cholesky decomposition for selfadjoint (hermitian) matrices. + * Those decompositions are also accessible via the following methods: + * - MatrixBase::llt() + * - MatrixBase::ldlt() + * - SelfAdjointView::llt() + * - SelfAdjointView::ldlt() + * + * \code + * #include + * \endcode + */ + +// IWYU pragma: begin_exports +#include "src/Cholesky/LLT.h" +#include "src/Cholesky/LDLT.h" +#ifdef EIGEN_USE_LAPACKE +#include "src/misc/lapacke_helpers.h" +#include "src/Cholesky/LLT_LAPACKE.h" +#endif +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CHOLESKY_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/CholmodSupport b/src/3rdparty/eigen/Eigen/CholmodSupport new file mode 100644 index 0000000..adc5f8d --- /dev/null +++ b/src/3rdparty/eigen/Eigen/CholmodSupport @@ -0,0 +1,48 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CHOLMODSUPPORT_MODULE_H +#define EIGEN_CHOLMODSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +#include + +/** \ingroup Support_modules + * \defgroup CholmodSupport_Module CholmodSupport module + * + * This module provides an interface to the Cholmod library which is part of the suitesparse package. It provides the two following main factorization classes: + * - class CholmodSupernodalLLT: a supernodal LLT Cholesky factorization. + * - class CholmodDecomposition: a general L(D)LT Cholesky factorization with automatic or explicit runtime selection of + * the underlying factorization method (supernodal or simplicial). + * + * For the sake of completeness, this module also propose the two following classes: + * - class CholmodSimplicialLLT + * - class CholmodSimplicialLDLT + * Note that these classes does not bring any particular advantage compared to the built-in + * SimplicialLLT and SimplicialLDLT factorization classes. + * + * \code + * #include + * \endcode + * + * In order to use this module, the cholmod headers must be accessible from the include paths, and your binary must be + * linked to the cholmod library and its dependencies. The dependencies depend on how cholmod has been compiled. For a + * cmake based project, you can use our FindCholmod.cmake module to help you in this task. + * + */ + +// IWYU pragma: begin_exports +#include "src/CholmodSupport/CholmodSupport.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CHOLMODSUPPORT_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Core b/src/3rdparty/eigen/Eigen/Core new file mode 100644 index 0000000..34838f5 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Core @@ -0,0 +1,451 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2007-2011 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CORE_MODULE_H +#define EIGEN_CORE_MODULE_H + +// Eigen version information. +#include "Version" + +// first thing Eigen does: stop the compiler from reporting useless warnings. +#include "src/Core/util/DisableStupidWarnings.h" + +// then include this file where all our macros are defined. It's really important to do it first because +// it's where we do all the compiler/OS/arch detections and define most defaults. +#include "src/Core/util/Macros.h" + +// This detects SSE/AVX/NEON/etc. and configure alignment settings +#include "src/Core/util/ConfigureVectorization.h" + +// We need cuda_runtime.h/hip_runtime.h to ensure that +// the EIGEN_USING_STD macro works properly on the device side +#if defined(EIGEN_CUDACC) +#include +#elif defined(EIGEN_HIPCC) +#include +#endif + +#ifdef EIGEN_EXCEPTIONS +#include +#endif + +// Disable the ipa-cp-clone optimization flag with MinGW 6.x or older (enabled by default with -O3) +// See http://eigen.tuxfamily.org/bz/show_bug.cgi?id=556 for details. +#if EIGEN_COMP_MINGW && EIGEN_GNUC_STRICT_LESS_THAN(6, 0, 0) +#pragma GCC optimize("-fno-ipa-cp-clone") +#endif + +// Prevent ICC from specializing std::complex operators that silently fail +// on device. This allows us to use our own device-compatible specializations +// instead. +#if EIGEN_COMP_ICC && defined(EIGEN_GPU_COMPILE_PHASE) && !defined(_OVERRIDE_COMPLEX_SPECIALIZATION_) +#define _OVERRIDE_COMPLEX_SPECIALIZATION_ 1 +#endif +#include + +// this include file manages BLAS and MKL related macros +// and inclusion of their respective header files +#include "src/Core/util/MKL_support.h" + +#if defined(EIGEN_HAS_CUDA_FP16) || defined(EIGEN_HAS_HIP_FP16) +#define EIGEN_HAS_GPU_FP16 +#endif + +#if defined(EIGEN_HAS_CUDA_BF16) || defined(EIGEN_HAS_HIP_BF16) +#define EIGEN_HAS_GPU_BF16 +#endif + +#if (defined _OPENMP) && (!defined EIGEN_DONT_PARALLELIZE) +#define EIGEN_HAS_OPENMP +#endif + +#ifdef EIGEN_HAS_OPENMP +#include +#include +#endif + +// MSVC for windows mobile does not have the errno.h file +#if !(EIGEN_COMP_MSVC && EIGEN_OS_WINCE) && !EIGEN_COMP_ARM +#define EIGEN_HAS_ERRNO +#endif + +#ifdef EIGEN_HAS_ERRNO +#include +#endif +#include +#include +#include +#include +#ifndef EIGEN_NO_IO +#include +#include +#endif +#include +#include +#include +#include // for CHAR_BIT +// for min/max: +#include + +#include +#include +#include + +// for std::is_nothrow_move_assignable +#include + +// for std::this_thread::yield(). +#if !defined(EIGEN_USE_BLAS) && (defined(EIGEN_HAS_OPENMP) || defined(EIGEN_GEMM_THREADPOOL)) +#include +#endif + +// for __cpp_lib feature test macros +#if defined(__has_include) && __has_include() +#include +#endif + +// for std::bit_cast() +#if defined(__cpp_lib_bit_cast) && __cpp_lib_bit_cast >= 201806L +#include +#endif + +// for outputting debug info +#ifdef EIGEN_DEBUG_ASSIGN +#include +#endif + +// required for __cpuid, needs to be included after cmath +// also required for _BitScanReverse on Windows on ARM +#if EIGEN_COMP_MSVC && (EIGEN_ARCH_i386_OR_x86_64 || EIGEN_ARCH_ARM64) && !EIGEN_OS_WINCE +#include +#endif + +#if defined(EIGEN_USE_SYCL) +#undef min +#undef max +#undef isnan +#undef isinf +#undef isfinite +#include +#include +#include +#include +#ifndef EIGEN_SYCL_LOCAL_THREAD_DIM0 +#define EIGEN_SYCL_LOCAL_THREAD_DIM0 16 +#endif +#ifndef EIGEN_SYCL_LOCAL_THREAD_DIM1 +#define EIGEN_SYCL_LOCAL_THREAD_DIM1 16 +#endif +#endif + +#if defined EIGEN2_SUPPORT_STAGE40_FULL_EIGEN3_STRICTNESS || defined EIGEN2_SUPPORT_STAGE30_FULL_EIGEN3_API || \ + defined EIGEN2_SUPPORT_STAGE20_RESOLVE_API_CONFLICTS || defined EIGEN2_SUPPORT_STAGE10_FULL_EIGEN2_API || \ + defined EIGEN2_SUPPORT +// This will generate an error message: +#error Eigen2-support is only available up to version 3.2. Please go to "http://eigen.tuxfamily.org/index.php?title=Eigen2" for further information +#endif + +namespace Eigen { + +// we use size_t frequently and we'll never remember to prepend it with std:: every time just to +// ensure QNX/QCC support +using std::size_t; +// gcc 4.6.0 wants std:: for ptrdiff_t +using std::ptrdiff_t; + +} // namespace Eigen + +/** \defgroup Core_Module Core module + * This is the main module of Eigen providing dense matrix and vector support + * (both fixed and dynamic size) with all the features corresponding to a BLAS library + * and much more... + * + * \code + * #include + * \endcode + */ + +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#endif + +// IWYU pragma: begin_exports +#include "src/Core/util/Constants.h" +#include "src/Core/util/Meta.h" +#include "src/Core/util/Assert.h" +#include "src/Core/util/ForwardDeclarations.h" +#include "src/Core/util/StaticAssert.h" +#include "src/Core/util/XprHelper.h" +#include "src/Core/util/Memory.h" +#include "src/Core/util/IntegralConstant.h" +#include "src/Core/util/Serializer.h" +#include "src/Core/util/SymbolicIndex.h" +#include "src/Core/util/EmulateArray.h" +#include "src/Core/util/MoreMeta.h" + +#include "src/Core/NumTraits.h" +#include "src/Core/MathFunctions.h" +#include "src/Core/RandomImpl.h" +#include "src/Core/GenericPacketMath.h" +#include "src/Core/MathFunctionsImpl.h" +#include "src/Core/arch/Default/ConjHelper.h" +// Generic half float support +#include "src/Core/arch/Default/Half.h" +#include "src/Core/arch/Default/BFloat16.h" +#include "src/Core/arch/Default/GenericPacketMathFunctionsFwd.h" + +#if defined EIGEN_VECTORIZE_AVX512 +#include "src/Core/arch/SSE/PacketMath.h" +#include "src/Core/arch/SSE/Reductions.h" +#include "src/Core/arch/AVX/PacketMath.h" +#include "src/Core/arch/AVX/Reductions.h" +#include "src/Core/arch/AVX512/PacketMath.h" +#include "src/Core/arch/AVX512/Reductions.h" +#if defined EIGEN_VECTORIZE_AVX512FP16 +#include "src/Core/arch/AVX512/PacketMathFP16.h" +#endif +#include "src/Core/arch/SSE/TypeCasting.h" +#include "src/Core/arch/AVX/TypeCasting.h" +#include "src/Core/arch/AVX512/TypeCasting.h" +#if defined EIGEN_VECTORIZE_AVX512FP16 +#include "src/Core/arch/AVX512/TypeCastingFP16.h" +#endif +#include "src/Core/arch/SSE/Complex.h" +#include "src/Core/arch/AVX/Complex.h" +#include "src/Core/arch/AVX512/Complex.h" +#include "src/Core/arch/SSE/MathFunctions.h" +#include "src/Core/arch/AVX/MathFunctions.h" +#include "src/Core/arch/AVX512/MathFunctions.h" +#if defined EIGEN_VECTORIZE_AVX512FP16 +#include "src/Core/arch/AVX512/MathFunctionsFP16.h" +#endif +#include "src/Core/arch/AVX512/TrsmKernel.h" +#elif defined EIGEN_VECTORIZE_AVX +// Use AVX for floats and doubles, SSE for integers +#include "src/Core/arch/SSE/PacketMath.h" +#include "src/Core/arch/SSE/Reductions.h" +#include "src/Core/arch/SSE/TypeCasting.h" +#include "src/Core/arch/SSE/Complex.h" +#include "src/Core/arch/AVX/PacketMath.h" +#include "src/Core/arch/AVX/Reductions.h" +#include "src/Core/arch/AVX/TypeCasting.h" +#include "src/Core/arch/AVX/Complex.h" +#include "src/Core/arch/SSE/MathFunctions.h" +#include "src/Core/arch/AVX/MathFunctions.h" +#elif defined EIGEN_VECTORIZE_SSE +#include "src/Core/arch/SSE/PacketMath.h" +#include "src/Core/arch/SSE/Reductions.h" +#include "src/Core/arch/SSE/TypeCasting.h" +#include "src/Core/arch/SSE/MathFunctions.h" +#include "src/Core/arch/SSE/Complex.h" +#endif + +#if defined(EIGEN_VECTORIZE_ALTIVEC) || defined(EIGEN_VECTORIZE_VSX) +#include "src/Core/arch/AltiVec/PacketMath.h" +#include "src/Core/arch/AltiVec/TypeCasting.h" +#include "src/Core/arch/AltiVec/MathFunctions.h" +#include "src/Core/arch/AltiVec/Complex.h" +#elif defined EIGEN_VECTORIZE_NEON +#include "src/Core/arch/NEON/PacketMath.h" +#include "src/Core/arch/NEON/TypeCasting.h" +#include "src/Core/arch/NEON/MathFunctions.h" +#include "src/Core/arch/NEON/Complex.h" +#elif defined EIGEN_VECTORIZE_LSX +#include "src/Core/arch/LSX/PacketMath.h" +#include "src/Core/arch/LSX/TypeCasting.h" +#include "src/Core/arch/LSX/MathFunctions.h" +#include "src/Core/arch/LSX/Complex.h" +#elif defined EIGEN_VECTORIZE_SVE +#include "src/Core/arch/SVE/PacketMath.h" +#include "src/Core/arch/SVE/TypeCasting.h" +#include "src/Core/arch/SVE/MathFunctions.h" +#elif defined EIGEN_VECTORIZE_ZVECTOR +#include "src/Core/arch/ZVector/PacketMath.h" +#include "src/Core/arch/ZVector/MathFunctions.h" +#include "src/Core/arch/ZVector/Complex.h" +#elif defined EIGEN_VECTORIZE_MSA +#include "src/Core/arch/MSA/PacketMath.h" +#include "src/Core/arch/MSA/MathFunctions.h" +#include "src/Core/arch/MSA/Complex.h" +#elif defined EIGEN_VECTORIZE_HVX +#include "src/Core/arch/HVX/PacketMath.h" +#endif + +#if defined EIGEN_VECTORIZE_GPU +#include "src/Core/arch/GPU/PacketMath.h" +#include "src/Core/arch/GPU/MathFunctions.h" +#include "src/Core/arch/GPU/TypeCasting.h" +#endif + +#if defined(EIGEN_USE_SYCL) +#include "src/Core/arch/SYCL/InteropHeaders.h" +#if !defined(EIGEN_DONT_VECTORIZE_SYCL) +#include "src/Core/arch/SYCL/PacketMath.h" +#include "src/Core/arch/SYCL/MathFunctions.h" +#include "src/Core/arch/SYCL/TypeCasting.h" +#endif +#endif + +#include "src/Core/arch/Default/Settings.h" +// This file provides generic implementations valid for scalar as well +#include "src/Core/arch/Default/GenericPacketMathFunctions.h" + +#include "src/Core/functors/TernaryFunctors.h" +#include "src/Core/functors/BinaryFunctors.h" +#include "src/Core/functors/UnaryFunctors.h" +#include "src/Core/functors/NullaryFunctors.h" +#include "src/Core/functors/StlFunctors.h" +#include "src/Core/functors/AssignmentFunctors.h" + +// Specialized functors for GPU. +#ifdef EIGEN_GPUCC +#include "src/Core/arch/GPU/Complex.h" +#endif + +// Specializations of vectorized activation functions for NEON. +#ifdef EIGEN_VECTORIZE_NEON +#include "src/Core/arch/NEON/UnaryFunctors.h" +#endif + +#include "src/Core/util/IndexedViewHelper.h" +#include "src/Core/util/ReshapedHelper.h" +#include "src/Core/ArithmeticSequence.h" +#ifndef EIGEN_NO_IO +#include "src/Core/IO.h" +#endif +#include "src/Core/DenseCoeffsBase.h" +#include "src/Core/DenseBase.h" +#include "src/Core/MatrixBase.h" +#include "src/Core/EigenBase.h" + +#include "src/Core/Product.h" +#include "src/Core/CoreEvaluators.h" +#include "src/Core/AssignEvaluator.h" +#include "src/Core/RealView.h" +#include "src/Core/Assign.h" + +#include "src/Core/ArrayBase.h" +#include "src/Core/util/BlasUtil.h" +#include "src/Core/DenseStorage.h" +#include "src/Core/NestByValue.h" + +// #include "src/Core/ForceAlignedAccess.h" + +#include "src/Core/ReturnByValue.h" +#include "src/Core/NoAlias.h" +#include "src/Core/PlainObjectBase.h" +#include "src/Core/Matrix.h" +#include "src/Core/Array.h" +#include "src/Core/Fill.h" +#include "src/Core/CwiseTernaryOp.h" +#include "src/Core/CwiseBinaryOp.h" +#include "src/Core/CwiseUnaryOp.h" +#include "src/Core/CwiseNullaryOp.h" +#include "src/Core/CwiseUnaryView.h" +#include "src/Core/SelfCwiseBinaryOp.h" +#include "src/Core/InnerProduct.h" +#include "src/Core/Dot.h" +#include "src/Core/StableNorm.h" +#include "src/Core/Stride.h" +#include "src/Core/MapBase.h" +#include "src/Core/Map.h" +#include "src/Core/Ref.h" +#include "src/Core/Block.h" +#include "src/Core/VectorBlock.h" +#include "src/Core/IndexedView.h" +#include "src/Core/Reshaped.h" +#include "src/Core/Transpose.h" +#include "src/Core/DiagonalMatrix.h" +#include "src/Core/Diagonal.h" +#include "src/Core/DiagonalProduct.h" +#include "src/Core/SkewSymmetricMatrix3.h" +#include "src/Core/Redux.h" +#include "src/Core/Visitor.h" +#include "src/Core/FindCoeff.h" +#include "src/Core/Fuzzy.h" +#include "src/Core/Swap.h" +#include "src/Core/CommaInitializer.h" +#include "src/Core/GeneralProduct.h" +#include "src/Core/Solve.h" +#include "src/Core/Inverse.h" +#include "src/Core/SolverBase.h" +#include "src/Core/PermutationMatrix.h" +#include "src/Core/Transpositions.h" +#include "src/Core/TriangularMatrix.h" +#include "src/Core/SelfAdjointView.h" +#include "src/Core/products/GeneralBlockPanelKernel.h" +#include "src/Core/DeviceWrapper.h" +#ifdef EIGEN_GEMM_THREADPOOL +#include "ThreadPool" +#endif +#include "src/Core/products/Parallelizer.h" +#include "src/Core/ProductEvaluators.h" +#include "src/Core/products/GeneralMatrixVector.h" +#include "src/Core/products/GeneralMatrixMatrix.h" +#include "src/Core/SolveTriangular.h" +#include "src/Core/products/GeneralMatrixMatrixTriangular.h" +#include "src/Core/products/SelfadjointMatrixVector.h" +#include "src/Core/products/SelfadjointMatrixMatrix.h" +#include "src/Core/products/SelfadjointProduct.h" +#include "src/Core/products/SelfadjointRank2Update.h" +#include "src/Core/products/TriangularMatrixVector.h" +#include "src/Core/products/TriangularMatrixMatrix.h" +#include "src/Core/products/TriangularSolverMatrix.h" +#include "src/Core/products/TriangularSolverVector.h" +#include "src/Core/BandMatrix.h" +#include "src/Core/CoreIterators.h" +#include "src/Core/ConditionEstimator.h" + +#if defined(EIGEN_VECTORIZE_VSX) +#include "src/Core/arch/AltiVec/MatrixProduct.h" +#elif defined EIGEN_VECTORIZE_NEON +#include "src/Core/arch/NEON/GeneralBlockPanelKernel.h" +#elif defined EIGEN_VECTORIZE_LSX +#include "src/Core/arch/LSX/GeneralBlockPanelKernel.h" +#endif + +#if defined(EIGEN_VECTORIZE_AVX512) +#include "src/Core/arch/AVX512/GemmKernel.h" +#endif + +#include "src/Core/Select.h" +#include "src/Core/VectorwiseOp.h" +#include "src/Core/PartialReduxEvaluator.h" +#include "src/Core/Random.h" +#include "src/Core/Replicate.h" +#include "src/Core/Reverse.h" +#include "src/Core/ArrayWrapper.h" +#include "src/Core/StlIterators.h" + +#ifdef EIGEN_USE_BLAS +#include "src/Core/products/GeneralMatrixMatrix_BLAS.h" +#include "src/Core/products/GeneralMatrixVector_BLAS.h" +#include "src/Core/products/GeneralMatrixMatrixTriangular_BLAS.h" +#include "src/Core/products/SelfadjointMatrixMatrix_BLAS.h" +#include "src/Core/products/SelfadjointMatrixVector_BLAS.h" +#include "src/Core/products/TriangularMatrixMatrix_BLAS.h" +#include "src/Core/products/TriangularMatrixVector_BLAS.h" +#include "src/Core/products/TriangularSolverMatrix_BLAS.h" +#endif // EIGEN_USE_BLAS + +#ifdef EIGEN_USE_MKL_VML +#include "src/Core/Assign_MKL.h" +#endif + +#include "src/Core/GlobalFunctions.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CORE_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Dense b/src/3rdparty/eigen/Eigen/Dense new file mode 100644 index 0000000..5768910 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Dense @@ -0,0 +1,7 @@ +#include "Core" +#include "LU" +#include "Cholesky" +#include "QR" +#include "SVD" +#include "Geometry" +#include "Eigenvalues" diff --git a/src/3rdparty/eigen/Eigen/Eigen b/src/3rdparty/eigen/Eigen/Eigen new file mode 100644 index 0000000..654c8dc --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Eigen @@ -0,0 +1,2 @@ +#include "Dense" +#include "Sparse" diff --git a/src/3rdparty/eigen/Eigen/Eigenvalues b/src/3rdparty/eigen/Eigen/Eigenvalues new file mode 100644 index 0000000..3b0bdee --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Eigenvalues @@ -0,0 +1,63 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_EIGENVALUES_MODULE_H +#define EIGEN_EIGENVALUES_MODULE_H + +#include "Core" + +#include "Cholesky" +#include "Jacobi" +#include "Householder" +#include "LU" +#include "Geometry" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Eigenvalues_Module Eigenvalues module + * + * + * + * This module mainly provides various eigenvalue solvers. + * This module also provides some MatrixBase methods, including: + * - MatrixBase::eigenvalues(), + * - MatrixBase::operatorNorm() + * + * \code + * #include + * \endcode + */ + +#include "src/misc/RealSvd2x2.h" + +// IWYU pragma: begin_exports +#include "src/Eigenvalues/Tridiagonalization.h" +#include "src/Eigenvalues/RealSchur.h" +#include "src/Eigenvalues/EigenSolver.h" +#include "src/Eigenvalues/SelfAdjointEigenSolver.h" +#include "src/Eigenvalues/GeneralizedSelfAdjointEigenSolver.h" +#include "src/Eigenvalues/HessenbergDecomposition.h" +#include "src/Eigenvalues/ComplexSchur.h" +#include "src/Eigenvalues/ComplexEigenSolver.h" +#include "src/Eigenvalues/RealQZ.h" +#include "src/Eigenvalues/GeneralizedEigenSolver.h" +#include "src/Eigenvalues/MatrixBaseEigenvalues.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/Eigenvalues/RealSchur_LAPACKE.h" +#include "src/Eigenvalues/ComplexSchur_LAPACKE.h" +#include "src/Eigenvalues/SelfAdjointEigenSolver_LAPACKE.h" +#endif +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_EIGENVALUES_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Geometry b/src/3rdparty/eigen/Eigen/Geometry new file mode 100644 index 0000000..efe3e1f --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Geometry @@ -0,0 +1,59 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GEOMETRY_MODULE_H +#define EIGEN_GEOMETRY_MODULE_H + +#include "Core" + +#include "SVD" +#include "LU" +#include + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Geometry_Module Geometry module + * + * This module provides support for: + * - fixed-size homogeneous transformations + * - translation, scaling, 2D and 3D rotations + * - \link Quaternion quaternions \endlink + * - cross products (\ref MatrixBase::cross(), \ref MatrixBase::cross3()) + * - orthogonal vector generation (MatrixBase::unitOrthogonal) + * - some linear components: \link ParametrizedLine parametrized-lines \endlink and \link Hyperplane hyperplanes \endlink + * - \link AlignedBox axis aligned bounding boxes \endlink + * - \link umeyama() least-square transformation fitting \endlink + * \code + * #include + * \endcode + */ + +// IWYU pragma: begin_exports +#include "src/Geometry/OrthoMethods.h" +#include "src/Geometry/EulerAngles.h" +#include "src/Geometry/Homogeneous.h" +#include "src/Geometry/RotationBase.h" +#include "src/Geometry/Rotation2D.h" +#include "src/Geometry/Quaternion.h" +#include "src/Geometry/AngleAxis.h" +#include "src/Geometry/Transform.h" +#include "src/Geometry/Translation.h" +#include "src/Geometry/Scaling.h" +#include "src/Geometry/Hyperplane.h" +#include "src/Geometry/ParametrizedLine.h" +#include "src/Geometry/AlignedBox.h" +#include "src/Geometry/Umeyama.h" + +// Use the SSE optimized version whenever possible. +#if (defined EIGEN_VECTORIZE_SSE) || (defined EIGEN_VECTORIZE_NEON) +#include "src/Geometry/arch/Geometry_SIMD.h" +#endif +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_GEOMETRY_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Householder b/src/3rdparty/eigen/Eigen/Householder new file mode 100644 index 0000000..5070e07 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Householder @@ -0,0 +1,31 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_HOUSEHOLDER_MODULE_H +#define EIGEN_HOUSEHOLDER_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Householder_Module Householder module + * This module provides Householder transformations. + * + * \code + * #include + * \endcode + */ + +// IWYU pragma: begin_exports +#include "src/Householder/Householder.h" +#include "src/Householder/HouseholderSequence.h" +#include "src/Householder/BlockHouseholder.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_HOUSEHOLDER_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/IterativeLinearSolvers b/src/3rdparty/eigen/Eigen/IterativeLinearSolvers new file mode 100644 index 0000000..fe5159e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/IterativeLinearSolvers @@ -0,0 +1,52 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ITERATIVELINEARSOLVERS_MODULE_H +#define EIGEN_ITERATIVELINEARSOLVERS_MODULE_H + +#include "SparseCore" +#include "OrderingMethods" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** + * \defgroup IterativeLinearSolvers_Module IterativeLinearSolvers module + * + * This module currently provides iterative methods to solve problems of the form \c A \c x = \c b, where \c A is a + squared matrix, usually very large and sparse. + * Those solvers are accessible via the following classes: + * - ConjugateGradient for selfadjoint (hermitian) matrices, + * - LeastSquaresConjugateGradient for rectangular least-square problems, + * - BiCGSTAB for general square matrices. + * + * These iterative solvers are associated with some preconditioners: + * - IdentityPreconditioner - not really useful + * - DiagonalPreconditioner - also called Jacobi preconditioner, work very well on diagonal dominant matrices. + * - IncompleteLUT - incomplete LU factorization with dual thresholding + * + * Such problems can also be solved using the direct sparse decomposition modules: SparseCholesky, CholmodSupport, + UmfPackSupport, SuperLUSupport, AccelerateSupport. + * + \code + #include + \endcode + */ + +// IWYU pragma: begin_exports +#include "src/IterativeLinearSolvers/SolveWithGuess.h" +#include "src/IterativeLinearSolvers/IterativeSolverBase.h" +#include "src/IterativeLinearSolvers/BasicPreconditioners.h" +#include "src/IterativeLinearSolvers/ConjugateGradient.h" +#include "src/IterativeLinearSolvers/LeastSquareConjugateGradient.h" +#include "src/IterativeLinearSolvers/BiCGSTAB.h" +#include "src/IterativeLinearSolvers/IncompleteLUT.h" +#include "src/IterativeLinearSolvers/IncompleteCholesky.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_ITERATIVELINEARSOLVERS_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Jacobi b/src/3rdparty/eigen/Eigen/Jacobi new file mode 100644 index 0000000..31eb36a --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Jacobi @@ -0,0 +1,33 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_JACOBI_MODULE_H +#define EIGEN_JACOBI_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Jacobi_Module Jacobi module + * This module provides Jacobi and Givens rotations. + * + * \code + * #include + * \endcode + * + * In addition to listed classes, it defines the two following MatrixBase methods to apply a Jacobi or Givens rotation: + * - MatrixBase::applyOnTheLeft() + * - MatrixBase::applyOnTheRight(). + */ + +// IWYU pragma: begin_exports +#include "src/Jacobi/Jacobi.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_JACOBI_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/KLUSupport b/src/3rdparty/eigen/Eigen/KLUSupport new file mode 100644 index 0000000..13959a3 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/KLUSupport @@ -0,0 +1,43 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_KLUSUPPORT_MODULE_H +#define EIGEN_KLUSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +extern "C" { +#include +#include +} + +/** \ingroup Support_modules + * \defgroup KLUSupport_Module KLUSupport module + * + * This module provides an interface to the KLU library which is part of the suitesparse package. It provides the following factorization class: + * - class KLU: a sparse LU factorization, well-suited for circuit simulation. + * + * \code + * #include + * \endcode + * + * In order to use this module, the klu and btf headers must be accessible from the include paths, and your binary must + * be linked to the klu library and its dependencies. The dependencies depend on how umfpack has been compiled. For a + * cmake based project, you can use our FindKLU.cmake module to help you in this task. + * + */ + +// IWYU pragma: begin_exports +#include "src/KLUSupport/KLUSupport.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_KLUSUPPORT_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/LU b/src/3rdparty/eigen/Eigen/LU new file mode 100644 index 0000000..d804480 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/LU @@ -0,0 +1,46 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LU_MODULE_H +#define EIGEN_LU_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup LU_Module LU module + * This module includes %LU decomposition and related notions such as matrix inversion and determinant. + * This module defines the following MatrixBase methods: + * - MatrixBase::inverse() + * - MatrixBase::determinant() + * + * \code + * #include + * \endcode + */ + +#include "src/misc/Kernel.h" +#include "src/misc/Image.h" + +// IWYU pragma: begin_exports +#include "src/LU/FullPivLU.h" +#include "src/LU/PartialPivLU.h" +#ifdef EIGEN_USE_LAPACKE +#include "src/misc/lapacke_helpers.h" +#include "src/LU/PartialPivLU_LAPACKE.h" +#endif +#include "src/LU/Determinant.h" +#include "src/LU/InverseImpl.h" + +#if defined EIGEN_VECTORIZE_SSE || defined EIGEN_VECTORIZE_NEON +#include "src/LU/arch/InverseSize4.h" +#endif +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_LU_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/MetisSupport b/src/3rdparty/eigen/Eigen/MetisSupport new file mode 100644 index 0000000..3636d3a --- /dev/null +++ b/src/3rdparty/eigen/Eigen/MetisSupport @@ -0,0 +1,35 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_METISSUPPORT_MODULE_H +#define EIGEN_METISSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +extern "C" { +#include +} + +/** \ingroup Support_modules + * \defgroup MetisSupport_Module MetisSupport module + * + * \code + * #include + * \endcode + * This module defines an interface to the METIS reordering package (http://glaros.dtc.umn.edu/gkhome/views/metis). + * It can be used just as any other built-in method as explained in \link OrderingMethods_Module here. \endlink + */ + +// IWYU pragma: begin_exports +#include "src/MetisSupport/MetisSupport.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_METISSUPPORT_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/OrderingMethods b/src/3rdparty/eigen/Eigen/OrderingMethods new file mode 100644 index 0000000..0167419 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/OrderingMethods @@ -0,0 +1,73 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ORDERINGMETHODS_MODULE_H +#define EIGEN_ORDERINGMETHODS_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** + * \defgroup OrderingMethods_Module OrderingMethods module + * + * This module is currently for internal use only + * + * It defines various built-in and external ordering methods for sparse matrices. + * They are typically used to reduce the number of elements during + * the sparse matrix decomposition (LLT, LU, QR). + * Precisely, in a preprocessing step, a permutation matrix P is computed using + * those ordering methods and applied to the columns of the matrix. + * Using for instance the sparse Cholesky decomposition, it is expected that + * the nonzeros elements in LLT(A*P) will be much smaller than that in LLT(A). + * + * + * Usage : + * \code + * #include + * \endcode + * + * A simple usage is as a template parameter in the sparse decomposition classes : + * + * \code + * SparseLU > solver; + * \endcode + * + * \code + * SparseQR > solver; + * \endcode + * + * It is possible as well to call directly a particular ordering method for your own purpose, + * \code + * AMDOrdering ordering; + * PermutationMatrix perm; + * SparseMatrix A; + * //Fill the matrix ... + * + * ordering(A, perm); // Call AMD + * \endcode + * + * \note Some of these methods (like AMD or METIS), need the sparsity pattern + * of the input matrix to be symmetric. When the matrix is structurally unsymmetric, + * Eigen computes internally the pattern of \f$A^T*A\f$ before calling the method. + * If your matrix is already symmetric (at least in structure), you can avoid that + * by calling the method with a SelfAdjointView type. + * + * \code + * // Call the ordering on the pattern of the lower triangular matrix A + * ordering(A.selfadjointView(), perm); + * \endcode + */ + +// IWYU pragma: begin_exports +#include "src/OrderingMethods/Amd.h" +#include "src/OrderingMethods/Ordering.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_ORDERINGMETHODS_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/PaStiXSupport b/src/3rdparty/eigen/Eigen/PaStiXSupport new file mode 100644 index 0000000..dd1cfcb --- /dev/null +++ b/src/3rdparty/eigen/Eigen/PaStiXSupport @@ -0,0 +1,51 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PASTIXSUPPORT_MODULE_H +#define EIGEN_PASTIXSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +extern "C" { +#include +#include +} + +#ifdef complex +#undef complex +#endif + +/** \ingroup Support_modules + * \defgroup PaStiXSupport_Module PaStiXSupport module + * + * This module provides an interface to the PaSTiX library. + * PaSTiX is a general \b supernodal, \b parallel and \b opensource sparse solver. + * It provides the two following main factorization classes: + * - class PastixLLT : a supernodal, parallel LLt Cholesky factorization. + * - class PastixLDLT: a supernodal, parallel LDLt Cholesky factorization. + * - class PastixLU : a supernodal, parallel LU factorization (optimized for a symmetric pattern). + * + * \code + * #include + * \endcode + * + * In order to use this module, the PaSTiX headers must be accessible from the include paths, and your binary must be + * linked to the PaSTiX library and its dependencies. This wrapper resuires PaStiX version 5.x compiled without MPI + * support. The dependencies depend on how PaSTiX has been compiled. For a cmake based project, you can use our + * FindPaSTiX.cmake module to help you in this task. + * + */ + +// IWYU pragma: begin_exports +#include "src/PaStiXSupport/PaStiXSupport.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_PASTIXSUPPORT_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/PardisoSupport b/src/3rdparty/eigen/Eigen/PardisoSupport new file mode 100644 index 0000000..4aef5fb --- /dev/null +++ b/src/3rdparty/eigen/Eigen/PardisoSupport @@ -0,0 +1,38 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PARDISOSUPPORT_MODULE_H +#define EIGEN_PARDISOSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +#include + +/** \ingroup Support_modules + * \defgroup PardisoSupport_Module PardisoSupport module + * + * This module brings support for the Intel(R) MKL PARDISO direct sparse solvers. + * + * \code + * #include + * \endcode + * + * In order to use this module, the MKL headers must be accessible from the include paths, and your binary must be + * linked to the MKL library and its dependencies. See this \ref TopicUsingIntelMKL "page" for more information on + * MKL-Eigen integration. + * + */ + +// IWYU pragma: begin_exports +#include "src/PardisoSupport/PardisoSupport.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_PARDISOSUPPORT_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/QR b/src/3rdparty/eigen/Eigen/QR new file mode 100644 index 0000000..c38b453 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/QR @@ -0,0 +1,48 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_QR_MODULE_H +#define EIGEN_QR_MODULE_H + +#include "Core" + +#include "Cholesky" +#include "Jacobi" +#include "Householder" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup QR_Module QR module + * + * + * + * This module provides various QR decompositions + * This module also provides some MatrixBase methods, including: + * - MatrixBase::householderQr() + * - MatrixBase::colPivHouseholderQr() + * - MatrixBase::fullPivHouseholderQr() + * + * \code + * #include + * \endcode + */ + +// IWYU pragma: begin_exports +#include "src/QR/HouseholderQR.h" +#include "src/QR/FullPivHouseholderQR.h" +#include "src/QR/ColPivHouseholderQR.h" +#include "src/QR/CompleteOrthogonalDecomposition.h" +#ifdef EIGEN_USE_LAPACKE +#include "src/misc/lapacke_helpers.h" +#include "src/QR/HouseholderQR_LAPACKE.h" +#include "src/QR/ColPivHouseholderQR_LAPACKE.h" +#endif +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_QR_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/QtAlignedMalloc b/src/3rdparty/eigen/Eigen/QtAlignedMalloc new file mode 100644 index 0000000..585f8e8 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/QtAlignedMalloc @@ -0,0 +1,32 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_QTMALLOC_MODULE_H +#define EIGEN_QTMALLOC_MODULE_H + +#include "Core" + +#if (!EIGEN_MALLOC_ALREADY_ALIGNED) + +#include "src/Core/util/DisableStupidWarnings.h" + +void *qMalloc(std::size_t size) { return Eigen::internal::aligned_malloc(size); } + +void qFree(void *ptr) { Eigen::internal::aligned_free(ptr); } + +void *qRealloc(void *ptr, std::size_t size) { + void *newPtr = Eigen::internal::aligned_malloc(size); + std::memcpy(newPtr, ptr, size); + Eigen::internal::aligned_free(ptr); + return newPtr; +} + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif + +#endif // EIGEN_QTMALLOC_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/SPQRSupport b/src/3rdparty/eigen/Eigen/SPQRSupport new file mode 100644 index 0000000..c01dbe0 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/SPQRSupport @@ -0,0 +1,41 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPQRSUPPORT_MODULE_H +#define EIGEN_SPQRSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +#include "SuiteSparseQR.hpp" + +/** \ingroup Support_modules + * \defgroup SPQRSupport_Module SuiteSparseQR module + * + * This module provides an interface to the SPQR library, which is part of the suitesparse package. + * + * \code + * #include + * \endcode + * + * In order to use this module, the SPQR headers must be accessible from the include paths, and your binary must be + * linked to the SPQR library and its dependencies (Cholmod, AMD, COLAMD,...). For a cmake based project, you can use + * our FindSPQR.cmake and FindCholmod.Cmake modules + * + */ + +#include "CholmodSupport" + +// IWYU pragma: begin_exports +#include "src/SPQRSupport/SuiteSparseQRSupport.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif diff --git a/src/3rdparty/eigen/Eigen/SVD b/src/3rdparty/eigen/Eigen/SVD new file mode 100644 index 0000000..2a013f8 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/SVD @@ -0,0 +1,56 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SVD_MODULE_H +#define EIGEN_SVD_MODULE_H + +#include "QR" +#include "Householder" +#include "Jacobi" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup SVD_Module SVD module + * + * + * + * This module provides SVD decomposition for matrices (both real and complex). + * Two decomposition algorithms are provided: + * - JacobiSVD implementing two-sided Jacobi iterations is numerically very accurate, fast for small matrices, but very + * slow for larger ones. + * - BDCSVD implementing a recursive divide & conquer strategy on top of an upper-bidiagonalization which remains fast + * for large problems. These decompositions are accessible via the respective classes and following MatrixBase methods: + * - MatrixBase::jacobiSvd() + * - MatrixBase::bdcSvd() + * + * \code + * #include + * \endcode + */ + +// IWYU pragma: begin_exports +#include "src/misc/RealSvd2x2.h" +#include "src/SVD/UpperBidiagonalization.h" +#include "src/SVD/SVDBase.h" +#include "src/SVD/JacobiSVD.h" +#include "src/SVD/BDCSVD.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#ifndef EIGEN_USE_LAPACKE_STRICT +#include "src/SVD/JacobiSVD_LAPACKE.h" +#endif +#include "src/SVD/BDCSVD_LAPACKE.h" +#endif +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SVD_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Sparse b/src/3rdparty/eigen/Eigen/Sparse new file mode 100644 index 0000000..4d0ee8b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Sparse @@ -0,0 +1,33 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSE_MODULE_H +#define EIGEN_SPARSE_MODULE_H + +/** \defgroup Sparse_Module Sparse meta-module + * + * Meta-module including all related modules: + * - \ref SparseCore_Module + * - \ref OrderingMethods_Module + * - \ref SparseCholesky_Module + * - \ref SparseLU_Module + * - \ref SparseQR_Module + * - \ref IterativeLinearSolvers_Module + * + \code + #include + \endcode + */ + +#include "SparseCore" +#include "OrderingMethods" +#include "SparseCholesky" +#include "SparseLU" +#include "SparseQR" +#include "IterativeLinearSolvers" + +#endif // EIGEN_SPARSE_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/SparseCholesky b/src/3rdparty/eigen/Eigen/SparseCholesky new file mode 100644 index 0000000..6abdcd6 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/SparseCholesky @@ -0,0 +1,40 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2013 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSECHOLESKY_MODULE_H +#define EIGEN_SPARSECHOLESKY_MODULE_H + +#include "SparseCore" +#include "OrderingMethods" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** + * \defgroup SparseCholesky_Module SparseCholesky module + * + * This module currently provides two variants of the direct sparse Cholesky decomposition for selfadjoint (hermitian) + * matrices. Those decompositions are accessible via the following classes: + * - SimplicialLLt, + * - SimplicialLDLt + * + * Such problems can also be solved using the ConjugateGradient solver from the IterativeLinearSolvers module. + * + * \code + * #include + * \endcode + */ + +// IWYU pragma: begin_exports +#include "src/SparseCholesky/SimplicialCholesky.h" +#include "src/SparseCholesky/SimplicialCholesky_impl.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SPARSECHOLESKY_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/SparseCore b/src/3rdparty/eigen/Eigen/SparseCore new file mode 100644 index 0000000..56a9401 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/SparseCore @@ -0,0 +1,70 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSECORE_MODULE_H +#define EIGEN_SPARSECORE_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +#include +#include +#include +#include +#include +#include + +/** + * \defgroup SparseCore_Module SparseCore module + * + * This module provides a sparse matrix representation, and basic associated matrix manipulations + * and operations. + * + * See the \ref TutorialSparse "Sparse tutorial" + * + * \code + * #include + * \endcode + * + * This module depends on: Core. + */ + +// IWYU pragma: begin_exports +#include "src/SparseCore/SparseUtil.h" +#include "src/SparseCore/SparseMatrixBase.h" +#include "src/SparseCore/SparseAssign.h" +#include "src/SparseCore/CompressedStorage.h" +#include "src/SparseCore/AmbiVector.h" +#include "src/SparseCore/SparseCompressedBase.h" +#include "src/SparseCore/SparseMatrix.h" +#include "src/SparseCore/SparseMap.h" +#include "src/SparseCore/SparseVector.h" +#include "src/SparseCore/SparseRef.h" +#include "src/SparseCore/SparseCwiseUnaryOp.h" +#include "src/SparseCore/SparseCwiseBinaryOp.h" +#include "src/SparseCore/SparseTranspose.h" +#include "src/SparseCore/SparseBlock.h" +#include "src/SparseCore/SparseDot.h" +#include "src/SparseCore/SparseRedux.h" +#include "src/SparseCore/SparseView.h" +#include "src/SparseCore/SparseDiagonalProduct.h" +#include "src/SparseCore/ConservativeSparseSparseProduct.h" +#include "src/SparseCore/SparseSparseProductWithPruning.h" +#include "src/SparseCore/SparseProduct.h" +#include "src/SparseCore/SparseDenseProduct.h" +#include "src/SparseCore/SparseSelfAdjointView.h" +#include "src/SparseCore/SparseTriangularView.h" +#include "src/SparseCore/TriangularSolver.h" +#include "src/SparseCore/SparsePermutation.h" +#include "src/SparseCore/SparseFuzzy.h" +#include "src/SparseCore/SparseSolverBase.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SPARSECORE_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/SparseLU b/src/3rdparty/eigen/Eigen/SparseLU new file mode 100644 index 0000000..6faf130 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/SparseLU @@ -0,0 +1,50 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2012 Désiré Nuentsa-Wakam +// Copyright (C) 2012 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSELU_MODULE_H +#define EIGEN_SPARSELU_MODULE_H + +#include "SparseCore" + +/** + * \defgroup SparseLU_Module SparseLU module + * This module defines a supernodal factorization of general sparse matrices. + * The code is fully optimized for supernode-panel updates with specialized kernels. + * Please, see the documentation of the SparseLU class for more details. + */ + +// Ordering interface +#include "OrderingMethods" + +#include "src/Core/util/DisableStupidWarnings.h" + +// IWYU pragma: begin_exports +#include "src/SparseLU/SparseLU_Structs.h" +#include "src/SparseLU/SparseLU_SupernodalMatrix.h" +#include "src/SparseLU/SparseLUImpl.h" +#include "src/SparseCore/SparseColEtree.h" +#include "src/SparseLU/SparseLU_Memory.h" +#include "src/SparseLU/SparseLU_heap_relax_snode.h" +#include "src/SparseLU/SparseLU_relax_snode.h" +#include "src/SparseLU/SparseLU_pivotL.h" +#include "src/SparseLU/SparseLU_panel_dfs.h" +#include "src/SparseLU/SparseLU_kernel_bmod.h" +#include "src/SparseLU/SparseLU_panel_bmod.h" +#include "src/SparseLU/SparseLU_column_dfs.h" +#include "src/SparseLU/SparseLU_column_bmod.h" +#include "src/SparseLU/SparseLU_copy_to_ucol.h" +#include "src/SparseLU/SparseLU_pruneL.h" +#include "src/SparseLU/SparseLU_Utils.h" +#include "src/SparseLU/SparseLU.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SPARSELU_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/SparseQR b/src/3rdparty/eigen/Eigen/SparseQR new file mode 100644 index 0000000..b4f1cad --- /dev/null +++ b/src/3rdparty/eigen/Eigen/SparseQR @@ -0,0 +1,38 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSEQR_MODULE_H +#define EIGEN_SPARSEQR_MODULE_H + +#include "SparseCore" +#include "OrderingMethods" +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup SparseQR_Module SparseQR module + * \brief Provides QR decomposition for sparse matrices + * + * This module provides a simplicial version of the left-looking Sparse QR decomposition. + * The columns of the input matrix should be reordered to limit the fill-in during the + * decomposition. Built-in methods (COLAMD, AMD) or external methods (METIS) can be used to this end. + * See the \link OrderingMethods_Module OrderingMethods\endlink module for the list + * of built-in and external ordering methods. + * + * \code + * #include + * \endcode + * + * + */ + +// IWYU pragma: begin_exports +#include "src/SparseCore/SparseColEtree.h" +#include "src/SparseQR/SparseQR.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif diff --git a/src/3rdparty/eigen/Eigen/StdDeque b/src/3rdparty/eigen/Eigen/StdDeque new file mode 100644 index 0000000..01e1d76 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/StdDeque @@ -0,0 +1,30 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// Copyright (C) 2009 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STDDEQUE_MODULE_H +#define EIGEN_STDDEQUE_MODULE_H + +#include "Core" +#include + +#if EIGEN_COMP_MSVC && EIGEN_OS_WIN64 && \ + (EIGEN_MAX_STATIC_ALIGN_BYTES <= 16) /* MSVC auto aligns up to 16 bytes in 64 bit builds */ + +#define EIGEN_DEFINE_STL_DEQUE_SPECIALIZATION(...) + +#else + +// IWYU pragma: begin_exports +#include "src/StlSupport/StdDeque.h" +// IWYU pragma: end_exports + +#endif + +#endif // EIGEN_STDDEQUE_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/StdList b/src/3rdparty/eigen/Eigen/StdList new file mode 100644 index 0000000..1453c9f --- /dev/null +++ b/src/3rdparty/eigen/Eigen/StdList @@ -0,0 +1,29 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STDLIST_MODULE_H +#define EIGEN_STDLIST_MODULE_H + +#include "Core" +#include + +#if EIGEN_COMP_MSVC && EIGEN_OS_WIN64 && \ + (EIGEN_MAX_STATIC_ALIGN_BYTES <= 16) /* MSVC auto aligns up to 16 bytes in 64 bit builds */ + +#define EIGEN_DEFINE_STL_LIST_SPECIALIZATION(...) + +#else + +// IWYU pragma: begin_exports +#include "src/StlSupport/StdList.h" +// IWYU pragma: end_exports + +#endif + +#endif // EIGEN_STDLIST_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/StdVector b/src/3rdparty/eigen/Eigen/StdVector new file mode 100644 index 0000000..711a654 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/StdVector @@ -0,0 +1,30 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// Copyright (C) 2009 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STDVECTOR_MODULE_H +#define EIGEN_STDVECTOR_MODULE_H + +#include "Core" +#include + +#if EIGEN_COMP_MSVC && EIGEN_OS_WIN64 && \ + (EIGEN_MAX_STATIC_ALIGN_BYTES <= 16) /* MSVC auto aligns up to 16 bytes in 64 bit builds */ + +#define EIGEN_DEFINE_STL_VECTOR_SPECIALIZATION(...) + +#else + +// IWYU pragma: begin_exports +#include "src/StlSupport/StdVector.h" +// IWYU pragma: end_exports + +#endif + +#endif // EIGEN_STDVECTOR_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/SuperLUSupport b/src/3rdparty/eigen/Eigen/SuperLUSupport new file mode 100644 index 0000000..79e2222 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/SuperLUSupport @@ -0,0 +1,70 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SUPERLUSUPPORT_MODULE_H +#define EIGEN_SUPERLUSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +#ifdef EMPTY +#define EIGEN_EMPTY_WAS_ALREADY_DEFINED +#endif + +typedef int int_t; +#include +#include +#include + +// slu_util.h defines a preprocessor token named EMPTY which is really polluting, +// so we remove it in favor of a SUPERLU_EMPTY token. +// If EMPTY was already defined then we don't undef it. + +#if defined(EIGEN_EMPTY_WAS_ALREADY_DEFINED) +#undef EIGEN_EMPTY_WAS_ALREADY_DEFINED +#elif defined(EMPTY) +#undef EMPTY +#endif + +#define SUPERLU_EMPTY (-1) + +namespace Eigen { +struct SluMatrix; +} + +/** \ingroup Support_modules + * \defgroup SuperLUSupport_Module SuperLUSupport module + * + * This module provides an interface to the SuperLU library. + * It provides the following factorization class: + * - class SuperLU: a supernodal sequential LU factorization. + * - class SuperILU: a supernodal sequential incomplete LU factorization (to be used as a preconditioner for iterative + * methods). + * + * \warning This wrapper requires at least versions 4.0 of SuperLU. The 3.x versions are not supported. + * + * \warning When including this module, you have to use SUPERLU_EMPTY instead of EMPTY which is no longer defined + * because it is too polluting. + * + * \code + * #include + * \endcode + * + * In order to use this module, the superlu headers must be accessible from the include paths, and your binary must be + * linked to the superlu library and its dependencies. The dependencies depend on how superlu has been compiled. For a + * cmake based project, you can use our FindSuperLU.cmake module to help you in this task. + * + */ + +// IWYU pragma: begin_exports +#include "src/SuperLUSupport/SuperLUSupport.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SUPERLUSUPPORT_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/ThreadPool b/src/3rdparty/eigen/Eigen/ThreadPool new file mode 100644 index 0000000..39e5d1e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/ThreadPool @@ -0,0 +1,80 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2016 Benoit Steiner +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_THREADPOOL_MODULE_H +#define EIGEN_THREADPOOL_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup ThreadPool_Module ThreadPool Module + * + * This module provides 2 threadpool implementations + * - a simple reference implementation + * - a faster non blocking implementation + * + * \code + * #include + * \endcode + */ + +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +// There are non-parenthesized calls to "max" in the header, +// which trigger a check in test/main.h causing compilation to fail. +// We work around the check here by removing the check for max in +// the case where we have to emulate thread_local. +#ifdef max +#undef max +#endif +#include + +#include "src/Core/util/Meta.h" +#include "src/Core/util/MaxSizeVector.h" + +#ifndef EIGEN_MUTEX +#define EIGEN_MUTEX std::mutex +#endif +#ifndef EIGEN_MUTEX_LOCK +#define EIGEN_MUTEX_LOCK std::unique_lock +#endif +#ifndef EIGEN_CONDVAR +#define EIGEN_CONDVAR std::condition_variable +#endif + +// IWYU pragma: begin_exports +#include "src/ThreadPool/ThreadLocal.h" +#include "src/ThreadPool/ThreadYield.h" +#include "src/ThreadPool/ThreadCancel.h" +#include "src/ThreadPool/EventCount.h" +#include "src/ThreadPool/RunQueue.h" +#include "src/ThreadPool/ThreadPoolInterface.h" +#include "src/ThreadPool/ThreadEnvironment.h" +#include "src/ThreadPool/Barrier.h" +#include "src/ThreadPool/NonBlockingThreadPool.h" +#include "src/ThreadPool/CoreThreadPoolDevice.h" +#include "src/ThreadPool/ForkJoin.h" +// IWYU pragma: end_exports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CXX11_THREADPOOL_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/UmfPackSupport b/src/3rdparty/eigen/Eigen/UmfPackSupport new file mode 100644 index 0000000..126344c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/UmfPackSupport @@ -0,0 +1,42 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_UMFPACKSUPPORT_MODULE_H +#define EIGEN_UMFPACKSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +extern "C" { +#include +} + +/** \ingroup Support_modules + * \defgroup UmfPackSupport_Module UmfPackSupport module + * + * This module provides an interface to the UmfPack library which is part of the suitesparse package. It provides the following factorization class: + * - class UmfPackLU: a multifrontal sequential LU factorization. + * + * \code + * #include + * \endcode + * + * In order to use this module, the umfpack headers must be accessible from the include paths, and your binary must be + * linked to the umfpack library and its dependencies. The dependencies depend on how umfpack has been compiled. For a + * cmake based project, you can use our FindUmfPack.cmake module to help you in this task. + * + */ + +// IWYU pragma: begin_exports +#include "src/UmfPackSupport/UmfPackSupport.h" +// IWYU pragma: endexports + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_UMFPACKSUPPORT_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Version b/src/3rdparty/eigen/Eigen/Version new file mode 100644 index 0000000..9cfd71f --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Version @@ -0,0 +1,14 @@ +#ifndef EIGEN_VERSION_H +#define EIGEN_VERSION_H + +// The "WORLD" version will forever remain "3" for the "Eigen3" library. +#define EIGEN_WORLD_VERSION 3 +// As of Eigen3 5.0.0, we have moved to Semantic Versioning (semver.org). +#define EIGEN_MAJOR_VERSION 5 +#define EIGEN_MINOR_VERSION 0 +#define EIGEN_PATCH_VERSION 1 +#define EIGEN_PRERELEASE_VERSION "" +#define EIGEN_BUILD_VERSION "" +#define EIGEN_VERSION_STRING "5.0.1" + +#endif // EIGEN_VERSION_H diff --git a/src/3rdparty/eigen/Eigen/src/AccelerateSupport/AccelerateSupport.h b/src/3rdparty/eigen/Eigen/src/AccelerateSupport/AccelerateSupport.h new file mode 100644 index 0000000..13a26df --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/AccelerateSupport/AccelerateSupport.h @@ -0,0 +1,423 @@ +#ifndef EIGEN_ACCELERATESUPPORT_H +#define EIGEN_ACCELERATESUPPORT_H + +#include + +#include + +namespace Eigen { + +template +class AccelerateImpl; + +/** \ingroup AccelerateSupport_Module + * \typedef AccelerateLLT + * \brief A direct Cholesky (LLT) factorization and solver based on Accelerate + * + * \warning Only single and double precision real scalar types are supported by Accelerate + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ additional information about the matrix structure. Default is Lower. + * + * \sa \ref TutorialSparseSolverConcept, class AccelerateLLT + */ +template +using AccelerateLLT = AccelerateImpl; + +/** \ingroup AccelerateSupport_Module + * \typedef AccelerateLDLT + * \brief The default Cholesky (LDLT) factorization and solver based on Accelerate + * + * \warning Only single and double precision real scalar types are supported by Accelerate + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ additional information about the matrix structure. Default is Lower. + * + * \sa \ref TutorialSparseSolverConcept, class AccelerateLDLT + */ +template +using AccelerateLDLT = AccelerateImpl; + +/** \ingroup AccelerateSupport_Module + * \typedef AccelerateLDLTUnpivoted + * \brief A direct Cholesky-like LDL^T factorization and solver based on Accelerate with only 1x1 pivots and no pivoting + * + * \warning Only single and double precision real scalar types are supported by Accelerate + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ additional information about the matrix structure. Default is Lower. + * + * \sa \ref TutorialSparseSolverConcept, class AccelerateLDLTUnpivoted + */ +template +using AccelerateLDLTUnpivoted = AccelerateImpl; + +/** \ingroup AccelerateSupport_Module + * \typedef AccelerateLDLTSBK + * \brief A direct Cholesky (LDLT) factorization and solver based on Accelerate with Supernode Bunch-Kaufman and static + * pivoting + * + * \warning Only single and double precision real scalar types are supported by Accelerate + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ additional information about the matrix structure. Default is Lower. + * + * \sa \ref TutorialSparseSolverConcept, class AccelerateLDLTSBK + */ +template +using AccelerateLDLTSBK = AccelerateImpl; + +/** \ingroup AccelerateSupport_Module + * \typedef AccelerateLDLTTPP + * \brief A direct Cholesky (LDLT) factorization and solver based on Accelerate with full threshold partial pivoting + * + * \warning Only single and double precision real scalar types are supported by Accelerate + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ additional information about the matrix structure. Default is Lower. + * + * \sa \ref TutorialSparseSolverConcept, class AccelerateLDLTTPP + */ +template +using AccelerateLDLTTPP = AccelerateImpl; + +/** \ingroup AccelerateSupport_Module + * \typedef AccelerateQR + * \brief A QR factorization and solver based on Accelerate + * + * \warning Only single and double precision real scalar types are supported by Accelerate + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * + * \sa \ref TutorialSparseSolverConcept, class AccelerateQR + */ +template +using AccelerateQR = AccelerateImpl; + +/** \ingroup AccelerateSupport_Module + * \typedef AccelerateCholeskyAtA + * \brief A QR factorization and solver based on Accelerate without storing Q (equivalent to A^TA = R^T R) + * + * \warning Only single and double precision real scalar types are supported by Accelerate + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * + * \sa \ref TutorialSparseSolverConcept, class AccelerateCholeskyAtA + */ +template +using AccelerateCholeskyAtA = AccelerateImpl; + +namespace internal { +template +struct AccelFactorizationDeleter { + void operator()(T* sym) { + if (sym) { + SparseCleanup(*sym); + delete sym; + sym = nullptr; + } + } +}; + +template +struct SparseTypesTraitBase { + typedef DenseVecT AccelDenseVector; + typedef DenseMatT AccelDenseMatrix; + typedef SparseMatT AccelSparseMatrix; + + typedef SparseOpaqueSymbolicFactorization SymbolicFactorization; + typedef NumFactT NumericFactorization; + + typedef AccelFactorizationDeleter SymbolicFactorizationDeleter; + typedef AccelFactorizationDeleter NumericFactorizationDeleter; +}; + +template +struct SparseTypesTrait {}; + +template <> +struct SparseTypesTrait : SparseTypesTraitBase {}; + +template <> +struct SparseTypesTrait + : SparseTypesTraitBase { +}; + +} // end namespace internal + +template +class AccelerateImpl : public SparseSolverBase > { + protected: + using Base = SparseSolverBase; + using Base::derived; + using Base::m_isInitialized; + + public: + using Base::_solve_impl; + + typedef MatrixType_ MatrixType; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::StorageIndex StorageIndex; + enum { ColsAtCompileTime = Dynamic, MaxColsAtCompileTime = Dynamic }; + enum { UpLo = UpLo_ }; + + using AccelDenseVector = typename internal::SparseTypesTrait::AccelDenseVector; + using AccelDenseMatrix = typename internal::SparseTypesTrait::AccelDenseMatrix; + using AccelSparseMatrix = typename internal::SparseTypesTrait::AccelSparseMatrix; + using SymbolicFactorization = typename internal::SparseTypesTrait::SymbolicFactorization; + using NumericFactorization = typename internal::SparseTypesTrait::NumericFactorization; + using SymbolicFactorizationDeleter = typename internal::SparseTypesTrait::SymbolicFactorizationDeleter; + using NumericFactorizationDeleter = typename internal::SparseTypesTrait::NumericFactorizationDeleter; + + AccelerateImpl() { + m_isInitialized = false; + + auto check_flag_set = [](int value, int flag) { return ((value & flag) == flag); }; + + if (check_flag_set(UpLo_, Symmetric)) { + m_sparseKind = SparseSymmetric; + m_triType = (UpLo_ & Lower) ? SparseLowerTriangle : SparseUpperTriangle; + } else if (check_flag_set(UpLo_, UnitLower)) { + m_sparseKind = SparseUnitTriangular; + m_triType = SparseLowerTriangle; + } else if (check_flag_set(UpLo_, UnitUpper)) { + m_sparseKind = SparseUnitTriangular; + m_triType = SparseUpperTriangle; + } else if (check_flag_set(UpLo_, StrictlyLower)) { + m_sparseKind = SparseTriangular; + m_triType = SparseLowerTriangle; + } else if (check_flag_set(UpLo_, StrictlyUpper)) { + m_sparseKind = SparseTriangular; + m_triType = SparseUpperTriangle; + } else if (check_flag_set(UpLo_, Lower)) { + m_sparseKind = SparseTriangular; + m_triType = SparseLowerTriangle; + } else if (check_flag_set(UpLo_, Upper)) { + m_sparseKind = SparseTriangular; + m_triType = SparseUpperTriangle; + } else { + m_sparseKind = SparseOrdinary; + m_triType = (UpLo_ & Lower) ? SparseLowerTriangle : SparseUpperTriangle; + } + + m_order = SparseOrderDefault; + } + + explicit AccelerateImpl(const MatrixType& matrix) : AccelerateImpl() { compute(matrix); } + + ~AccelerateImpl() {} + + inline Index cols() const { return m_nCols; } + inline Index rows() const { return m_nRows; } + + ComputationInfo info() const { + eigen_assert(m_isInitialized && "Decomposition is not initialized."); + return m_info; + } + + void analyzePattern(const MatrixType& matrix); + + void factorize(const MatrixType& matrix); + + void compute(const MatrixType& matrix); + + template + void _solve_impl(const MatrixBase& b, MatrixBase& dest) const; + + /** Sets the ordering algorithm to use. */ + void setOrder(SparseOrder_t order) { m_order = order; } + + private: + template + void buildAccelSparseMatrix(const SparseMatrix& a, AccelSparseMatrix& A, std::vector& columnStarts) { + const Index nColumnsStarts = a.cols() + 1; + + columnStarts.resize(nColumnsStarts); + + for (Index i = 0; i < nColumnsStarts; i++) columnStarts[i] = a.outerIndexPtr()[i]; + + SparseAttributes_t attributes{}; + attributes.transpose = false; + attributes.triangle = m_triType; + attributes.kind = m_sparseKind; + + SparseMatrixStructure structure{}; + structure.attributes = attributes; + structure.rowCount = static_cast(a.rows()); + structure.columnCount = static_cast(a.cols()); + structure.blockSize = 1; + structure.columnStarts = columnStarts.data(); + structure.rowIndices = const_cast(a.innerIndexPtr()); + + A.structure = structure; + A.data = const_cast(a.valuePtr()); + } + + void doAnalysis(AccelSparseMatrix& A) { + m_numericFactorization.reset(nullptr); + + SparseSymbolicFactorOptions opts{}; + opts.control = SparseDefaultControl; + opts.orderMethod = m_order; + opts.order = nullptr; + opts.ignoreRowsAndColumns = nullptr; + opts.malloc = malloc; + opts.free = free; + opts.reportError = nullptr; + + m_symbolicFactorization.reset(new SymbolicFactorization(SparseFactor(Solver_, A.structure, opts))); + + SparseStatus_t status = m_symbolicFactorization->status; + + updateInfoStatus(status); + + if (status != SparseStatusOK) m_symbolicFactorization.reset(nullptr); + } + + void doFactorization(AccelSparseMatrix& A) { + SparseStatus_t status = SparseStatusReleased; + + if (m_symbolicFactorization) { + m_numericFactorization.reset(new NumericFactorization(SparseFactor(*m_symbolicFactorization, A))); + + status = m_numericFactorization->status; + + if (status != SparseStatusOK) m_numericFactorization.reset(nullptr); + } + + updateInfoStatus(status); + } + + protected: + void updateInfoStatus(SparseStatus_t status) const { + switch (status) { + case SparseStatusOK: + m_info = Success; + break; + case SparseFactorizationFailed: + case SparseMatrixIsSingular: + m_info = NumericalIssue; + break; + case SparseInternalError: + case SparseParameterError: + case SparseStatusReleased: + default: + m_info = InvalidInput; + break; + } + } + + mutable ComputationInfo m_info; + Index m_nRows, m_nCols; + std::unique_ptr m_symbolicFactorization; + std::unique_ptr m_numericFactorization; + SparseKind_t m_sparseKind; + SparseTriangle_t m_triType; + SparseOrder_t m_order; +}; + +/** Computes the symbolic and numeric decomposition of matrix \a a */ +template +void AccelerateImpl::compute(const MatrixType& a) { + if (EnforceSquare_) eigen_assert(a.rows() == a.cols()); + + m_nRows = a.rows(); + m_nCols = a.cols(); + + AccelSparseMatrix A{}; + std::vector columnStarts; + + buildAccelSparseMatrix(a, A, columnStarts); + + doAnalysis(A); + + if (m_symbolicFactorization) doFactorization(A); + + m_isInitialized = true; +} + +/** Performs a symbolic decomposition on the sparsity pattern of matrix \a a. + * + * This function is particularly useful when solving for several problems having the same structure. + * + * \sa factorize() + */ +template +void AccelerateImpl::analyzePattern(const MatrixType& a) { + if (EnforceSquare_) eigen_assert(a.rows() == a.cols()); + + m_nRows = a.rows(); + m_nCols = a.cols(); + + AccelSparseMatrix A{}; + std::vector columnStarts; + + buildAccelSparseMatrix(a, A, columnStarts); + + doAnalysis(A); + + m_isInitialized = true; +} + +/** Performs a numeric decomposition of matrix \a a. + * + * The given matrix must have the same sparsity pattern as the matrix on which the symbolic decomposition has been + * performed. + * + * \sa analyzePattern() + */ +template +void AccelerateImpl::factorize(const MatrixType& a) { + eigen_assert(m_symbolicFactorization && "You must first call analyzePattern()"); + eigen_assert(m_nRows == a.rows() && m_nCols == a.cols()); + + if (EnforceSquare_) eigen_assert(a.rows() == a.cols()); + + AccelSparseMatrix A{}; + std::vector columnStarts; + + buildAccelSparseMatrix(a, A, columnStarts); + + doFactorization(A); +} + +template +template +void AccelerateImpl::_solve_impl(const MatrixBase& b, + MatrixBase& x) const { + if (!m_numericFactorization) { + m_info = InvalidInput; + return; + } + + eigen_assert(m_nRows == b.rows()); + eigen_assert(((b.cols() == 1) || b.outerStride() == b.rows())); + + SparseStatus_t status = SparseStatusOK; + + Scalar* b_ptr = const_cast(b.derived().data()); + Scalar* x_ptr = const_cast(x.derived().data()); + + AccelDenseMatrix xmat{}; + xmat.attributes = SparseAttributes_t(); + xmat.columnCount = static_cast(x.cols()); + xmat.rowCount = static_cast(x.rows()); + xmat.columnStride = xmat.rowCount; + xmat.data = x_ptr; + + AccelDenseMatrix bmat{}; + bmat.attributes = SparseAttributes_t(); + bmat.columnCount = static_cast(b.cols()); + bmat.rowCount = static_cast(b.rows()); + bmat.columnStride = bmat.rowCount; + bmat.data = b_ptr; + + SparseSolve(*m_numericFactorization, bmat, xmat); + + updateInfoStatus(status); +} + +} // end namespace Eigen + +#endif // EIGEN_ACCELERATESUPPORT_H diff --git a/src/3rdparty/eigen/Eigen/src/AccelerateSupport/InternalHeaderCheck.h b/src/3rdparty/eigen/Eigen/src/AccelerateSupport/InternalHeaderCheck.h new file mode 100644 index 0000000..69bcff5 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/AccelerateSupport/InternalHeaderCheck.h @@ -0,0 +1,3 @@ +#ifndef EIGEN_ACCELERATESUPPORT_MODULE_H +#error "Please include Eigen/AccelerateSupport instead of including headers inside the src directory directly." +#endif diff --git a/src/3rdparty/eigen/Eigen/src/Cholesky/InternalHeaderCheck.h b/src/3rdparty/eigen/Eigen/src/Cholesky/InternalHeaderCheck.h new file mode 100644 index 0000000..5de2b21 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Cholesky/InternalHeaderCheck.h @@ -0,0 +1,3 @@ +#ifndef EIGEN_CHOLESKY_MODULE_H +#error "Please include Eigen/Cholesky instead of including headers inside the src directory directly." +#endif diff --git a/src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h b/src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h new file mode 100644 index 0000000..b1d801d --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h @@ -0,0 +1,649 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2011 Gael Guennebaud +// Copyright (C) 2009 Keir Mierle +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2011 Timothy E. Holy +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LDLT_H +#define EIGEN_LDLT_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > : traits { + typedef MatrixXpr XprKind; + typedef SolverStorage StorageKind; + typedef int StorageIndex; + enum { Flags = 0 }; +}; + +template +struct LDLT_Traits; + +// PositiveSemiDef means positive semi-definite and non-zero; same for NegativeSemiDef +enum SignMatrix { PositiveSemiDef, NegativeSemiDef, ZeroSign, Indefinite }; +} // namespace internal + +/** \ingroup Cholesky_Module + * + * \class LDLT + * + * \brief Robust Cholesky decomposition of a matrix with pivoting + * + * \tparam MatrixType_ the type of the matrix of which to compute the LDL^T Cholesky decomposition + * \tparam UpLo_ the triangular part that will be used for the decomposition: Lower (default) or Upper. + * The other triangular part won't be read. + * + * Perform a robust Cholesky decomposition of a positive semidefinite or negative semidefinite + * matrix \f$ A \f$ such that \f$ A = P^TLDL^*P \f$, where P is a permutation matrix, L + * is lower triangular with a unit diagonal and D is a diagonal matrix. + * + * The decomposition uses pivoting to ensure stability, so that D will have + * zeros in the bottom right rank(A) - n submatrix. Avoiding the square root + * on D also stabilizes the computation. + * + * Remember that Cholesky decompositions are not rank-revealing. Also, do not use a Cholesky + * decomposition to determine whether a system of equations has a solution. + * + * This class supports the \link InplaceDecomposition inplace decomposition \endlink mechanism. + * + * \sa MatrixBase::ldlt(), SelfAdjointView::ldlt(), class LLT + */ +template +class LDLT : public SolverBase > { + public: + typedef MatrixType_ MatrixType; + typedef SolverBase Base; + friend class SolverBase; + + EIGEN_GENERIC_PUBLIC_INTERFACE(LDLT) + enum { + MaxRowsAtCompileTime = MatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime, + UpLo = UpLo_ + }; + typedef Matrix TmpMatrixType; + + typedef Transpositions TranspositionType; + typedef PermutationMatrix PermutationType; + + typedef internal::LDLT_Traits Traits; + + /** \brief Default Constructor. + * + * The default constructor is useful in cases in which the user intends to + * perform decompositions via LDLT::compute(const MatrixType&). + */ + LDLT() : m_matrix(), m_transpositions(), m_sign(internal::ZeroSign), m_isInitialized(false) {} + + /** \brief Default Constructor with memory preallocation + * + * Like the default constructor but with preallocation of the internal data + * according to the specified problem \a size. + * \sa LDLT() + */ + explicit LDLT(Index size) + : m_matrix(size, size), + m_transpositions(size), + m_temporary(size), + m_sign(internal::ZeroSign), + m_isInitialized(false) {} + + /** \brief Constructor with decomposition + * + * This calculates the decomposition for the input \a matrix. + * + * \sa LDLT(Index size) + */ + template + explicit LDLT(const EigenBase& matrix) + : m_matrix(matrix.rows(), matrix.cols()), + m_transpositions(matrix.rows()), + m_temporary(matrix.rows()), + m_sign(internal::ZeroSign), + m_isInitialized(false) { + compute(matrix.derived()); + } + + /** \brief Constructs a LDLT factorization from a given matrix + * + * This overloaded constructor is provided for \link InplaceDecomposition inplace decomposition \endlink when \c + * MatrixType is a Eigen::Ref. + * + * \sa LDLT(const EigenBase&) + */ + template + explicit LDLT(EigenBase& matrix) + : m_matrix(matrix.derived()), + m_transpositions(matrix.rows()), + m_temporary(matrix.rows()), + m_sign(internal::ZeroSign), + m_isInitialized(false) { + compute(matrix.derived()); + } + + /** Clear any existing decomposition + * \sa rankUpdate(w,sigma) + */ + void setZero() { m_isInitialized = false; } + + /** \returns a view of the upper triangular matrix U */ + inline typename Traits::MatrixU matrixU() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return Traits::getU(m_matrix); + } + + /** \returns a view of the lower triangular matrix L */ + inline typename Traits::MatrixL matrixL() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return Traits::getL(m_matrix); + } + + /** \returns the permutation matrix P as a transposition sequence. + */ + inline const TranspositionType& transpositionsP() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_transpositions; + } + + /** \returns the coefficients of the diagonal matrix D */ + inline Diagonal vectorD() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_matrix.diagonal(); + } + + /** \returns true if the matrix is positive (semidefinite) */ + inline bool isPositive() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_sign == internal::PositiveSemiDef || m_sign == internal::ZeroSign; + } + + /** \returns true if the matrix is negative (semidefinite) */ + inline bool isNegative(void) const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_sign == internal::NegativeSemiDef || m_sign == internal::ZeroSign; + } + +#ifdef EIGEN_PARSED_BY_DOXYGEN + /** \returns a solution x of \f$ A x = b \f$ using the current decomposition of A. + * + * This function also supports in-place solves using the syntax x = decompositionObject.solve(x) . + * + * \note_about_checking_solutions + * + * More precisely, this method solves \f$ A x = b \f$ using the decomposition \f$ A = P^T L D L^* P \f$ + * by solving the systems \f$ P^T y_1 = b \f$, \f$ L y_2 = y_1 \f$, \f$ D y_3 = y_2 \f$, + * \f$ L^* y_4 = y_3 \f$ and \f$ P x = y_4 \f$ in succession. If the matrix \f$ A \f$ is singular, then + * \f$ D \f$ will also be singular (all the other matrices are invertible). In that case, the + * least-square solution of \f$ D y_3 = y_2 \f$ is computed. This does not mean that this function + * computes the least-square solution of \f$ A x = b \f$ if \f$ A \f$ is singular. + * + * \sa MatrixBase::ldlt(), SelfAdjointView::ldlt() + */ + template + inline const Solve solve(const MatrixBase& b) const; +#endif + + template + bool solveInPlace(MatrixBase& bAndX) const; + + template + LDLT& compute(const EigenBase& matrix); + + /** \returns an estimate of the reciprocal condition number of the matrix of + * which \c *this is the LDLT decomposition. + */ + RealScalar rcond() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return internal::rcond_estimate_helper(m_l1_norm, *this); + } + + template + LDLT& rankUpdate(const MatrixBase& w, const RealScalar& alpha = 1); + + /** \returns the internal LDLT decomposition matrix + * + * TODO: document the storage layout + */ + inline const MatrixType& matrixLDLT() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_matrix; + } + + MatrixType reconstructedMatrix() const; + + /** \returns the adjoint of \c *this, that is, a const reference to the decomposition itself as the underlying matrix + * is self-adjoint. + * + * This method is provided for compatibility with other matrix decompositions, thus enabling generic code such as: + * \code x = decomposition.adjoint().solve(b) \endcode + */ + const LDLT& adjoint() const { return *this; } + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_matrix.cols(); } + + /** \brief Reports whether previous computation was successful. + * + * \returns \c Success if computation was successful, + * \c NumericalIssue if the factorization failed because of a zero pivot. + */ + ComputationInfo info() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_info; + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + void _solve_impl(const RhsType& rhs, DstType& dst) const; + + template + void _solve_impl_transposed(const RhsType& rhs, DstType& dst) const; +#endif + + protected: + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + + /** \internal + * Used to compute and store the Cholesky decomposition A = L D L^* = U^* D U. + * The strict upper part is used during the decomposition, the strict lower + * part correspond to the coefficients of L (its diagonal is equal to 1 and + * is not stored), and the diagonal entries correspond to D. + */ + MatrixType m_matrix; + RealScalar m_l1_norm; + TranspositionType m_transpositions; + TmpMatrixType m_temporary; + internal::SignMatrix m_sign; + bool m_isInitialized; + ComputationInfo m_info; +}; + +namespace internal { + +template +struct ldlt_inplace; + +template <> +struct ldlt_inplace { + template + static bool unblocked(MatrixType& mat, TranspositionType& transpositions, Workspace& temp, SignMatrix& sign) { + using std::abs; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename TranspositionType::StorageIndex IndexType; + eigen_assert(mat.rows() == mat.cols()); + const Index size = mat.rows(); + bool found_zero_pivot = false; + bool ret = true; + + if (size <= 1) { + transpositions.setIdentity(); + if (size == 0) + sign = ZeroSign; + else if (numext::real(mat.coeff(0, 0)) > static_cast(0)) + sign = PositiveSemiDef; + else if (numext::real(mat.coeff(0, 0)) < static_cast(0)) + sign = NegativeSemiDef; + else + sign = ZeroSign; + return true; + } + + for (Index k = 0; k < size; ++k) { + // Find largest diagonal element + Index index_of_biggest_in_corner; + mat.diagonal().tail(size - k).cwiseAbs().maxCoeff(&index_of_biggest_in_corner); + index_of_biggest_in_corner += k; + + transpositions.coeffRef(k) = IndexType(index_of_biggest_in_corner); + if (k != index_of_biggest_in_corner) { + // apply the transposition while taking care to consider only + // the lower triangular part + Index s = size - index_of_biggest_in_corner - 1; // trailing size after the biggest element + mat.row(k).head(k).swap(mat.row(index_of_biggest_in_corner).head(k)); + mat.col(k).tail(s).swap(mat.col(index_of_biggest_in_corner).tail(s)); + std::swap(mat.coeffRef(k, k), mat.coeffRef(index_of_biggest_in_corner, index_of_biggest_in_corner)); + for (Index i = k + 1; i < index_of_biggest_in_corner; ++i) { + Scalar tmp = mat.coeffRef(i, k); + mat.coeffRef(i, k) = numext::conj(mat.coeffRef(index_of_biggest_in_corner, i)); + mat.coeffRef(index_of_biggest_in_corner, i) = numext::conj(tmp); + } + if (NumTraits::IsComplex) + mat.coeffRef(index_of_biggest_in_corner, k) = numext::conj(mat.coeff(index_of_biggest_in_corner, k)); + } + + // partition the matrix: + // A00 | - | - + // lu = A10 | A11 | - + // A20 | A21 | A22 + Index rs = size - k - 1; + Block A21(mat, k + 1, k, rs, 1); + Block A10(mat, k, 0, 1, k); + Block A20(mat, k + 1, 0, rs, k); + + if (k > 0) { + temp.head(k) = mat.diagonal().real().head(k).asDiagonal() * A10.adjoint(); + mat.coeffRef(k, k) -= (A10 * temp.head(k)).value(); + if (rs > 0) A21.noalias() -= A20 * temp.head(k); + } + + // In some previous versions of Eigen (e.g., 3.2.1), the scaling was omitted if the pivot + // was smaller than the cutoff value. However, since LDLT is not rank-revealing + // we should only make sure that we do not introduce INF or NaN values. + // Remark that LAPACK also uses 0 as the cutoff value. + RealScalar realAkk = numext::real(mat.coeffRef(k, k)); + bool pivot_is_valid = (abs(realAkk) > RealScalar(0)); + + if (k == 0 && !pivot_is_valid) { + // The entire diagonal is zero, there is nothing more to do + // except filling the transpositions, and checking whether the matrix is zero. + sign = ZeroSign; + for (Index j = 0; j < size; ++j) { + transpositions.coeffRef(j) = IndexType(j); + ret = ret && (mat.col(j).tail(size - j - 1).array() == Scalar(0)).all(); + } + return ret; + } + + if ((rs > 0) && pivot_is_valid) + A21 /= realAkk; + else if (rs > 0) + ret = ret && (A21.array() == Scalar(0)).all(); + + if (found_zero_pivot && pivot_is_valid) + ret = false; // factorization failed + else if (!pivot_is_valid) + found_zero_pivot = true; + + if (sign == PositiveSemiDef) { + if (realAkk < static_cast(0)) sign = Indefinite; + } else if (sign == NegativeSemiDef) { + if (realAkk > static_cast(0)) sign = Indefinite; + } else if (sign == ZeroSign) { + if (realAkk > static_cast(0)) + sign = PositiveSemiDef; + else if (realAkk < static_cast(0)) + sign = NegativeSemiDef; + } + } + + return ret; + } + + // Reference for the algorithm: Davis and Hager, "Multiple Rank + // Modifications of a Sparse Cholesky Factorization" (Algorithm 1) + // Trivial rearrangements of their computations (Timothy E. Holy) + // allow their algorithm to work for rank-1 updates even if the + // original matrix is not of full rank. + // Here only rank-1 updates are implemented, to reduce the + // requirement for intermediate storage and improve accuracy + template + static bool updateInPlace(MatrixType& mat, MatrixBase& w, + const typename MatrixType::RealScalar& sigma = 1) { + using numext::isfinite; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + + const Index size = mat.rows(); + eigen_assert(mat.cols() == size && w.size() == size); + + RealScalar alpha = 1; + + // Apply the update + for (Index j = 0; j < size; j++) { + // Check for termination due to an original decomposition of low-rank + if (!(isfinite)(alpha)) break; + + // Update the diagonal terms + RealScalar dj = numext::real(mat.coeff(j, j)); + Scalar wj = w.coeff(j); + RealScalar swj2 = sigma * numext::abs2(wj); + RealScalar gamma = dj * alpha + swj2; + + mat.coeffRef(j, j) += swj2 / alpha; + alpha += swj2 / dj; + + // Update the terms of L + Index rs = size - j - 1; + w.tail(rs) -= wj * mat.col(j).tail(rs); + if (!numext::is_exactly_zero(gamma)) mat.col(j).tail(rs) += (sigma * numext::conj(wj) / gamma) * w.tail(rs); + } + return true; + } + + template + static bool update(MatrixType& mat, const TranspositionType& transpositions, Workspace& tmp, const WType& w, + const typename MatrixType::RealScalar& sigma = 1) { + // Apply the permutation to the input w + tmp = transpositions * w; + + return ldlt_inplace::updateInPlace(mat, tmp, sigma); + } +}; + +template <> +struct ldlt_inplace { + template + static EIGEN_STRONG_INLINE bool unblocked(MatrixType& mat, TranspositionType& transpositions, Workspace& temp, + SignMatrix& sign) { + Transpose matt(mat); + return ldlt_inplace::unblocked(matt, transpositions, temp, sign); + } + + template + static EIGEN_STRONG_INLINE bool update(MatrixType& mat, TranspositionType& transpositions, Workspace& tmp, WType& w, + const typename MatrixType::RealScalar& sigma = 1) { + Transpose matt(mat); + return ldlt_inplace::update(matt, transpositions, tmp, w.conjugate(), sigma); + } +}; + +template +struct LDLT_Traits { + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m.adjoint()); } +}; + +template +struct LDLT_Traits { + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m.adjoint()); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m); } +}; + +} // end namespace internal + +/** Compute / recompute the LDLT decomposition A = L D L^* = U^* D U of \a matrix + */ +template +template +LDLT& LDLT::compute(const EigenBase& a) { + eigen_assert(a.rows() == a.cols()); + const Index size = a.rows(); + + m_matrix = a.derived(); + + // Compute matrix L1 norm = max abs column sum. + m_l1_norm = RealScalar(0); + // TODO move this code to SelfAdjointView + for (Index col = 0; col < size; ++col) { + RealScalar abs_col_sum; + if (UpLo_ == Lower) + abs_col_sum = + m_matrix.col(col).tail(size - col).template lpNorm<1>() + m_matrix.row(col).head(col).template lpNorm<1>(); + else + abs_col_sum = + m_matrix.col(col).head(col).template lpNorm<1>() + m_matrix.row(col).tail(size - col).template lpNorm<1>(); + if (abs_col_sum > m_l1_norm) m_l1_norm = abs_col_sum; + } + + m_transpositions.resize(size); + m_isInitialized = false; + m_temporary.resize(size); + m_sign = internal::ZeroSign; + + m_info = internal::ldlt_inplace::unblocked(m_matrix, m_transpositions, m_temporary, m_sign) ? Success + : NumericalIssue; + + m_isInitialized = true; + return *this; +} + +/** Update the LDLT decomposition: given A = L D L^T, efficiently compute the decomposition of A + sigma w w^T. + * \param w a vector to be incorporated into the decomposition. + * \param sigma a scalar, +1 for updates and -1 for "downdates," which correspond to removing previously-added column + * vectors. Optional; default value is +1. \sa setZero() + */ +template +template +LDLT& LDLT::rankUpdate( + const MatrixBase& w, const typename LDLT::RealScalar& sigma) { + typedef typename TranspositionType::StorageIndex IndexType; + const Index size = w.rows(); + if (m_isInitialized) { + eigen_assert(m_matrix.rows() == size); + } else { + m_matrix.resize(size, size); + m_matrix.setZero(); + m_transpositions.resize(size); + for (Index i = 0; i < size; i++) m_transpositions.coeffRef(i) = IndexType(i); + m_temporary.resize(size); + m_sign = sigma >= 0 ? internal::PositiveSemiDef : internal::NegativeSemiDef; + m_isInitialized = true; + } + + internal::ldlt_inplace::update(m_matrix, m_transpositions, m_temporary, w, sigma); + + return *this; +} + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +template +void LDLT::_solve_impl(const RhsType& rhs, DstType& dst) const { + _solve_impl_transposed(rhs, dst); +} + +template +template +void LDLT::_solve_impl_transposed(const RhsType& rhs, DstType& dst) const { + // dst = P b + dst = m_transpositions * rhs; + + // dst = L^-1 (P b) + // dst = L^-*T (P b) + matrixL().template conjugateIf().solveInPlace(dst); + + // dst = D^-* (L^-1 P b) + // dst = D^-1 (L^-*T P b) + // more precisely, use pseudo-inverse of D (see bug 241) + using std::abs; + const typename Diagonal::RealReturnType vecD(vectorD()); + // In some previous versions, tolerance was set to the max of 1/highest (or rather numeric_limits::min()) + // and the maximal diagonal entry * epsilon as motivated by LAPACK's xGELSS: + // RealScalar tolerance = numext::maxi(vecD.array().abs().maxCoeff() * NumTraits::epsilon(),RealScalar(1) + // / NumTraits::highest()); However, LDLT is not rank revealing, and so adjusting the tolerance wrt to the + // highest diagonal element is not well justified and leads to numerical issues in some cases. Moreover, Lapack's + // xSYTRS routines use 0 for the tolerance. Using numeric_limits::min() gives us more robustness to denormals. + RealScalar tolerance = (std::numeric_limits::min)(); + for (Index i = 0; i < vecD.size(); ++i) { + if (abs(vecD(i)) > tolerance) + dst.row(i) /= vecD(i); + else + dst.row(i).setZero(); + } + + // dst = L^-* (D^-* L^-1 P b) + // dst = L^-T (D^-1 L^-*T P b) + matrixL().transpose().template conjugateIf().solveInPlace(dst); + + // dst = P^T (L^-* D^-* L^-1 P b) = A^-1 b + // dst = P^-T (L^-T D^-1 L^-*T P b) = A^-1 b + dst = m_transpositions.transpose() * dst; +} +#endif + +/** \internal use x = ldlt_object.solve(x); + * + * This is the \em in-place version of solve(). + * + * \param bAndX represents both the right-hand side matrix b and result x. + * + * \returns true always! If you need to check for existence of solutions, use another decomposition like LU, QR, or SVD. + * + * This version avoids a copy when the right hand side matrix b is not + * needed anymore. + * + * \sa LDLT::solve(), MatrixBase::ldlt() + */ +template +template +bool LDLT::solveInPlace(MatrixBase& bAndX) const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + eigen_assert(m_matrix.rows() == bAndX.rows()); + + bAndX = this->solve(bAndX); + + return true; +} + +/** \returns the matrix represented by the decomposition, + * i.e., it returns the product: P^T L D L^* P. + * This function is provided for debug purpose. */ +template +MatrixType LDLT::reconstructedMatrix() const { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + const Index size = m_matrix.rows(); + MatrixType res(size, size); + + // P + res.setIdentity(); + res = transpositionsP() * res; + // L^* P + res = matrixU() * res; + // D(L^*P) + res = vectorD().real().asDiagonal() * res; + // L(DL^*P) + res = matrixL() * res; + // P^T (LDL^*P) + res = transpositionsP().transpose() * res; + + return res; +} + +/** \cholesky_module + * \returns the Cholesky decomposition with full pivoting without square root of \c *this + * \sa MatrixBase::ldlt() + */ +template +inline const LDLT::PlainObject, UpLo> +SelfAdjointView::ldlt() const { + return LDLT(m_matrix); +} + +/** \cholesky_module + * \returns the Cholesky decomposition with full pivoting without square root of \c *this + * \sa SelfAdjointView::ldlt() + */ +template +inline const LDLT::PlainObject> MatrixBase::ldlt() const { + return LDLT(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_LDLT_H diff --git a/src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h b/src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h new file mode 100644 index 0000000..7fa4fa2 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h @@ -0,0 +1,514 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LLT_H +#define EIGEN_LLT_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct traits > : traits { + typedef MatrixXpr XprKind; + typedef SolverStorage StorageKind; + typedef int StorageIndex; + enum { Flags = 0 }; +}; + +template +struct LLT_Traits; +} // namespace internal + +/** \ingroup Cholesky_Module + * + * \class LLT + * + * \brief Standard Cholesky decomposition (LL^T) of a matrix and associated features + * + * \tparam MatrixType_ the type of the matrix of which we are computing the LL^T Cholesky decomposition + * \tparam UpLo_ the triangular part that will be used for the decomposition: Lower (default) or Upper. + * The other triangular part won't be read. + * + * This class performs a LL^T Cholesky decomposition of a symmetric, positive definite + * matrix A such that A = LL^* = U^*U, where L is lower triangular. + * + * While the Cholesky decomposition is particularly useful to solve selfadjoint problems like D^*D x = b, + * for that purpose, we recommend the Cholesky decomposition without square root which is more stable + * and even faster. Nevertheless, this standard Cholesky decomposition remains useful in many other + * situations like generalised eigen problems with hermitian matrices. + * + * Remember that Cholesky decompositions are not rank-revealing. This LLT decomposition is only stable on positive + * definite matrices, use LDLT instead for the semidefinite case. Also, do not use a Cholesky decomposition to determine + * whether a system of equations has a solution. + * + * Example: \include LLT_example.cpp + * Output: \verbinclude LLT_example.out + * + * \b Performance: for best performance, it is recommended to use a column-major storage format + * with the Lower triangular part (the default), or, equivalently, a row-major storage format + * with the Upper triangular part. Otherwise, you might get a 20% slowdown for the full factorization + * step, and rank-updates can be up to 3 times slower. + * + * This class supports the \link InplaceDecomposition inplace decomposition \endlink mechanism. + * + * Note that during the decomposition, only the lower (or upper, as defined by UpLo_) triangular part of A is + * considered. Therefore, the strict lower part does not have to store correct values. + * + * \sa MatrixBase::llt(), SelfAdjointView::llt(), class LDLT + */ +template +class LLT : public SolverBase > { + public: + typedef MatrixType_ MatrixType; + typedef SolverBase Base; + friend class SolverBase; + + EIGEN_GENERIC_PUBLIC_INTERFACE(LLT) + enum { MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime }; + + enum { PacketSize = internal::packet_traits::size, AlignmentMask = int(PacketSize) - 1, UpLo = UpLo_ }; + + typedef internal::LLT_Traits Traits; + + /** + * \brief Default Constructor. + * + * The default constructor is useful in cases in which the user intends to + * perform decompositions via LLT::compute(const MatrixType&). + */ + LLT() : m_matrix(), m_isInitialized(false) {} + + /** \brief Default Constructor with memory preallocation + * + * Like the default constructor but with preallocation of the internal data + * according to the specified problem \a size. + * \sa LLT() + */ + explicit LLT(Index size) : m_matrix(size, size), m_isInitialized(false) {} + + template + explicit LLT(const EigenBase& matrix) : m_matrix(matrix.rows(), matrix.cols()), m_isInitialized(false) { + compute(matrix.derived()); + } + + /** \brief Constructs a LLT factorization from a given matrix + * + * This overloaded constructor is provided for \link InplaceDecomposition inplace decomposition \endlink when + * \c MatrixType is a Eigen::Ref. + * + * \sa LLT(const EigenBase&) + */ + template + explicit LLT(EigenBase& matrix) : m_matrix(matrix.derived()), m_isInitialized(false) { + compute(matrix.derived()); + } + + /** \returns a view of the upper triangular matrix U */ + inline typename Traits::MatrixU matrixU() const { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return Traits::getU(m_matrix); + } + + /** \returns a view of the lower triangular matrix L */ + inline typename Traits::MatrixL matrixL() const { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return Traits::getL(m_matrix); + } + +#ifdef EIGEN_PARSED_BY_DOXYGEN + /** \returns the solution x of \f$ A x = b \f$ using the current decomposition of A. + * + * Since this LLT class assumes anyway that the matrix A is invertible, the solution + * theoretically exists and is unique regardless of b. + * + * Example: \include LLT_solve.cpp + * Output: \verbinclude LLT_solve.out + * + * \sa solveInPlace(), MatrixBase::llt(), SelfAdjointView::llt() + */ + template + inline const Solve solve(const MatrixBase& b) const; +#endif + + template + void solveInPlace(const MatrixBase& bAndX) const; + + template + LLT& compute(const EigenBase& matrix); + + /** \returns an estimate of the reciprocal condition number of the matrix of + * which \c *this is the Cholesky decomposition. + */ + RealScalar rcond() const { + eigen_assert(m_isInitialized && "LLT is not initialized."); + eigen_assert(m_info == Success && "LLT failed because matrix appears to be negative"); + return internal::rcond_estimate_helper(m_l1_norm, *this); + } + + /** \returns the LLT decomposition matrix + * + * TODO: document the storage layout + */ + inline const MatrixType& matrixLLT() const { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return m_matrix; + } + + MatrixType reconstructedMatrix() const; + + /** \brief Reports whether previous computation was successful. + * + * \returns \c Success if computation was successful, + * \c NumericalIssue if the matrix.appears not to be positive definite. + */ + ComputationInfo info() const { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return m_info; + } + + /** \returns the adjoint of \c *this, that is, a const reference to the decomposition itself as the underlying matrix + * is self-adjoint. + * + * This method is provided for compatibility with other matrix decompositions, thus enabling generic code such as: + * \code x = decomposition.adjoint().solve(b) \endcode + */ + const LLT& adjoint() const noexcept { return *this; } + + constexpr Index rows() const noexcept { return m_matrix.rows(); } + constexpr Index cols() const noexcept { return m_matrix.cols(); } + + template + LLT& rankUpdate(const VectorType& vec, const RealScalar& sigma = 1); + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + void _solve_impl(const RhsType& rhs, DstType& dst) const; + + template + void _solve_impl_transposed(const RhsType& rhs, DstType& dst) const; +#endif + + protected: + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + + /** \internal + * Used to compute and store L + * The strict upper part is not used and even not initialized. + */ + MatrixType m_matrix; + RealScalar m_l1_norm; + bool m_isInitialized; + ComputationInfo m_info; +}; + +namespace internal { + +template +struct llt_inplace; + +template +static Index llt_rank_update_lower(MatrixType& mat, const VectorType& vec, + const typename MatrixType::RealScalar& sigma) { + using std::sqrt; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename MatrixType::ColXpr ColXpr; + typedef internal::remove_all_t ColXprCleaned; + typedef typename ColXprCleaned::SegmentReturnType ColXprSegment; + typedef Matrix TempVectorType; + typedef typename TempVectorType::SegmentReturnType TempVecSegment; + + Index n = mat.cols(); + eigen_assert(mat.rows() == n && vec.size() == n); + + TempVectorType temp; + + if (sigma > 0) { + // This version is based on Givens rotations. + // It is faster than the other one below, but only works for updates, + // i.e., for sigma > 0 + temp = sqrt(sigma) * vec; + + for (Index i = 0; i < n; ++i) { + JacobiRotation g; + g.makeGivens(mat(i, i), -temp(i), &mat(i, i)); + + Index rs = n - i - 1; + if (rs > 0) { + ColXprSegment x(mat.col(i).tail(rs)); + TempVecSegment y(temp.tail(rs)); + apply_rotation_in_the_plane(x, y, g); + } + } + } else { + temp = vec; + RealScalar beta = 1; + for (Index j = 0; j < n; ++j) { + RealScalar Ljj = numext::real(mat.coeff(j, j)); + RealScalar dj = numext::abs2(Ljj); + Scalar wj = temp.coeff(j); + RealScalar swj2 = sigma * numext::abs2(wj); + RealScalar gamma = dj * beta + swj2; + + RealScalar x = dj + swj2 / beta; + if (x <= RealScalar(0)) return j; + RealScalar nLjj = sqrt(x); + mat.coeffRef(j, j) = nLjj; + beta += swj2 / dj; + + // Update the terms of L + Index rs = n - j - 1; + if (rs) { + temp.tail(rs) -= (wj / Ljj) * mat.col(j).tail(rs); + if (!numext::is_exactly_zero(gamma)) + mat.col(j).tail(rs) = + (nLjj / Ljj) * mat.col(j).tail(rs) + (nLjj * sigma * numext::conj(wj) / gamma) * temp.tail(rs); + } + } + } + return -1; +} + +template +struct llt_inplace { + typedef typename NumTraits::Real RealScalar; + template + static Index unblocked(MatrixType& mat) { + using std::sqrt; + + eigen_assert(mat.rows() == mat.cols()); + const Index size = mat.rows(); + for (Index k = 0; k < size; ++k) { + Index rs = size - k - 1; // remaining size + + Block A21(mat, k + 1, k, rs, 1); + Block A10(mat, k, 0, 1, k); + Block A20(mat, k + 1, 0, rs, k); + + RealScalar x = numext::real(mat.coeff(k, k)); + if (k > 0) x -= A10.squaredNorm(); + if (x <= RealScalar(0)) return k; + mat.coeffRef(k, k) = x = sqrt(x); + if (k > 0 && rs > 0) A21.noalias() -= A20 * A10.adjoint(); + if (rs > 0) A21 /= x; + } + return -1; + } + + template + static Index blocked(MatrixType& m) { + eigen_assert(m.rows() == m.cols()); + Index size = m.rows(); + if (size < 32) return unblocked(m); + + Index blockSize = size / 8; + blockSize = (blockSize / 16) * 16; + blockSize = (std::min)((std::max)(blockSize, Index(8)), Index(128)); + + for (Index k = 0; k < size; k += blockSize) { + // partition the matrix: + // A00 | - | - + // lu = A10 | A11 | - + // A20 | A21 | A22 + Index bs = (std::min)(blockSize, size - k); + Index rs = size - k - bs; + Block A11(m, k, k, bs, bs); + Block A21(m, k + bs, k, rs, bs); + Block A22(m, k + bs, k + bs, rs, rs); + + Index ret; + if ((ret = unblocked(A11)) >= 0) return k + ret; + if (rs > 0) A11.adjoint().template triangularView().template solveInPlace(A21); + if (rs > 0) + A22.template selfadjointView().rankUpdate(A21, + typename NumTraits::Literal(-1)); // bottleneck + } + return -1; + } + + template + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const RealScalar& sigma) { + return Eigen::internal::llt_rank_update_lower(mat, vec, sigma); + } +}; + +template +struct llt_inplace { + typedef typename NumTraits::Real RealScalar; + + template + static EIGEN_STRONG_INLINE Index unblocked(MatrixType& mat) { + Transpose matt(mat); + return llt_inplace::unblocked(matt); + } + template + static EIGEN_STRONG_INLINE Index blocked(MatrixType& mat) { + Transpose matt(mat); + return llt_inplace::blocked(matt); + } + template + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const RealScalar& sigma) { + Transpose matt(mat); + return llt_inplace::rankUpdate(matt, vec.conjugate(), sigma); + } +}; + +template +struct LLT_Traits { + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m.adjoint()); } + static bool inplace_decomposition(MatrixType& m) { + return llt_inplace::blocked(m) == -1; + } +}; + +template +struct LLT_Traits { + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m.adjoint()); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m); } + static bool inplace_decomposition(MatrixType& m) { + return llt_inplace::blocked(m) == -1; + } +}; + +} // end namespace internal + +/** Computes / recomputes the Cholesky decomposition A = LL^* = U^*U of \a matrix + * + * \returns a reference to *this + * + * Example: \include TutorialLinAlgComputeTwice.cpp + * Output: \verbinclude TutorialLinAlgComputeTwice.out + */ +template +template +LLT& LLT::compute(const EigenBase& a) { + eigen_assert(a.rows() == a.cols()); + const Index size = a.rows(); + m_matrix.resize(size, size); + if (!internal::is_same_dense(m_matrix, a.derived())) m_matrix = a.derived(); + + // Compute matrix L1 norm = max abs column sum. + m_l1_norm = RealScalar(0); + // TODO move this code to SelfAdjointView + for (Index col = 0; col < size; ++col) { + RealScalar abs_col_sum; + if (UpLo_ == Lower) + abs_col_sum = + m_matrix.col(col).tail(size - col).template lpNorm<1>() + m_matrix.row(col).head(col).template lpNorm<1>(); + else + abs_col_sum = + m_matrix.col(col).head(col).template lpNorm<1>() + m_matrix.row(col).tail(size - col).template lpNorm<1>(); + if (abs_col_sum > m_l1_norm) m_l1_norm = abs_col_sum; + } + + m_isInitialized = true; + bool ok = Traits::inplace_decomposition(m_matrix); + m_info = ok ? Success : NumericalIssue; + + return *this; +} + +/** Performs a rank one update (or dowdate) of the current decomposition. + * If A = LL^* before the rank one update, + * then after it we have LL^* = A + sigma * v v^* where \a v must be a vector + * of same dimension. + */ +template +template +LLT& LLT::rankUpdate(const VectorType& v, const RealScalar& sigma) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(VectorType); + eigen_assert(v.size() == m_matrix.cols()); + eigen_assert(m_isInitialized); + if (internal::llt_inplace::rankUpdate(m_matrix, v, sigma) >= 0) + m_info = NumericalIssue; + else + m_info = Success; + + return *this; +} + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +template +void LLT::_solve_impl(const RhsType& rhs, DstType& dst) const { + _solve_impl_transposed(rhs, dst); +} + +template +template +void LLT::_solve_impl_transposed(const RhsType& rhs, DstType& dst) const { + dst = rhs; + + matrixL().template conjugateIf().solveInPlace(dst); + matrixU().template conjugateIf().solveInPlace(dst); +} +#endif + +/** \internal use x = llt_object.solve(x); + * + * This is the \em in-place version of solve(). + * + * \param bAndX represents both the right-hand side matrix b and result x. + * + * This version avoids a copy when the right hand side matrix b is not needed anymore. + * + * \warning The parameter is only marked 'const' to make the C++ compiler accept a temporary expression here. + * This function will const_cast it, so constness isn't honored here. + * + * \sa LLT::solve(), MatrixBase::llt() + */ +template +template +void LLT::solveInPlace(const MatrixBase& bAndX) const { + eigen_assert(m_isInitialized && "LLT is not initialized."); + eigen_assert(m_matrix.rows() == bAndX.rows()); + matrixL().solveInPlace(bAndX); + matrixU().solveInPlace(bAndX); +} + +/** \returns the matrix represented by the decomposition, + * i.e., it returns the product: L L^*. + * This function is provided for debug purpose. */ +template +MatrixType LLT::reconstructedMatrix() const { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return matrixL() * matrixL().adjoint().toDenseMatrix(); +} + +/** \cholesky_module + * \returns the LLT decomposition of \c *this + * \sa SelfAdjointView::llt() + */ +template +inline const LLT::PlainObject> MatrixBase::llt() const { + return LLT(derived()); +} + +/** \cholesky_module + * \returns the LLT decomposition of \c *this + * \sa SelfAdjointView::llt() + */ +template +inline const LLT::PlainObject, UpLo> SelfAdjointView::llt() + const { + return LLT(m_matrix); +} + +} // end namespace Eigen + +#endif // EIGEN_LLT_H diff --git a/src/3rdparty/eigen/Eigen/src/Cholesky/LLT_LAPACKE.h b/src/3rdparty/eigen/Eigen/src/Cholesky/LLT_LAPACKE.h new file mode 100644 index 0000000..cb55b15 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Cholesky/LLT_LAPACKE.h @@ -0,0 +1,124 @@ +/* + Copyright (c) 2011, Intel Corporation. All rights reserved. + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Intel Corporation nor the names of its contributors may + be used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + ******************************************************************************** + * Content : Eigen bindings to LAPACKe + * LLt decomposition based on LAPACKE_?potrf function. + ******************************************************************************** +*/ + +#ifndef EIGEN_LLT_LAPACKE_H +#define EIGEN_LLT_LAPACKE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +namespace lapacke_helpers { +// ------------------------------------------------------------------------------------------------------------------- +// Dispatch for rank update handling upper and lower parts +// ------------------------------------------------------------------------------------------------------------------- + +template +struct rank_update {}; + +template <> +struct rank_update { + template + static Index run(MatrixType &mat, const VectorType &vec, const typename MatrixType::RealScalar &sigma) { + return Eigen::internal::llt_rank_update_lower(mat, vec, sigma); + } +}; + +template <> +struct rank_update { + template + static Index run(MatrixType &mat, const VectorType &vec, const typename MatrixType::RealScalar &sigma) { + Transpose matt(mat); + return Eigen::internal::llt_rank_update_lower(matt, vec.conjugate(), sigma); + } +}; + +// ------------------------------------------------------------------------------------------------------------------- +// Generic lapacke llt implementation that hands of to the dispatches +// ------------------------------------------------------------------------------------------------------------------- + +template +struct lapacke_llt { + EIGEN_STATIC_ASSERT(((Mode == Lower) || (Mode == Upper)), MODE_MUST_BE_UPPER_OR_LOWER) + template + static Index blocked(MatrixType &m) { + eigen_assert(m.rows() == m.cols()); + if (m.rows() == 0) { + return -1; + } + /* Set up parameters for ?potrf */ + lapack_int size = to_lapack(m.rows()); + lapack_int matrix_order = lapack_storage_of(m); + constexpr char uplo = Mode == Upper ? 'U' : 'L'; + Scalar *a = &(m.coeffRef(0, 0)); + lapack_int lda = to_lapack(m.outerStride()); + + lapack_int info = potrf(matrix_order, uplo, size, to_lapack(a), lda); + info = (info == 0) ? -1 : info > 0 ? info - 1 : size; + return info; + } + + template + static Index rankUpdate(MatrixType &mat, const VectorType &vec, const typename MatrixType::RealScalar &sigma) { + return rank_update::run(mat, vec, sigma); + } +}; +} // namespace lapacke_helpers +// end namespace lapacke_helpers + +/* + * Here, we just put the generic implementation from lapacke_llt into a full specialization of the llt_inplace + * type. By being a full specialization, the versions defined here thus get precedence over the generic implementation + * in LLT.h for double, float and complex double, complex float types. + */ + +#define EIGEN_LAPACKE_LLT(EIGTYPE) \ + template <> \ + struct llt_inplace : public lapacke_helpers::lapacke_llt {}; \ + template <> \ + struct llt_inplace : public lapacke_helpers::lapacke_llt {}; + +EIGEN_LAPACKE_LLT(double) +EIGEN_LAPACKE_LLT(float) +EIGEN_LAPACKE_LLT(std::complex) +EIGEN_LAPACKE_LLT(std::complex) + +#undef EIGEN_LAPACKE_LLT + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_LLT_LAPACKE_H diff --git a/src/3rdparty/eigen/Eigen/src/CholmodSupport/CholmodSupport.h b/src/3rdparty/eigen/Eigen/src/CholmodSupport/CholmodSupport.h new file mode 100644 index 0000000..7e3c881 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/CholmodSupport/CholmodSupport.h @@ -0,0 +1,738 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CHOLMODSUPPORT_H +#define EIGEN_CHOLMODSUPPORT_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct cholmod_configure_matrix; + +template <> +struct cholmod_configure_matrix { + template + static void run(CholmodType& mat) { + mat.xtype = CHOLMOD_REAL; + mat.dtype = CHOLMOD_DOUBLE; + } +}; + +template <> +struct cholmod_configure_matrix > { + template + static void run(CholmodType& mat) { + mat.xtype = CHOLMOD_COMPLEX; + mat.dtype = CHOLMOD_DOUBLE; + } +}; + +// Other scalar types are not yet supported by Cholmod +// template<> struct cholmod_configure_matrix { +// template +// static void run(CholmodType& mat) { +// mat.xtype = CHOLMOD_REAL; +// mat.dtype = CHOLMOD_SINGLE; +// } +// }; +// +// template<> struct cholmod_configure_matrix > { +// template +// static void run(CholmodType& mat) { +// mat.xtype = CHOLMOD_COMPLEX; +// mat.dtype = CHOLMOD_SINGLE; +// } +// }; + +} // namespace internal + +/** Wraps the Eigen sparse matrix \a mat into a Cholmod sparse matrix object. + * Note that the data are shared. + */ +template +cholmod_sparse viewAsCholmod(Ref > mat) { + cholmod_sparse res; + res.nzmax = mat.nonZeros(); + res.nrow = mat.rows(); + res.ncol = mat.cols(); + res.p = mat.outerIndexPtr(); + res.i = mat.innerIndexPtr(); + res.x = mat.valuePtr(); + res.z = 0; + res.sorted = 1; + if (mat.isCompressed()) { + res.packed = 1; + res.nz = 0; + } else { + res.packed = 0; + res.nz = mat.innerNonZeroPtr(); + } + + res.dtype = 0; + res.stype = -1; + + if (internal::is_same::value) { + res.itype = CHOLMOD_INT; + } else if (internal::is_same::value) { + res.itype = CHOLMOD_LONG; + } else { + eigen_assert(false && "Index type not supported yet"); + } + + // setup res.xtype + internal::cholmod_configure_matrix::run(res); + + res.stype = 0; + + return res; +} + +template +const cholmod_sparse viewAsCholmod(const SparseMatrix& mat) { + cholmod_sparse res = viewAsCholmod(Ref >(mat.const_cast_derived())); + return res; +} + +template +const cholmod_sparse viewAsCholmod(const SparseVector& mat) { + cholmod_sparse res = viewAsCholmod(Ref >(mat.const_cast_derived())); + return res; +} + +/** Returns a view of the Eigen sparse matrix \a mat as Cholmod sparse matrix. + * The data are not copied but shared. */ +template +cholmod_sparse viewAsCholmod(const SparseSelfAdjointView, UpLo>& mat) { + cholmod_sparse res = viewAsCholmod(Ref >(mat.matrix().const_cast_derived())); + + if (UpLo == Upper) res.stype = 1; + if (UpLo == Lower) res.stype = -1; + // swap stype for rowmajor matrices (only works for real matrices) + EIGEN_STATIC_ASSERT((Options_ & RowMajorBit) == 0 || NumTraits::IsComplex == 0, + THIS_METHOD_IS_ONLY_FOR_COLUMN_MAJOR_MATRICES); + if (Options_ & RowMajorBit) res.stype *= -1; + + return res; +} + +/** Returns a view of the Eigen \b dense matrix \a mat as Cholmod dense matrix. + * The data are not copied but shared. */ +template +cholmod_dense viewAsCholmod(MatrixBase& mat) { + EIGEN_STATIC_ASSERT((internal::traits::Flags & RowMajorBit) == 0, + THIS_METHOD_IS_ONLY_FOR_COLUMN_MAJOR_MATRICES); + typedef typename Derived::Scalar Scalar; + + cholmod_dense res; + res.nrow = mat.rows(); + res.ncol = mat.cols(); + res.nzmax = res.nrow * res.ncol; + res.d = Derived::IsVectorAtCompileTime ? mat.derived().size() : mat.derived().outerStride(); + res.x = (void*)(mat.derived().data()); + res.z = 0; + + internal::cholmod_configure_matrix::run(res); + + return res; +} + +/** Returns a view of the Cholmod sparse matrix \a cm as an Eigen sparse matrix. + * The data are not copied but shared. */ +template +Map > viewAsEigen(cholmod_sparse& cm) { + return Map >( + cm.nrow, cm.ncol, static_cast(cm.p)[cm.ncol], static_cast(cm.p), + static_cast(cm.i), static_cast(cm.x)); +} + +/** Returns a view of the Cholmod sparse matrix factor \a cm as an Eigen sparse matrix. + * The data are not copied but shared. */ +template +Map > viewAsEigen(cholmod_factor& cm) { + return Map >( + cm.n, cm.n, static_cast(cm.p)[cm.n], static_cast(cm.p), + static_cast(cm.i), static_cast(cm.x)); +} + +namespace internal { + +// template specializations for int and long that call the correct cholmod method + +#define EIGEN_CHOLMOD_SPECIALIZE0(ret, name) \ + template \ + inline ret cm_##name(cholmod_common& Common) { \ + return cholmod_##name(&Common); \ + } \ + template <> \ + inline ret cm_##name(cholmod_common & Common) { \ + return cholmod_l_##name(&Common); \ + } + +#define EIGEN_CHOLMOD_SPECIALIZE1(ret, name, t1, a1) \ + template \ + inline ret cm_##name(t1& a1, cholmod_common& Common) { \ + return cholmod_##name(&a1, &Common); \ + } \ + template <> \ + inline ret cm_##name(t1 & a1, cholmod_common & Common) { \ + return cholmod_l_##name(&a1, &Common); \ + } + +EIGEN_CHOLMOD_SPECIALIZE0(int, start) +EIGEN_CHOLMOD_SPECIALIZE0(int, finish) + +EIGEN_CHOLMOD_SPECIALIZE1(int, free_factor, cholmod_factor*, L) +EIGEN_CHOLMOD_SPECIALIZE1(int, free_dense, cholmod_dense*, X) +EIGEN_CHOLMOD_SPECIALIZE1(int, free_sparse, cholmod_sparse*, A) + +EIGEN_CHOLMOD_SPECIALIZE1(cholmod_factor*, analyze, cholmod_sparse, A) +EIGEN_CHOLMOD_SPECIALIZE1(cholmod_sparse*, factor_to_sparse, cholmod_factor, L) + +template +inline cholmod_dense* cm_solve(int sys, cholmod_factor& L, cholmod_dense& B, cholmod_common& Common) { + return cholmod_solve(sys, &L, &B, &Common); +} +template <> +inline cholmod_dense* cm_solve(int sys, cholmod_factor& L, cholmod_dense& B, cholmod_common& Common) { + return cholmod_l_solve(sys, &L, &B, &Common); +} + +template +inline cholmod_sparse* cm_spsolve(int sys, cholmod_factor& L, cholmod_sparse& B, cholmod_common& Common) { + return cholmod_spsolve(sys, &L, &B, &Common); +} +template <> +inline cholmod_sparse* cm_spsolve(int sys, cholmod_factor& L, cholmod_sparse& B, + cholmod_common& Common) { + return cholmod_l_spsolve(sys, &L, &B, &Common); +} + +template +inline int cm_factorize_p(cholmod_sparse* A, double beta[2], StorageIndex_* fset, std::size_t fsize, cholmod_factor* L, + cholmod_common& Common) { + return cholmod_factorize_p(A, beta, fset, fsize, L, &Common); +} +template <> +inline int cm_factorize_p(cholmod_sparse* A, double beta[2], SuiteSparse_long* fset, + std::size_t fsize, cholmod_factor* L, cholmod_common& Common) { + return cholmod_l_factorize_p(A, beta, fset, fsize, L, &Common); +} + +#undef EIGEN_CHOLMOD_SPECIALIZE0 +#undef EIGEN_CHOLMOD_SPECIALIZE1 + +} // namespace internal + +enum CholmodMode { CholmodAuto, CholmodSimplicialLLt, CholmodSupernodalLLt, CholmodLDLt }; + +/** \ingroup CholmodSupport_Module + * \class CholmodBase + * \brief The base class for the direct Cholesky factorization of Cholmod + * \sa class CholmodSupernodalLLT, class CholmodSimplicialLDLT, class CholmodSimplicialLLT + */ +template +class CholmodBase : public SparseSolverBase { + protected: + typedef SparseSolverBase Base; + using Base::derived; + using Base::m_isInitialized; + + public: + typedef MatrixType_ MatrixType; + enum { UpLo = UpLo_ }; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef MatrixType CholMatrixType; + typedef typename MatrixType::StorageIndex StorageIndex; + enum { ColsAtCompileTime = MatrixType::ColsAtCompileTime, MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime }; + + public: + CholmodBase() : m_cholmodFactor(0), m_info(Success), m_factorizationIsOk(false), m_analysisIsOk(false) { + EIGEN_STATIC_ASSERT((internal::is_same::value), CHOLMOD_SUPPORTS_DOUBLE_PRECISION_ONLY); + m_shiftOffset[0] = m_shiftOffset[1] = 0.0; + internal::cm_start(m_cholmod); + } + + explicit CholmodBase(const MatrixType& matrix) + : m_cholmodFactor(0), m_info(Success), m_factorizationIsOk(false), m_analysisIsOk(false) { + EIGEN_STATIC_ASSERT((internal::is_same::value), CHOLMOD_SUPPORTS_DOUBLE_PRECISION_ONLY); + m_shiftOffset[0] = m_shiftOffset[1] = 0.0; + internal::cm_start(m_cholmod); + compute(matrix); + } + + ~CholmodBase() { + if (m_cholmodFactor) internal::cm_free_factor(m_cholmodFactor, m_cholmod); + internal::cm_finish(m_cholmod); + } + + inline StorageIndex cols() const { return internal::convert_index(m_cholmodFactor->n); } + inline StorageIndex rows() const { return internal::convert_index(m_cholmodFactor->n); } + + /** \brief Reports whether previous computation was successful. + * + * \returns \c Success if computation was successful, + * \c NumericalIssue if the matrix.appears to be negative. + */ + ComputationInfo info() const { + eigen_assert(m_isInitialized && "Decomposition is not initialized."); + return m_info; + } + + /** Computes the sparse Cholesky decomposition of \a matrix */ + Derived& compute(const MatrixType& matrix) { + analyzePattern(matrix); + factorize(matrix); + return derived(); + } + + /** Performs a symbolic decomposition on the sparsity pattern of \a matrix. + * + * This function is particularly useful when solving for several problems having the same structure. + * + * \sa factorize() + */ + void analyzePattern(const MatrixType& matrix) { + if (m_cholmodFactor) { + internal::cm_free_factor(m_cholmodFactor, m_cholmod); + m_cholmodFactor = 0; + } + cholmod_sparse A = viewAsCholmod(matrix.template selfadjointView()); + m_cholmodFactor = internal::cm_analyze(A, m_cholmod); + + this->m_isInitialized = true; + this->m_info = Success; + m_analysisIsOk = true; + m_factorizationIsOk = false; + } + + /** Performs a numeric decomposition of \a matrix + * + * The given matrix must have the same sparsity pattern as the matrix on which the symbolic decomposition has been + * performed. + * + * \sa analyzePattern() + */ + void factorize(const MatrixType& matrix) { + eigen_assert(m_analysisIsOk && "You must first call analyzePattern()"); + cholmod_sparse A = viewAsCholmod(matrix.template selfadjointView()); + internal::cm_factorize_p(&A, m_shiftOffset, 0, 0, m_cholmodFactor, m_cholmod); + + // If the factorization failed, either the input matrix was zero (so m_cholmodFactor == nullptr), or minor is the + // column at which it failed. On success minor == n. + this->m_info = + (m_cholmodFactor != nullptr && m_cholmodFactor->minor == m_cholmodFactor->n ? Success : NumericalIssue); + m_factorizationIsOk = true; + } + + /** Returns a reference to the Cholmod's configuration structure to get a full control over the performed operations. + * See the Cholmod user guide for details. */ + cholmod_common& cholmod() { return m_cholmod; } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal */ + template + void _solve_impl(const MatrixBase& b, MatrixBase& dest) const { + eigen_assert(m_factorizationIsOk && + "The decomposition is not in a valid state for solving, you must first call either compute() or " + "symbolic()/numeric()"); + const Index size = m_cholmodFactor->n; + EIGEN_UNUSED_VARIABLE(size); + eigen_assert(size == b.rows()); + + // Cholmod needs column-major storage without inner-stride, which corresponds to the default behavior of Ref. + Ref > b_ref(b.derived()); + + cholmod_dense b_cd = viewAsCholmod(b_ref); + cholmod_dense* x_cd = internal::cm_solve(CHOLMOD_A, *m_cholmodFactor, b_cd, m_cholmod); + if (!x_cd) { + this->m_info = NumericalIssue; + return; + } + // TODO optimize this copy by swapping when possible (be careful with alignment, etc.) + // NOTE Actually, the copy can be avoided by calling cholmod_solve2 instead of cholmod_solve + dest = Matrix::Map(reinterpret_cast(x_cd->x), + b.rows(), b.cols()); + internal::cm_free_dense(x_cd, m_cholmod); + } + + /** \internal */ + template + void _solve_impl(const SparseMatrixBase& b, SparseMatrixBase& dest) const { + eigen_assert(m_factorizationIsOk && + "The decomposition is not in a valid state for solving, you must first call either compute() or " + "symbolic()/numeric()"); + const Index size = m_cholmodFactor->n; + EIGEN_UNUSED_VARIABLE(size); + eigen_assert(size == b.rows()); + + // note: cs stands for Cholmod Sparse + Ref > b_ref( + b.const_cast_derived()); + cholmod_sparse b_cs = viewAsCholmod(b_ref); + cholmod_sparse* x_cs = internal::cm_spsolve(CHOLMOD_A, *m_cholmodFactor, b_cs, m_cholmod); + if (!x_cs) { + this->m_info = NumericalIssue; + return; + } + // TODO optimize this copy by swapping when possible (be careful with alignment, etc.) + // NOTE cholmod_spsolve in fact just calls the dense solver for blocks of 4 columns at a time (similar to Eigen's + // sparse solver) + dest.derived() = viewAsEigen(*x_cs); + internal::cm_free_sparse(x_cs, m_cholmod); + } +#endif // EIGEN_PARSED_BY_DOXYGEN + + /** Sets the shift parameter that will be used to adjust the diagonal coefficients during the numerical factorization. + * + * During the numerical factorization, an offset term is added to the diagonal coefficients:\n + * \c d_ii = \a offset + \c d_ii + * + * The default is \a offset=0. + * + * \returns a reference to \c *this. + */ + Derived& setShift(const RealScalar& offset) { + m_shiftOffset[0] = double(offset); + return derived(); + } + + /** \returns the determinant of the underlying matrix from the current factorization */ + Scalar determinant() const { + using std::exp; + return exp(logDeterminant()); + } + + /** \returns the log determinant of the underlying matrix from the current factorization */ + Scalar logDeterminant() const { + using numext::real; + using std::log; + eigen_assert(m_factorizationIsOk && + "The decomposition is not in a valid state for solving, you must first call either compute() or " + "symbolic()/numeric()"); + + RealScalar logDet = 0; + Scalar* x = static_cast(m_cholmodFactor->x); + if (m_cholmodFactor->is_super) { + // Supernodal factorization stored as a packed list of dense column-major blocks, + // as described by the following structure: + + // super[k] == index of the first column of the j-th super node + StorageIndex* super = static_cast(m_cholmodFactor->super); + // pi[k] == offset to the description of row indices + StorageIndex* pi = static_cast(m_cholmodFactor->pi); + // px[k] == offset to the respective dense block + StorageIndex* px = static_cast(m_cholmodFactor->px); + + Index nb_super_nodes = m_cholmodFactor->nsuper; + for (Index k = 0; k < nb_super_nodes; ++k) { + StorageIndex ncols = super[k + 1] - super[k]; + StorageIndex nrows = pi[k + 1] - pi[k]; + + Map, 0, InnerStride<> > sk(x + px[k], ncols, InnerStride<>(nrows + 1)); + logDet += sk.real().log().sum(); + } + } else { + // Simplicial factorization stored as standard CSC matrix. + StorageIndex* p = static_cast(m_cholmodFactor->p); + Index size = m_cholmodFactor->n; + for (Index k = 0; k < size; ++k) logDet += log(real(x[p[k]])); + } + if (m_cholmodFactor->is_ll) logDet *= 2.0; + return logDet; + } + + template + void dumpMemory(Stream& /*s*/) {} + + protected: + mutable cholmod_common m_cholmod; + cholmod_factor* m_cholmodFactor; + double m_shiftOffset[2]; + mutable ComputationInfo m_info; + int m_factorizationIsOk; + int m_analysisIsOk; +}; + +/** \ingroup CholmodSupport_Module + * \class CholmodSimplicialLLT + * \brief A simplicial direct Cholesky (LLT) factorization and solver based on Cholmod + * + * This class allows to solve for A.X = B sparse linear problems via a simplicial LL^T Cholesky factorization + * using the Cholmod library. + * This simplicial variant is equivalent to Eigen's built-in SimplicialLLT class. Therefore, it has little practical + * interest. The sparse matrix A must be selfadjoint and positive definite. The vectors or matrices X and B can be + * either dense or sparse. + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ the triangular part that will be used for the computations. It can be Lower + * or Upper. Default is Lower. + * + * \implsparsesolverconcept + * + * This class supports all kind of SparseMatrix<>: row or column major; upper, lower, or both; compressed or non + * compressed. + * + * \warning Only double precision real and complex scalar types are supported by Cholmod. + * + * \sa \ref TutorialSparseSolverConcept, class CholmodSupernodalLLT, class SimplicialLLT + */ +template +class CholmodSimplicialLLT : public CholmodBase > { + typedef CholmodBase Base; + using Base::m_cholmod; + + public: + typedef MatrixType_ MatrixType; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename MatrixType::StorageIndex StorageIndex; + typedef TriangularView MatrixL; + typedef TriangularView MatrixU; + + CholmodSimplicialLLT() : Base() { init(); } + + CholmodSimplicialLLT(const MatrixType& matrix) : Base() { + init(); + this->compute(matrix); + } + + ~CholmodSimplicialLLT() {} + + /** \returns an expression of the factor L */ + inline MatrixL matrixL() const { return viewAsEigen(*Base::m_cholmodFactor); } + + /** \returns an expression of the factor U (= L^*) */ + inline MatrixU matrixU() const { return matrixL().adjoint(); } + + protected: + void init() { + m_cholmod.final_asis = 0; + m_cholmod.supernodal = CHOLMOD_SIMPLICIAL; + m_cholmod.final_ll = 1; + } +}; + +/** \ingroup CholmodSupport_Module + * \class CholmodSimplicialLDLT + * \brief A simplicial direct Cholesky (LDLT) factorization and solver based on Cholmod + * + * This class allows to solve for A.X = B sparse linear problems via a simplicial LDL^T Cholesky factorization + * using the Cholmod library. + * This simplicial variant is equivalent to Eigen's built-in SimplicialLDLT class. Therefore, it has little practical + * interest. The sparse matrix A must be selfadjoint and positive definite. The vectors or matrices X and B can be + * either dense or sparse. + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ the triangular part that will be used for the computations. It can be Lower + * or Upper. Default is Lower. + * + * \implsparsesolverconcept + * + * This class supports all kind of SparseMatrix<>: row or column major; upper, lower, or both; compressed or non + * compressed. + * + * \warning Only double precision real and complex scalar types are supported by Cholmod. + * + * \sa \ref TutorialSparseSolverConcept, class CholmodSupernodalLLT, class SimplicialLDLT + */ +template +class CholmodSimplicialLDLT : public CholmodBase > { + typedef CholmodBase Base; + using Base::m_cholmod; + + public: + typedef MatrixType_ MatrixType; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename MatrixType::StorageIndex StorageIndex; + typedef Matrix VectorType; + typedef TriangularView MatrixL; + typedef TriangularView MatrixU; + + CholmodSimplicialLDLT() : Base() { init(); } + + CholmodSimplicialLDLT(const MatrixType& matrix) : Base() { + init(); + this->compute(matrix); + } + + ~CholmodSimplicialLDLT() {} + + /** \returns a vector expression of the diagonal D */ + inline VectorType vectorD() const { + auto cholmodL = viewAsEigen(*Base::m_cholmodFactor); + + VectorType D{cholmodL.rows()}; + + for (Index k = 0; k < cholmodL.outerSize(); ++k) { + typename decltype(cholmodL)::InnerIterator it{cholmodL, k}; + D(k) = it.value(); + } + + return D; + } + + /** \returns an expression of the factor L */ + inline MatrixL matrixL() const { return viewAsEigen(*Base::m_cholmodFactor); } + + /** \returns an expression of the factor U (= L^*) */ + inline MatrixU matrixU() const { return matrixL().adjoint(); } + + protected: + void init() { + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_SIMPLICIAL; + } +}; + +/** \ingroup CholmodSupport_Module + * \class CholmodSupernodalLLT + * \brief A supernodal Cholesky (LLT) factorization and solver based on Cholmod + * + * This class allows to solve for A.X = B sparse linear problems via a supernodal LL^T Cholesky factorization + * using the Cholmod library. + * This supernodal variant performs best on dense enough problems, e.g., 3D FEM, or very high order 2D FEM. + * The sparse matrix A must be selfadjoint and positive definite. The vectors or matrices + * X and B can be either dense or sparse. + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ the triangular part that will be used for the computations. It can be Lower + * or Upper. Default is Lower. + * + * \implsparsesolverconcept + * + * This class supports all kind of SparseMatrix<>: row or column major; upper, lower, or both; compressed or non + * compressed. + * + * \warning Only double precision real and complex scalar types are supported by Cholmod. + * + * \sa \ref TutorialSparseSolverConcept + */ +template +class CholmodSupernodalLLT : public CholmodBase > { + typedef CholmodBase Base; + using Base::m_cholmod; + + public: + typedef MatrixType_ MatrixType; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename MatrixType::StorageIndex StorageIndex; + + CholmodSupernodalLLT() : Base() { init(); } + + CholmodSupernodalLLT(const MatrixType& matrix) : Base() { + init(); + this->compute(matrix); + } + + ~CholmodSupernodalLLT() {} + + /** \returns an expression of the factor L */ + inline MatrixType matrixL() const { + // Convert Cholmod factor's supernodal storage format to Eigen's CSC storage format + cholmod_sparse* cholmodL = internal::cm_factor_to_sparse(*Base::m_cholmodFactor, m_cholmod); + MatrixType L = viewAsEigen(*cholmodL); + internal::cm_free_sparse(cholmodL, m_cholmod); + + return L; + } + + /** \returns an expression of the factor U (= L^*) */ + inline MatrixType matrixU() const { return matrixL().adjoint(); } + + protected: + void init() { + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_SUPERNODAL; + } +}; + +/** \ingroup CholmodSupport_Module + * \class CholmodDecomposition + * \brief A general Cholesky factorization and solver based on Cholmod + * + * This class allows to solve for A.X = B sparse linear problems via a LL^T or LDL^T Cholesky factorization + * using the Cholmod library. The sparse matrix A must be selfadjoint and positive definite. The vectors or matrices + * X and B can be either dense or sparse. + * + * This variant permits to change the underlying Cholesky method at runtime. + * On the other hand, it does not provide access to the result of the factorization. + * The default is to let Cholmod automatically choose between a simplicial and supernodal factorization. + * + * \tparam MatrixType_ the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam UpLo_ the triangular part that will be used for the computations. It can be Lower + * or Upper. Default is Lower. + * + * \implsparsesolverconcept + * + * This class supports all kind of SparseMatrix<>: row or column major; upper, lower, or both; compressed or non + * compressed. + * + * \warning Only double precision real and complex scalar types are supported by Cholmod. + * + * \sa \ref TutorialSparseSolverConcept + */ +template +class CholmodDecomposition : public CholmodBase > { + typedef CholmodBase Base; + using Base::m_cholmod; + + public: + typedef MatrixType_ MatrixType; + + CholmodDecomposition() : Base() { init(); } + + CholmodDecomposition(const MatrixType& matrix) : Base() { + init(); + this->compute(matrix); + } + + ~CholmodDecomposition() {} + + void setMode(CholmodMode mode) { + switch (mode) { + case CholmodAuto: + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_AUTO; + break; + case CholmodSimplicialLLt: + m_cholmod.final_asis = 0; + m_cholmod.supernodal = CHOLMOD_SIMPLICIAL; + m_cholmod.final_ll = 1; + break; + case CholmodSupernodalLLt: + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_SUPERNODAL; + break; + case CholmodLDLt: + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_SIMPLICIAL; + break; + default: + break; + } + } + + protected: + void init() { + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_AUTO; + } +}; + +} // end namespace Eigen + +#endif // EIGEN_CHOLMODSUPPORT_H diff --git a/src/3rdparty/eigen/Eigen/src/CholmodSupport/InternalHeaderCheck.h b/src/3rdparty/eigen/Eigen/src/CholmodSupport/InternalHeaderCheck.h new file mode 100644 index 0000000..0fb3abc --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/CholmodSupport/InternalHeaderCheck.h @@ -0,0 +1,3 @@ +#ifndef EIGEN_CHOLMODSUPPORT_MODULE_H +#error "Please include Eigen/CholmodSupport instead of including headers inside the src directory directly." +#endif diff --git a/src/3rdparty/eigen/Eigen/src/Core/ArithmeticSequence.h b/src/3rdparty/eigen/Eigen/src/Core/ArithmeticSequence.h new file mode 100644 index 0000000..ae6373d --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ArithmeticSequence.h @@ -0,0 +1,239 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2017 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARITHMETIC_SEQUENCE_H +#define EIGEN_ARITHMETIC_SEQUENCE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +// Helper to cleanup the type of the increment: +template +struct cleanup_seq_incr { + typedef typename cleanup_index_type::type type; +}; + +} // namespace internal + +//-------------------------------------------------------------------------------- +// seq(first,last,incr) and seqN(first,size,incr) +//-------------------------------------------------------------------------------- + +template > +class ArithmeticSequence; + +template +ArithmeticSequence::type, + typename internal::cleanup_index_type::type, + typename internal::cleanup_seq_incr::type> +seqN(FirstType first, SizeType size, IncrType incr); + +/** \class ArithmeticSequence + * \ingroup Core_Module + * + * This class represents an arithmetic progression \f$ a_0, a_1, a_2, ..., a_{n-1}\f$ defined by + * its \em first value \f$ a_0 \f$, its \em size (aka length) \em n, and the \em increment (aka stride) + * that is equal to \f$ a_{i+1}-a_{i}\f$ for any \em i. + * + * It is internally used as the return type of the Eigen::seq and Eigen::seqN functions, and as the input arguments + * of DenseBase::operator()(const RowIndices&, const ColIndices&), and most of the time this is the + * only way it is used. + * + * \tparam FirstType type of the first element, usually an Index, + * but internally it can be a symbolic expression + * \tparam SizeType type representing the size of the sequence, usually an Index + * or a compile time integral constant. Internally, it can also be a symbolic expression + * \tparam IncrType type of the increment, can be a runtime Index, or a compile time integral constant (default is + * compile-time 1) + * + * \sa Eigen::seq, Eigen::seqN, DenseBase::operator()(const RowIndices&, const ColIndices&), class IndexedView + */ +template +class ArithmeticSequence { + public: + constexpr ArithmeticSequence() = default; + constexpr ArithmeticSequence(FirstType first, SizeType size) : m_first(first), m_size(size) {} + constexpr ArithmeticSequence(FirstType first, SizeType size, IncrType incr) + : m_first(first), m_size(size), m_incr(incr) {} + + enum { + // SizeAtCompileTime = internal::get_fixed_value::value, + IncrAtCompileTime = internal::get_fixed_value::value + }; + + /** \returns the size, i.e., number of elements, of the sequence */ + constexpr Index size() const { return m_size; } + + /** \returns the first element \f$ a_0 \f$ in the sequence */ + constexpr Index first() const { return m_first; } + + /** \returns the value \f$ a_i \f$ at index \a i in the sequence. */ + constexpr Index operator[](Index i) const { return m_first + i * m_incr; } + + constexpr const FirstType& firstObject() const { return m_first; } + constexpr const SizeType& sizeObject() const { return m_size; } + constexpr const IncrType& incrObject() const { return m_incr; } + + protected: + FirstType m_first; + SizeType m_size; + IncrType m_incr; + + public: + constexpr auto reverse() const -> decltype(Eigen::seqN(m_first + (m_size + fix<-1>()) * m_incr, m_size, -m_incr)) { + return seqN(m_first + (m_size + fix<-1>()) * m_incr, m_size, -m_incr); + } +}; + +/** \returns an ArithmeticSequence starting at \a first, of length \a size, and increment \a incr + * + * \sa seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) */ +template +ArithmeticSequence::type, + typename internal::cleanup_index_type::type, + typename internal::cleanup_seq_incr::type> +seqN(FirstType first, SizeType size, IncrType incr) { + return ArithmeticSequence::type, + typename internal::cleanup_index_type::type, + typename internal::cleanup_seq_incr::type>(first, size, incr); +} + +/** \returns an ArithmeticSequence starting at \a first, of length \a size, and unit increment + * + * \sa seqN(FirstType,SizeType,IncrType), seq(FirstType,LastType) */ +template +ArithmeticSequence::type, + typename internal::cleanup_index_type::type> +seqN(FirstType first, SizeType size) { + return ArithmeticSequence::type, + typename internal::cleanup_index_type::type>(first, size); +} + +#ifdef EIGEN_PARSED_BY_DOXYGEN + +/** \returns an ArithmeticSequence starting at \a f, up (or down) to \a l, and with positive (or negative) increment \a + * incr + * + * It is essentially an alias to: + * \code + * seqN(f, (l-f+incr)/incr, incr); + * \endcode + * + * \sa seqN(FirstType,SizeType,IncrType), seq(FirstType,LastType) + */ +template +auto seq(FirstType f, LastType l, IncrType incr); + +/** \returns an ArithmeticSequence starting at \a f, up (or down) to \a l, and unit increment + * + * It is essentially an alias to: + * \code + * seqN(f,l-f+1); + * \endcode + * + * \sa seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) + */ +template +auto seq(FirstType f, LastType l); + +#else // EIGEN_PARSED_BY_DOXYGEN + +template +auto seq(FirstType f, LastType l) + -> decltype(seqN(typename internal::cleanup_index_type::type(f), + (typename internal::cleanup_index_type::type(l) - + typename internal::cleanup_index_type::type(f) + fix<1>()))) { + return seqN(typename internal::cleanup_index_type::type(f), + (typename internal::cleanup_index_type::type(l) - + typename internal::cleanup_index_type::type(f) + fix<1>())); +} + +template +auto seq(FirstType f, LastType l, IncrType incr) + -> decltype(seqN(typename internal::cleanup_index_type::type(f), + (typename internal::cleanup_index_type::type(l) - + typename internal::cleanup_index_type::type(f) + + typename internal::cleanup_seq_incr::type(incr)) / + typename internal::cleanup_seq_incr::type(incr), + typename internal::cleanup_seq_incr::type(incr))) { + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(typename internal::cleanup_index_type::type(f), + (typename internal::cleanup_index_type::type(l) - + typename internal::cleanup_index_type::type(f) + CleanedIncrType(incr)) / + CleanedIncrType(incr), + CleanedIncrType(incr)); +} + +#endif // EIGEN_PARSED_BY_DOXYGEN + +namespace placeholders { + +/** \cpp11 + * \returns a symbolic ArithmeticSequence representing the last \a size elements with increment \a incr. + * + * It is a shortcut for: \code seqN(last-(size-fix<1>)*incr, size, incr) \endcode + * + * \sa lastN(SizeType), seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) */ +template +auto lastN(SizeType size, IncrType incr) + -> decltype(seqN(Eigen::placeholders::last - (size - fix<1>()) * incr, size, incr)) { + return seqN(Eigen::placeholders::last - (size - fix<1>()) * incr, size, incr); +} + +/** \cpp11 + * \returns a symbolic ArithmeticSequence representing the last \a size elements with a unit increment. + * + * It is a shortcut for: \code seq(last+fix<1>-size, last) \endcode + * + * \sa lastN(SizeType,IncrType, seqN(FirstType,SizeType), seq(FirstType,LastType) */ +template +auto lastN(SizeType size) -> decltype(seqN(Eigen::placeholders::last + fix<1>() - size, size)) { + return seqN(Eigen::placeholders::last + fix<1>() - size, size); +} + +} // namespace placeholders + +/** \namespace Eigen::indexing + * \ingroup Core_Module + * + * The sole purpose of this namespace is to be able to import all functions + * and symbols that are expected to be used within operator() for indexing + * and slicing. If you already imported the whole Eigen namespace: + * \code using namespace Eigen; \endcode + * then you are already all set. Otherwise, if you don't want/cannot import + * the whole Eigen namespace, the following line: + * \code using namespace Eigen::indexing; \endcode + * is equivalent to: + * \code + using Eigen::fix; + using Eigen::seq; + using Eigen::seqN; + using Eigen::placeholders::all; + using Eigen::placeholders::last; + using Eigen::placeholders::lastN; // c++11 only + using Eigen::placeholders::lastp1; + \endcode + */ +namespace indexing { +using Eigen::fix; +using Eigen::seq; +using Eigen::seqN; +using Eigen::placeholders::all; +using Eigen::placeholders::last; +using Eigen::placeholders::lastN; +using Eigen::placeholders::lastp1; +} // namespace indexing + +} // end namespace Eigen + +#endif // EIGEN_ARITHMETIC_SEQUENCE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Array.h b/src/3rdparty/eigen/Eigen/src/Core/Array.h new file mode 100644 index 0000000..57f3186 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Array.h @@ -0,0 +1,376 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAY_H +#define EIGEN_ARRAY_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits> + : traits> { + typedef ArrayXpr XprKind; + typedef ArrayBase> XprBase; +}; +} // namespace internal + +/** \class Array + * \ingroup Core_Module + * + * \brief General-purpose arrays with easy API for coefficient-wise operations + * + * The %Array class is very similar to the Matrix class. It provides + * general-purpose one- and two-dimensional arrays. The difference between the + * %Array and the %Matrix class is primarily in the API: the API for the + * %Array class provides easy access to coefficient-wise operations, while the + * API for the %Matrix class provides easy access to linear-algebra + * operations. + * + * See documentation of class Matrix for detailed information on the template parameters + * storage layout. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_ARRAY_PLUGIN. + * + * \sa \blank \ref TutorialArrayClass, \ref TopicClassHierarchy + */ +template +class Array : public PlainObjectBase> { + public: + typedef PlainObjectBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Array) + + enum { Options = Options_ }; + typedef typename Base::PlainObject PlainObject; + + protected: + template + friend struct internal::conservative_resize_like_impl; + + using Base::m_storage; + + public: + using Base::base; + using Base::coeff; + using Base::coeffRef; + + /** + * The usage of + * using Base::operator=; + * fails on MSVC. Since the code below is working with GCC and MSVC, we skipped + * the usage of 'using'. This should be done only for operator=. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array& operator=(const EigenBase& other) { + return Base::operator=(other); + } + + /** Set all the entries to \a value. + * \sa DenseBase::setConstant(), DenseBase::fill() + */ + /* This overload is needed because the usage of + * using Base::operator=; + * fails on MSVC. Since the code below is working with GCC and MSVC, we skipped + * the usage of 'using'. This should be done only for operator=. + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array& operator=(const Scalar& value) { + Base::setConstant(value); + return *this; + } + + /** Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array& operator=(const DenseBase& other) { + return Base::_set(other); + } + + /** + * \brief Assigns arrays to each other. + * + * \note This is a special case of the templated operator=. Its purpose is + * to prevent a default operator= from hiding the templated operator=. + * + * \callgraph + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array& operator=(const Array& other) { return Base::_set(other); } + + /** Default constructor. + * + * For fixed-size matrices, does nothing. + * + * For dynamic-size matrices, creates an empty matrix of size 0. Does not allocate any array. Such a matrix + * is called a null matrix. This constructor is the unique way to create null matrices: resizing + * a matrix to 0 is not supported. + * + * \sa resize(Index,Index) + */ +#ifdef EIGEN_INITIALIZE_COEFFS + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Array() : Base() { EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED } +#else + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Array() = default; +#endif + /** \brief Move constructor */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Array(Array&&) = default; + EIGEN_DEVICE_FUNC Array& operator=(Array&& other) noexcept(std::is_nothrow_move_assignable::value) { + Base::operator=(std::move(other)); + return *this; + } + + /** \brief Construct a row of column vector with fixed size from an arbitrary number of coefficients. + * + * \only_for_vectors + * + * This constructor is for 1D array or vectors with more than 4 coefficients. + * + * \warning To construct a column (resp. row) vector of fixed length, the number of values passed to this + * constructor must match the the fixed number of rows (resp. columns) of \c *this. + * + * + * Example: \include Array_variadic_ctor_cxx11.cpp + * Output: \verbinclude Array_variadic_ctor_cxx11.out + * + * \sa Array(const std::initializer_list>&) + * \sa Array(const Scalar&), Array(const Scalar&,const Scalar&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, + const ArgTypes&... args) + : Base(a0, a1, a2, a3, args...) {} + + /** \brief Constructs an array and initializes it from the coefficients given as initializer-lists grouped by row. + * \cpp11 + * + * In the general case, the constructor takes a list of rows, each row being represented as a list of coefficients: + * + * Example: \include Array_initializer_list_23_cxx11.cpp + * Output: \verbinclude Array_initializer_list_23_cxx11.out + * + * Each of the inner initializer lists must contain the exact same number of elements, otherwise an assertion is + * triggered. + * + * In the case of a compile-time column 1D array, implicit transposition from a single row is allowed. + * Therefore Array{{1,2,3,4,5}} is legal and the more verbose syntax + * Array{{1},{2},{3},{4},{5}} can be avoided: + * + * Example: \include Array_initializer_list_vector_cxx11.cpp + * Output: \verbinclude Array_initializer_list_vector_cxx11.out + * + * In the case of fixed-sized arrays, the initializer list sizes must exactly match the array sizes, + * and implicit transposition is allowed for compile-time 1D arrays only. + * + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Array( + const std::initializer_list>& list) + : Base(list) {} + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit Array(const T& x) { + Base::template _init1(x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array(const T0& val0, const T1& val1) { + this->template _init2(val0, val1); + } + +#else + /** \brief Constructs a fixed-sized array initialized with coefficients starting at \a data */ + EIGEN_DEVICE_FUNC explicit Array(const Scalar* data); + /** Constructs a vector or row-vector with given dimension. \only_for_vectors + * + * Note that this is only useful for dynamic-size vectors. For fixed-size vectors, + * it is redundant to pass the dimension here, so it makes more sense to use the default + * constructor Array() instead. + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit Array(Index dim); + /** constructs an initialized 1x1 Array with the given coefficient + * \sa const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args */ + Array(const Scalar& value); + /** constructs an uninitialized array with \a rows rows and \a cols columns. + * + * This is useful for dynamic-size arrays. For fixed-size arrays, + * it is redundant to pass these parameters, so one should use the default constructor + * Array() instead. */ + Array(Index rows, Index cols); + /** constructs an initialized 2D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) */ + Array(const Scalar& val0, const Scalar& val1); +#endif // end EIGEN_PARSED_BY_DOXYGEN + + /** constructs an initialized 3D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array(const Scalar& val0, const Scalar& val1, const Scalar& val2) { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Array, 3) + m_storage.data()[0] = val0; + m_storage.data()[1] = val1; + m_storage.data()[2] = val2; + } + /** constructs an initialized 4D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array(const Scalar& val0, const Scalar& val1, const Scalar& val2, + const Scalar& val3) { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Array, 4) + m_storage.data()[0] = val0; + m_storage.data()[1] = val1; + m_storage.data()[2] = val2; + m_storage.data()[3] = val3; + } + + /** Copy constructor */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Array(const Array&) = default; + + private: + struct PrivateType {}; + + public: + /** \sa MatrixBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Array( + const EigenBase& other, + std::enable_if_t::value, PrivateType> = + PrivateType()) + : Base(other.derived()) {} + + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return 1; } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return this->innerSize(); } + +#ifdef EIGEN_ARRAY_PLUGIN +#include EIGEN_ARRAY_PLUGIN +#endif + + private: + template + friend struct internal::matrix_swap_impl; +}; + +/** \defgroup arraytypedefs Global array typedefs + * \ingroup Core_Module + * + * %Eigen defines several typedef shortcuts for most common 1D and 2D array types. + * + * The general patterns are the following: + * + * \c ArrayRowsColsType where \c Rows and \c Cols can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for + * dynamic size, and where \c Type can be \c i for integer, \c f for float, \c d for double, \c cf for complex float, \c + * cd for complex double. + * + * For example, \c Array33d is a fixed-size 3x3 array type of doubles, and \c ArrayXXf is a dynamic-size matrix of + * floats. + * + * There are also \c ArraySizeType which are self-explanatory. For example, \c Array4cf is + * a fixed-size 1D array of 4 complex floats. + * + * With \cpp11, template alias are also defined for common sizes. + * They follow the same pattern as above except that the scalar type suffix is replaced by a + * template parameter, i.e.: + * - `ArrayRowsCols` where `Rows` and `Cols` can be \c 2,\c 3,\c 4, or \c X for fixed or dynamic size. + * - `ArraySize` where `Size` can be \c 2,\c 3,\c 4 or \c X for fixed or dynamic size 1D arrays. + * + * \sa class Array + */ + +#define EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, Size, SizeSuffix) \ + /** \ingroup arraytypedefs */ \ + typedef Array Array##SizeSuffix##SizeSuffix##TypeSuffix; \ + /** \ingroup arraytypedefs */ \ + typedef Array Array##SizeSuffix##TypeSuffix; + +#define EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, Size) \ + /** \ingroup arraytypedefs */ \ + typedef Array Array##Size##X##TypeSuffix; \ + /** \ingroup arraytypedefs */ \ + typedef Array Array##X##Size##TypeSuffix; + +#define EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(Type, TypeSuffix) \ + EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 2, 2) \ + EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 3, 3) \ + EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 4, 4) \ + EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, Dynamic, X) \ + EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 2) \ + EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 3) \ + EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 4) + +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(int, i) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(float, f) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(double, d) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(std::complex, cf) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(std::complex, cd) + +#undef EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES +#undef EIGEN_MAKE_ARRAY_TYPEDEFS +#undef EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS + +#define EIGEN_MAKE_ARRAY_TYPEDEFS(Size, SizeSuffix) \ + /** \ingroup arraytypedefs */ \ + /** \brief \cpp11 */ \ + template \ + using Array##SizeSuffix##SizeSuffix = Array; \ + /** \ingroup arraytypedefs */ \ + /** \brief \cpp11 */ \ + template \ + using Array##SizeSuffix = Array; + +#define EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Size) \ + /** \ingroup arraytypedefs */ \ + /** \brief \cpp11 */ \ + template \ + using Array##Size##X = Array; \ + /** \ingroup arraytypedefs */ \ + /** \brief \cpp11 */ \ + template \ + using Array##X##Size = Array; + +EIGEN_MAKE_ARRAY_TYPEDEFS(2, 2) +EIGEN_MAKE_ARRAY_TYPEDEFS(3, 3) +EIGEN_MAKE_ARRAY_TYPEDEFS(4, 4) +EIGEN_MAKE_ARRAY_TYPEDEFS(Dynamic, X) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(2) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(3) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(4) + +#undef EIGEN_MAKE_ARRAY_TYPEDEFS +#undef EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS + +#define EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, SizeSuffix) \ + using Eigen::Matrix##SizeSuffix##TypeSuffix; \ + using Eigen::Vector##SizeSuffix##TypeSuffix; \ + using Eigen::RowVector##SizeSuffix##TypeSuffix; + +#define EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(TypeSuffix) \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 2) \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 3) \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 4) \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, X) + +#define EIGEN_USING_ARRAY_TYPEDEFS \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(i) \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(f) \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(d) \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(cf) \ + EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(cd) + +} // end namespace Eigen + +#endif // EIGEN_ARRAY_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h b/src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h new file mode 100644 index 0000000..8465f54 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h @@ -0,0 +1,213 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAYBASE_H +#define EIGEN_ARRAYBASE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +template +class MatrixWrapper; + +/** \class ArrayBase + * \ingroup Core_Module + * + * \brief Base class for all 1D and 2D array, and related expressions + * + * An array is similar to a dense vector or matrix. While matrices are mathematical + * objects with well defined linear algebra operators, an array is just a collection + * of scalar values arranged in a one or two dimensional fashion. As the main consequence, + * all operations applied to an array are performed coefficient wise. Furthermore, + * arrays support scalar math functions of the c++ standard library (e.g., std::sin(x)), and convenient + * constructors allowing to easily write generic code working for both scalar values + * and arrays. + * + * This class is the base that is inherited by all array expression types. + * + * \tparam Derived is the derived type, e.g., an array or an expression type. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_ARRAYBASE_PLUGIN. + * + * \sa class MatrixBase, \ref TopicClassHierarchy + */ +template +class ArrayBase : public DenseBase { + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** The base class for a given storage type. */ + typedef ArrayBase StorageBaseType; + + typedef ArrayBase Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + typedef DenseBase Base; + using Base::ColsAtCompileTime; + using Base::Flags; + using Base::IsVectorAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::RowsAtCompileTime; + using Base::SizeAtCompileTime; + + using Base::coeff; + using Base::coeffRef; + using Base::cols; + using Base::const_cast_derived; + using Base::derived; + using Base::lazyAssign; + using Base::rows; + using Base::size; + using Base::operator-; + using Base::operator=; + using Base::operator+=; + using Base::operator-=; + using Base::operator*=; + using Base::operator/=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + + typedef typename Base::PlainObject PlainObject; + + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp, PlainObject> ConstantReturnType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::ArrayBase +#define EIGEN_DOC_UNARY_ADDONS(X, Y) +#include "../plugins/MatrixCwiseUnaryOps.inc" +#include "../plugins/ArrayCwiseUnaryOps.inc" +#include "../plugins/CommonCwiseBinaryOps.inc" +#include "../plugins/MatrixCwiseBinaryOps.inc" +#include "../plugins/ArrayCwiseBinaryOps.inc" +#ifdef EIGEN_ARRAYBASE_PLUGIN +#include EIGEN_ARRAYBASE_PLUGIN +#endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_UNARY_ADDONS + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const ArrayBase& other) { + internal::call_assignment(derived(), other.derived()); + return derived(); + } + + /** Set all the entries to \a value. + * \sa DenseBase::setConstant(), DenseBase::fill() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const Scalar& value) { + Base::setConstant(value); + return derived(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator+=(const Scalar& other) { + internal::call_assignment(this->derived(), PlainObject::Constant(rows(), cols(), other), + internal::add_assign_op()); + return derived(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator-=(const Scalar& other) { + internal::call_assignment(this->derived(), PlainObject::Constant(rows(), cols(), other), + internal::sub_assign_op()); + return derived(); + } + + /** replaces \c *this by \c *this + \a other. + * + * \returns a reference to \c *this + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator+=(const ArrayBase& other) { + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); + } + + /** replaces \c *this by \c *this - \a other. + * + * \returns a reference to \c *this + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator-=(const ArrayBase& other) { + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); + } + + /** replaces \c *this by \c *this * \a other coefficient wise. + * + * \returns a reference to \c *this + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator*=(const ArrayBase& other) { + call_assignment(derived(), other.derived(), internal::mul_assign_op()); + return derived(); + } + + /** replaces \c *this by \c *this / \a other coefficient wise. + * + * \returns a reference to \c *this + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator/=(const ArrayBase& other) { + call_assignment(derived(), other.derived(), internal::div_assign_op()); + return derived(); + } + + public: + EIGEN_DEVICE_FUNC ArrayBase& array() { return *this; } + EIGEN_DEVICE_FUNC const ArrayBase& array() const { return *this; } + + /** \returns an \link Eigen::MatrixBase Matrix \endlink expression of this array + * \sa MatrixBase::array() */ + EIGEN_DEVICE_FUNC MatrixWrapper matrix() { return MatrixWrapper(derived()); } + EIGEN_DEVICE_FUNC const MatrixWrapper matrix() const { + return MatrixWrapper(derived()); + } + + // template + // inline void evalTo(Dest& dst) const { dst = matrix(); } + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(ArrayBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(ArrayBase) + + private: + explicit ArrayBase(Index); + ArrayBase(Index, Index); + template + explicit ArrayBase(const ArrayBase&); + + protected: + // mixing arrays and matrices is not legal + template + Derived& operator+=(const MatrixBase&) { + EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar)) == -1, + YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); + return *this; + } + // mixing arrays and matrices is not legal + template + Derived& operator-=(const MatrixBase&) { + EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar)) == -1, + YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); + return *this; + } +}; + +} // end namespace Eigen + +#endif // EIGEN_ARRAYBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ArrayWrapper.h b/src/3rdparty/eigen/Eigen/src/Core/ArrayWrapper.h new file mode 100644 index 0000000..c9a194e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ArrayWrapper.h @@ -0,0 +1,165 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAYWRAPPER_H +#define EIGEN_ARRAYWRAPPER_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class ArrayWrapper + * \ingroup Core_Module + * + * \brief Expression of a mathematical vector or matrix as an array object + * + * This class is the return type of MatrixBase::array(), and most of the time + * this is the only way it is use. + * + * \sa MatrixBase::array(), class MatrixWrapper + */ + +namespace internal { +template +struct traits > : public traits > { + typedef ArrayXpr XprKind; + // Let's remove NestByRefBit + enum { + Flags0 = traits >::Flags, + LvalueBitFlag = is_lvalue::value ? LvalueBit : 0, + Flags = (Flags0 & ~(NestByRefBit | LvalueBit)) | LvalueBitFlag + }; +}; +} // namespace internal + +template +class ArrayWrapper : public ArrayBase > { + public: + typedef ArrayBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ArrayWrapper) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ArrayWrapper) + typedef internal::remove_all_t NestedExpression; + + typedef std::conditional_t::value, Scalar, const Scalar> + ScalarWithConstIfNotLvalue; + + typedef typename internal::ref_selector::non_const_type NestedExpressionType; + + using Base::coeffRef; + + EIGEN_DEVICE_FUNC explicit EIGEN_STRONG_INLINE ArrayWrapper(ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_expression.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_expression.cols(); } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC constexpr ScalarWithConstIfNotLvalue* data() { return m_expression.data(); } + EIGEN_DEVICE_FUNC constexpr const Scalar* data() const { return m_expression.data(); } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index rowId, Index colId) const { + return m_expression.coeffRef(rowId, colId); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index index) const { return m_expression.coeffRef(index); } + + template + EIGEN_DEVICE_FUNC inline void evalTo(Dest& dst) const { + dst = m_expression; + } + + EIGEN_DEVICE_FUNC const internal::remove_all_t& nestedExpression() const { + return m_expression; + } + + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index) */ + EIGEN_DEVICE_FUNC void resize(Index newSize) { m_expression.resize(newSize); } + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index,Index)*/ + EIGEN_DEVICE_FUNC void resize(Index rows, Index cols) { m_expression.resize(rows, cols); } + + protected: + NestedExpressionType m_expression; +}; + +/** \class MatrixWrapper + * \ingroup Core_Module + * + * \brief Expression of an array as a mathematical vector or matrix + * + * This class is the return type of ArrayBase::matrix(), and most of the time + * this is the only way it is use. + * + * \sa MatrixBase::matrix(), class ArrayWrapper + */ + +namespace internal { +template +struct traits > : public traits > { + typedef MatrixXpr XprKind; + // Let's remove NestByRefBit + enum { + Flags0 = traits >::Flags, + LvalueBitFlag = is_lvalue::value ? LvalueBit : 0, + Flags = (Flags0 & ~(NestByRefBit | LvalueBit)) | LvalueBitFlag + }; +}; +} // namespace internal + +template +class MatrixWrapper : public MatrixBase > { + public: + typedef MatrixBase > Base; + EIGEN_DENSE_PUBLIC_INTERFACE(MatrixWrapper) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(MatrixWrapper) + typedef internal::remove_all_t NestedExpression; + + typedef std::conditional_t::value, Scalar, const Scalar> + ScalarWithConstIfNotLvalue; + + typedef typename internal::ref_selector::non_const_type NestedExpressionType; + + using Base::coeffRef; + + EIGEN_DEVICE_FUNC explicit inline MatrixWrapper(ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_expression.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_expression.cols(); } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC constexpr ScalarWithConstIfNotLvalue* data() { return m_expression.data(); } + EIGEN_DEVICE_FUNC constexpr const Scalar* data() const { return m_expression.data(); } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index rowId, Index colId) const { + return m_expression.derived().coeffRef(rowId, colId); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index index) const { return m_expression.coeffRef(index); } + + EIGEN_DEVICE_FUNC const internal::remove_all_t& nestedExpression() const { + return m_expression; + } + + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index) */ + EIGEN_DEVICE_FUNC void resize(Index newSize) { m_expression.resize(newSize); } + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index,Index)*/ + EIGEN_DEVICE_FUNC void resize(Index rows, Index cols) { m_expression.resize(rows, cols); } + + protected: + NestedExpressionType m_expression; +}; + +} // end namespace Eigen + +#endif // EIGEN_ARRAYWRAPPER_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Assign.h b/src/3rdparty/eigen/Eigen/src/Core/Assign.h new file mode 100644 index 0000000..4b30f7b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Assign.h @@ -0,0 +1,80 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007 Michael Olbrich +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ASSIGN_H +#define EIGEN_ASSIGN_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::lazyAssign(const DenseBase& other) { + enum { SameType = internal::is_same::value }; + + EIGEN_STATIC_ASSERT_LVALUE(Derived) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Derived, OtherDerived) + EIGEN_STATIC_ASSERT( + SameType, + YOU_MIXED_DIFFERENT_NUMERIC_TYPES__YOU_NEED_TO_USE_THE_CAST_METHOD_OF_MATRIXBASE_TO_CAST_NUMERIC_TYPES_EXPLICITLY) + + eigen_assert(rows() == other.rows() && cols() == other.cols()); + internal::call_assignment_no_alias(derived(), other.derived()); + + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::operator=(const DenseBase& other) { + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::operator=(const DenseBase& other) { + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const MatrixBase& other) { + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const DenseBase& other) { + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const EigenBase& other) { + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::operator=( + const ReturnByValue& other) { + other.derived().evalTo(derived()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/AssignEvaluator.h b/src/3rdparty/eigen/Eigen/src/Core/AssignEvaluator.h new file mode 100644 index 0000000..36f0a9d --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/AssignEvaluator.h @@ -0,0 +1,1057 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011 Benoit Jacob +// Copyright (C) 2011-2014 Gael Guennebaud +// Copyright (C) 2011-2012 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ASSIGN_EVALUATOR_H +#define EIGEN_ASSIGN_EVALUATOR_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +// This implementation is based on Assign.h + +namespace internal { + +/*************************************************************************** + * Part 1 : the logic deciding a strategy for traversal and unrolling * + ***************************************************************************/ + +// copy_using_evaluator_traits is based on assign_traits + +template +struct copy_using_evaluator_traits { + using Src = typename SrcEvaluator::XprType; + using Dst = typename DstEvaluator::XprType; + using DstScalar = typename Dst::Scalar; + + static constexpr int DstFlags = DstEvaluator::Flags; + static constexpr int SrcFlags = SrcEvaluator::Flags; + + public: + static constexpr int DstAlignment = DstEvaluator::Alignment; + static constexpr int SrcAlignment = SrcEvaluator::Alignment; + static constexpr int JointAlignment = plain_enum_min(DstAlignment, SrcAlignment); + static constexpr bool DstHasDirectAccess = bool(DstFlags & DirectAccessBit); + static constexpr bool SrcIsRowMajor = bool(SrcFlags & RowMajorBit); + static constexpr bool DstIsRowMajor = bool(DstFlags & RowMajorBit); + static constexpr bool IsVectorAtCompileTime = Dst::IsVectorAtCompileTime; + static constexpr int RowsAtCompileTime = size_prefer_fixed(Src::RowsAtCompileTime, Dst::RowsAtCompileTime); + static constexpr int ColsAtCompileTime = size_prefer_fixed(Src::ColsAtCompileTime, Dst::ColsAtCompileTime); + static constexpr int SizeAtCompileTime = size_at_compile_time(RowsAtCompileTime, ColsAtCompileTime); + static constexpr int MaxRowsAtCompileTime = + min_size_prefer_fixed(Src::MaxRowsAtCompileTime, Dst::MaxRowsAtCompileTime); + static constexpr int MaxColsAtCompileTime = + min_size_prefer_fixed(Src::MaxColsAtCompileTime, Dst::MaxColsAtCompileTime); + static constexpr int MaxSizeAtCompileTime = + min_size_prefer_fixed(Src::MaxSizeAtCompileTime, Dst::MaxSizeAtCompileTime); + static constexpr int InnerSizeAtCompileTime = IsVectorAtCompileTime ? SizeAtCompileTime + : DstIsRowMajor ? ColsAtCompileTime + : RowsAtCompileTime; + static constexpr int MaxInnerSizeAtCompileTime = IsVectorAtCompileTime ? MaxSizeAtCompileTime + : DstIsRowMajor ? MaxColsAtCompileTime + : MaxRowsAtCompileTime; + static constexpr int RestrictedInnerSize = min_size_prefer_fixed(MaxInnerSizeAtCompileTime, MaxPacketSize); + static constexpr int RestrictedLinearSize = min_size_prefer_fixed(MaxSizeAtCompileTime, MaxPacketSize); + static constexpr int OuterStride = outer_stride_at_compile_time::ret; + + // TODO distinguish between linear traversal and inner-traversals + using LinearPacketType = typename find_best_packet::type; + using InnerPacketType = typename find_best_packet::type; + + static constexpr int LinearPacketSize = unpacket_traits::size; + static constexpr int InnerPacketSize = unpacket_traits::size; + + public: + static constexpr int LinearRequiredAlignment = unpacket_traits::alignment; + static constexpr int InnerRequiredAlignment = unpacket_traits::alignment; + + private: + static constexpr bool StorageOrdersAgree = DstIsRowMajor == SrcIsRowMajor; + static constexpr bool MightVectorize = StorageOrdersAgree && bool(DstFlags & SrcFlags & ActualPacketAccessBit) && + bool(functor_traits::PacketAccess); + static constexpr bool MayInnerVectorize = MightVectorize && (InnerSizeAtCompileTime != Dynamic) && + (InnerSizeAtCompileTime % InnerPacketSize == 0) && + (OuterStride != Dynamic) && (OuterStride % InnerPacketSize == 0) && + (EIGEN_UNALIGNED_VECTORIZE || JointAlignment >= InnerRequiredAlignment); + static constexpr bool MayLinearize = StorageOrdersAgree && (DstFlags & SrcFlags & LinearAccessBit); + static constexpr bool MayLinearVectorize = + MightVectorize && MayLinearize && DstHasDirectAccess && + (EIGEN_UNALIGNED_VECTORIZE || (DstAlignment >= LinearRequiredAlignment) || MaxSizeAtCompileTime == Dynamic) && + (MaxSizeAtCompileTime == Dynamic || MaxSizeAtCompileTime >= LinearPacketSize); + /* If the destination isn't aligned, we have to do runtime checks and we don't unroll, + so it's only good for large enough sizes. */ + static constexpr int InnerSizeThreshold = (EIGEN_UNALIGNED_VECTORIZE ? 1 : 3) * InnerPacketSize; + static constexpr bool MaySliceVectorize = + MightVectorize && DstHasDirectAccess && + (MaxInnerSizeAtCompileTime == Dynamic || MaxInnerSizeAtCompileTime >= InnerSizeThreshold); + /* slice vectorization can be slow, so we only want it if the slices are big, which is + indicated by InnerMaxSize rather than InnerSize, think of the case of a dynamic block + in a fixed-size matrix + However, with EIGEN_UNALIGNED_VECTORIZE and unrolling, slice vectorization is still worth it */ + + public: + static constexpr int Traversal = SizeAtCompileTime == 0 ? AllAtOnceTraversal + : (MayLinearVectorize && (LinearPacketSize > InnerPacketSize)) + ? LinearVectorizedTraversal + : MayInnerVectorize ? InnerVectorizedTraversal + : MayLinearVectorize ? LinearVectorizedTraversal + : MaySliceVectorize ? SliceVectorizedTraversal + : MayLinearize ? LinearTraversal + : DefaultTraversal; + static constexpr bool Vectorized = Traversal == InnerVectorizedTraversal || Traversal == LinearVectorizedTraversal || + Traversal == SliceVectorizedTraversal; + + using PacketType = std::conditional_t; + + private: + static constexpr int ActualPacketSize = Vectorized ? unpacket_traits::size : 1; + static constexpr int UnrollingLimit = EIGEN_UNROLLING_LIMIT * ActualPacketSize; + static constexpr int CoeffReadCost = int(DstEvaluator::CoeffReadCost) + int(SrcEvaluator::CoeffReadCost); + static constexpr bool MayUnrollCompletely = + (SizeAtCompileTime != Dynamic) && (SizeAtCompileTime * CoeffReadCost <= UnrollingLimit); + static constexpr bool MayUnrollInner = + (InnerSizeAtCompileTime != Dynamic) && (InnerSizeAtCompileTime * CoeffReadCost <= UnrollingLimit); + + public: + static constexpr int Unrolling = + (Traversal == InnerVectorizedTraversal || Traversal == DefaultTraversal) + ? (MayUnrollCompletely ? CompleteUnrolling + : MayUnrollInner ? InnerUnrolling + : NoUnrolling) + : Traversal == LinearVectorizedTraversal + ? (MayUnrollCompletely && (EIGEN_UNALIGNED_VECTORIZE || (DstAlignment >= LinearRequiredAlignment)) + ? CompleteUnrolling + : NoUnrolling) + : Traversal == LinearTraversal ? (MayUnrollCompletely ? CompleteUnrolling : NoUnrolling) +#if EIGEN_UNALIGNED_VECTORIZE + : Traversal == SliceVectorizedTraversal ? (MayUnrollInner ? InnerUnrolling : NoUnrolling) +#endif + : NoUnrolling; + static constexpr bool UsePacketSegment = has_packet_segment::value; + +#ifdef EIGEN_DEBUG_ASSIGN + static void debug() { + std::cerr << "DstXpr: " << typeid(typename DstEvaluator::XprType).name() << std::endl; + std::cerr << "SrcXpr: " << typeid(typename SrcEvaluator::XprType).name() << std::endl; + std::cerr.setf(std::ios::hex, std::ios::basefield); + std::cerr << "DstFlags" + << " = " << DstFlags << " (" << demangle_flags(DstFlags) << " )" << std::endl; + std::cerr << "SrcFlags" + << " = " << SrcFlags << " (" << demangle_flags(SrcFlags) << " )" << std::endl; + std::cerr.unsetf(std::ios::hex); + EIGEN_DEBUG_VAR(DstAlignment) + EIGEN_DEBUG_VAR(SrcAlignment) + EIGEN_DEBUG_VAR(LinearRequiredAlignment) + EIGEN_DEBUG_VAR(InnerRequiredAlignment) + EIGEN_DEBUG_VAR(JointAlignment) + EIGEN_DEBUG_VAR(InnerSizeAtCompileTime) + EIGEN_DEBUG_VAR(MaxInnerSizeAtCompileTime) + EIGEN_DEBUG_VAR(LinearPacketSize) + EIGEN_DEBUG_VAR(InnerPacketSize) + EIGEN_DEBUG_VAR(ActualPacketSize) + EIGEN_DEBUG_VAR(StorageOrdersAgree) + EIGEN_DEBUG_VAR(MightVectorize) + EIGEN_DEBUG_VAR(MayLinearize) + EIGEN_DEBUG_VAR(MayInnerVectorize) + EIGEN_DEBUG_VAR(MayLinearVectorize) + EIGEN_DEBUG_VAR(MaySliceVectorize) + std::cerr << "Traversal" + << " = " << Traversal << " (" << demangle_traversal(Traversal) << ")" << std::endl; + EIGEN_DEBUG_VAR(SrcEvaluator::CoeffReadCost) + EIGEN_DEBUG_VAR(DstEvaluator::CoeffReadCost) + EIGEN_DEBUG_VAR(Dst::SizeAtCompileTime) + EIGEN_DEBUG_VAR(UnrollingLimit) + EIGEN_DEBUG_VAR(MayUnrollCompletely) + EIGEN_DEBUG_VAR(MayUnrollInner) + std::cerr << "Unrolling" + << " = " << Unrolling << " (" << demangle_unrolling(Unrolling) << ")" << std::endl; + std::cerr << std::endl; + } +#endif +}; + +/*************************************************************************** + * Part 2 : meta-unrollers + ***************************************************************************/ + +/************************ +*** Default traversal *** +************************/ + +template +struct copy_using_evaluator_DefaultTraversal_CompleteUnrolling { + static constexpr int Outer = Index_ / Kernel::AssignmentTraits::InnerSizeAtCompileTime; + static constexpr int Inner = Index_ % Kernel::AssignmentTraits::InnerSizeAtCompileTime; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + kernel.assignCoeffByOuterInner(Outer, Inner); + copy_using_evaluator_DefaultTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_DefaultTraversal_CompleteUnrolling { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&) {} +}; + +template +struct copy_using_evaluator_DefaultTraversal_InnerUnrolling { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel, Index outer) { + kernel.assignCoeffByOuterInner(outer, Index_); + copy_using_evaluator_DefaultTraversal_InnerUnrolling::run(kernel, outer); + } +}; + +template +struct copy_using_evaluator_DefaultTraversal_InnerUnrolling { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&, Index) {} +}; + +/*********************** +*** Linear traversal *** +***********************/ + +template +struct copy_using_evaluator_LinearTraversal_CompleteUnrolling { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + kernel.assignCoeff(Index_); + copy_using_evaluator_LinearTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_LinearTraversal_CompleteUnrolling { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&) {} +}; + +/************************** +*** Inner vectorization *** +**************************/ + +template +struct copy_using_evaluator_innervec_CompleteUnrolling { + using PacketType = typename Kernel::PacketType; + static constexpr int Outer = Index_ / Kernel::AssignmentTraits::InnerSizeAtCompileTime; + static constexpr int Inner = Index_ % Kernel::AssignmentTraits::InnerSizeAtCompileTime; + static constexpr int NextIndex = Index_ + unpacket_traits::size; + static constexpr int SrcAlignment = Kernel::AssignmentTraits::SrcAlignment; + static constexpr int DstAlignment = Kernel::AssignmentTraits::DstAlignment; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel) { + kernel.template assignPacketByOuterInner(Outer, Inner); + copy_using_evaluator_innervec_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_innervec_CompleteUnrolling { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&) {} +}; + +template +struct copy_using_evaluator_innervec_InnerUnrolling { + using PacketType = typename Kernel::PacketType; + static constexpr int NextIndex = Index_ + unpacket_traits::size; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel, Index outer) { + kernel.template assignPacketByOuterInner(outer, Index_); + copy_using_evaluator_innervec_InnerUnrolling::run(kernel, + outer); + } +}; + +template +struct copy_using_evaluator_innervec_InnerUnrolling { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&, Index) {} +}; + +template +struct copy_using_evaluator_innervec_segment { + using PacketType = typename Kernel::PacketType; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel, Index outer) { + kernel.template assignPacketSegmentByOuterInner(outer, Start, 0, + Stop - Start); + } +}; + +template +struct copy_using_evaluator_innervec_segment + : copy_using_evaluator_DefaultTraversal_InnerUnrolling {}; + +template +struct copy_using_evaluator_innervec_segment { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&, Index) {} +}; + +template +struct copy_using_evaluator_innervec_segment { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&, Index) {} +}; + +/*************************************************************************** + * Part 3 : implementation of all cases + ***************************************************************************/ + +// dense_assignment_loop is based on assign_impl + +template +struct dense_assignment_loop_impl; + +template +struct dense_assignment_loop { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { +#ifdef __cpp_lib_is_constant_evaluated + if (internal::is_constant_evaluated()) + dense_assignment_loop_impl::run(kernel); + else +#endif + dense_assignment_loop_impl::run(kernel); + } +}; + +/************************ +***** Special Cases ***** +************************/ + +// Zero-sized assignment is a no-op. +template +struct dense_assignment_loop_impl { + static constexpr int SizeAtCompileTime = Kernel::AssignmentTraits::SizeAtCompileTime; + + EIGEN_DEVICE_FUNC static void EIGEN_STRONG_INLINE constexpr run(Kernel& /*kernel*/) { + EIGEN_STATIC_ASSERT(SizeAtCompileTime == 0, EIGEN_INTERNAL_ERROR_PLEASE_FILE_A_BUG_REPORT) + } +}; + +/************************ +*** Default traversal *** +************************/ + +template +struct dense_assignment_loop_impl { + EIGEN_DEVICE_FUNC static void EIGEN_STRONG_INLINE constexpr run(Kernel& kernel) { + for (Index outer = 0; outer < kernel.outerSize(); ++outer) { + for (Index inner = 0; inner < kernel.innerSize(); ++inner) { + kernel.assignCoeffByOuterInner(outer, inner); + } + } + } +}; + +template +struct dense_assignment_loop_impl { + static constexpr int SizeAtCompileTime = Kernel::AssignmentTraits::SizeAtCompileTime; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + copy_using_evaluator_DefaultTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct dense_assignment_loop_impl { + static constexpr int InnerSizeAtCompileTime = Kernel::AssignmentTraits::InnerSizeAtCompileTime; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + const Index outerSize = kernel.outerSize(); + for (Index outer = 0; outer < outerSize; ++outer) + copy_using_evaluator_DefaultTraversal_InnerUnrolling::run(kernel, outer); + } +}; + +/*************************** +*** Linear vectorization *** +***************************/ + +// The goal of unaligned_dense_assignment_loop is simply to factorize the handling +// of the non vectorizable beginning and ending parts + +template +struct unaligned_dense_assignment_loop { + // if Skip == true, then do nothing + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& /*kernel*/, Index /*start*/, Index /*end*/) {} + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& /*kernel*/, Index /*outer*/, + Index /*innerStart*/, Index /*innerEnd*/) {} +}; + +template +struct unaligned_dense_assignment_loop { + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel, Index start, Index end) { + Index count = end - start; + eigen_assert(count <= unpacket_traits::size); + if (count > 0) kernel.template assignPacketSegment(start, 0, count); + } + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel, Index outer, Index start, Index end) { + Index count = end - start; + eigen_assert(count <= unpacket_traits::size); + if (count > 0) + kernel.template assignPacketSegmentByOuterInner(outer, start, 0, count); + } +}; + +template +struct unaligned_dense_assignment_loop { + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel, Index start, Index end) { + for (Index index = start; index < end; ++index) kernel.assignCoeff(index); + } + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel, Index outer, Index innerStart, + Index innerEnd) { + for (Index inner = innerStart; inner < innerEnd; ++inner) kernel.assignCoeffByOuterInner(outer, inner); + } +}; + +template +struct copy_using_evaluator_linearvec_CompleteUnrolling { + using PacketType = typename Kernel::PacketType; + static constexpr int SrcAlignment = Kernel::AssignmentTraits::SrcAlignment; + static constexpr int DstAlignment = Kernel::AssignmentTraits::DstAlignment; + static constexpr int NextIndex = Index_ + unpacket_traits::size; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel) { + kernel.template assignPacket(Index_); + copy_using_evaluator_linearvec_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_linearvec_CompleteUnrolling { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&) {} +}; + +template +struct copy_using_evaluator_linearvec_segment { + using PacketType = typename Kernel::PacketType; + static constexpr int SrcAlignment = Kernel::AssignmentTraits::SrcAlignment; + static constexpr int DstAlignment = Kernel::AssignmentTraits::DstAlignment; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel) { + kernel.template assignPacketSegment(Index_, 0, Stop - Index_); + } +}; + +template +struct copy_using_evaluator_linearvec_segment + : copy_using_evaluator_LinearTraversal_CompleteUnrolling {}; + +template +struct copy_using_evaluator_linearvec_segment { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&) {} +}; + +template +struct copy_using_evaluator_linearvec_segment { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel&) {} +}; + +template +struct dense_assignment_loop_impl { + using Scalar = typename Kernel::Scalar; + using PacketType = typename Kernel::PacketType; + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int SrcAlignment = Kernel::AssignmentTraits::JointAlignment; + static constexpr int DstAlignment = plain_enum_max(Kernel::AssignmentTraits::DstAlignment, alignof(Scalar)); + static constexpr int RequestedAlignment = unpacket_traits::alignment; + static constexpr bool Alignable = + (DstAlignment >= RequestedAlignment) || ((RequestedAlignment - DstAlignment) % sizeof(Scalar) == 0); + static constexpr int Alignment = Alignable ? RequestedAlignment : DstAlignment; + static constexpr bool DstIsAligned = DstAlignment >= Alignment; + static constexpr bool UsePacketSegment = Kernel::AssignmentTraits::UsePacketSegment; + + using head_loop = + unaligned_dense_assignment_loop; + using tail_loop = unaligned_dense_assignment_loop; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + const Index size = kernel.size(); + const Index alignedStart = DstIsAligned ? 0 : first_aligned(kernel.dstDataPtr(), size); + const Index alignedEnd = alignedStart + numext::round_down(size - alignedStart, PacketSize); + + head_loop::run(kernel, 0, alignedStart); + + for (Index index = alignedStart; index < alignedEnd; index += PacketSize) + kernel.template assignPacket(index); + + tail_loop::run(kernel, alignedEnd, size); + } +}; + +template +struct dense_assignment_loop_impl { + using PacketType = typename Kernel::PacketType; + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int Size = Kernel::AssignmentTraits::SizeAtCompileTime; + static constexpr int AlignedSize = numext::round_down(Size, PacketSize); + static constexpr bool UsePacketSegment = Kernel::AssignmentTraits::UsePacketSegment; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + copy_using_evaluator_linearvec_CompleteUnrolling::run(kernel); + copy_using_evaluator_linearvec_segment::run(kernel); + } +}; + +/************************** +*** Inner vectorization *** +**************************/ + +template +struct dense_assignment_loop_impl { + using PacketType = typename Kernel::PacketType; + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int SrcAlignment = Kernel::AssignmentTraits::JointAlignment; + static constexpr int DstAlignment = Kernel::AssignmentTraits::DstAlignment; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + const Index innerSize = kernel.innerSize(); + const Index outerSize = kernel.outerSize(); + for (Index outer = 0; outer < outerSize; ++outer) + for (Index inner = 0; inner < innerSize; inner += PacketSize) + kernel.template assignPacketByOuterInner(outer, inner); + } +}; + +template +struct dense_assignment_loop_impl { + static constexpr int SizeAtCompileTime = Kernel::AssignmentTraits::SizeAtCompileTime; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel) { + copy_using_evaluator_innervec_CompleteUnrolling::run(kernel); + } +}; + +template +struct dense_assignment_loop_impl { + static constexpr int InnerSize = Kernel::AssignmentTraits::InnerSizeAtCompileTime; + static constexpr int SrcAlignment = Kernel::AssignmentTraits::SrcAlignment; + static constexpr int DstAlignment = Kernel::AssignmentTraits::DstAlignment; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel) { + const Index outerSize = kernel.outerSize(); + for (Index outer = 0; outer < outerSize; ++outer) + copy_using_evaluator_innervec_InnerUnrolling::run(kernel, + outer); + } +}; + +/*********************** +*** Linear traversal *** +***********************/ + +template +struct dense_assignment_loop_impl { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + const Index size = kernel.size(); + for (Index i = 0; i < size; ++i) kernel.assignCoeff(i); + } +}; + +template +struct dense_assignment_loop_impl { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + copy_using_evaluator_LinearTraversal_CompleteUnrolling::run( + kernel); + } +}; + +/************************** +*** Slice vectorization *** +***************************/ + +template +struct dense_assignment_loop_impl { + using Scalar = typename Kernel::Scalar; + using PacketType = typename Kernel::PacketType; + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int SrcAlignment = Kernel::AssignmentTraits::JointAlignment; + static constexpr int DstAlignment = plain_enum_max(Kernel::AssignmentTraits::DstAlignment, alignof(Scalar)); + static constexpr int RequestedAlignment = unpacket_traits::alignment; + static constexpr bool Alignable = + (DstAlignment >= RequestedAlignment) || ((RequestedAlignment - DstAlignment) % sizeof(Scalar) == 0); + static constexpr int Alignment = Alignable ? RequestedAlignment : DstAlignment; + static constexpr bool DstIsAligned = DstAlignment >= Alignment; + static constexpr bool UsePacketSegment = Kernel::AssignmentTraits::UsePacketSegment; + + using head_loop = unaligned_dense_assignment_loop; + using tail_loop = unaligned_dense_assignment_loop; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + const Scalar* dst_ptr = kernel.dstDataPtr(); + const Index innerSize = kernel.innerSize(); + const Index outerSize = kernel.outerSize(); + const Index alignedStep = Alignable ? (PacketSize - kernel.outerStride() % PacketSize) % PacketSize : 0; + Index alignedStart = ((!Alignable) || DstIsAligned) ? 0 : internal::first_aligned(dst_ptr, innerSize); + + for (Index outer = 0; outer < outerSize; ++outer) { + const Index alignedEnd = alignedStart + numext::round_down(innerSize - alignedStart, PacketSize); + + head_loop::run(kernel, outer, 0, alignedStart); + + // do the vectorizable part of the assignment + for (Index inner = alignedStart; inner < alignedEnd; inner += PacketSize) + kernel.template assignPacketByOuterInner(outer, inner); + + tail_loop::run(kernel, outer, alignedEnd, innerSize); + + alignedStart = numext::mini((alignedStart + alignedStep) % PacketSize, innerSize); + } + } +}; + +#if EIGEN_UNALIGNED_VECTORIZE +template +struct dense_assignment_loop_impl { + using PacketType = typename Kernel::PacketType; + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int InnerSize = Kernel::AssignmentTraits::InnerSizeAtCompileTime; + static constexpr int VectorizableSize = numext::round_down(InnerSize, PacketSize); + static constexpr bool UsePacketSegment = Kernel::AssignmentTraits::UsePacketSegment; + + using packet_loop = copy_using_evaluator_innervec_InnerUnrolling; + using packet_segment_loop = copy_using_evaluator_innervec_segment; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel) { + for (Index outer = 0; outer < kernel.outerSize(); ++outer) { + packet_loop::run(kernel, outer); + packet_segment_loop::run(kernel, outer); + } + } +}; +#endif + +/*************************************************************************** + * Part 4 : Generic dense assignment kernel + ***************************************************************************/ + +// This class generalize the assignment of a coefficient (or packet) from one dense evaluator +// to another dense writable evaluator. +// It is parametrized by the two evaluators, and the actual assignment functor. +// This abstraction level permits to keep the evaluation loops as simple and as generic as possible. +// One can customize the assignment using this generic dense_assignment_kernel with different +// functors, or by completely overloading it, by-passing a functor. +template +class generic_dense_assignment_kernel { + protected: + typedef typename DstEvaluatorTypeT::XprType DstXprType; + typedef typename SrcEvaluatorTypeT::XprType SrcXprType; + + public: + typedef DstEvaluatorTypeT DstEvaluatorType; + typedef SrcEvaluatorTypeT SrcEvaluatorType; + typedef typename DstEvaluatorType::Scalar Scalar; + typedef copy_using_evaluator_traits AssignmentTraits; + typedef typename AssignmentTraits::PacketType PacketType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr generic_dense_assignment_kernel(DstEvaluatorType& dst, + const SrcEvaluatorType& src, + const Functor& func, + DstXprType& dstExpr) + : m_dst(dst), m_src(src), m_functor(func), m_dstExpr(dstExpr) { +#ifdef EIGEN_DEBUG_ASSIGN + AssignmentTraits::debug(); +#endif + } + + EIGEN_DEVICE_FUNC constexpr Index size() const noexcept { return m_dstExpr.size(); } + EIGEN_DEVICE_FUNC constexpr Index innerSize() const noexcept { return m_dstExpr.innerSize(); } + EIGEN_DEVICE_FUNC constexpr Index outerSize() const noexcept { return m_dstExpr.outerSize(); } + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_dstExpr.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_dstExpr.cols(); } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return m_dstExpr.outerStride(); } + + EIGEN_DEVICE_FUNC DstEvaluatorType& dstEvaluator() noexcept { return m_dst; } + EIGEN_DEVICE_FUNC const SrcEvaluatorType& srcEvaluator() const noexcept { return m_src; } + + /// Assign src(row,col) to dst(row,col) through the assignment functor. + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void assignCoeff(Index row, Index col) { + m_functor.assignCoeff(m_dst.coeffRef(row, col), m_src.coeff(row, col)); + } + + /// \sa assignCoeff(Index,Index) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignCoeff(Index index) { + m_functor.assignCoeff(m_dst.coeffRef(index), m_src.coeff(index)); + } + + /// \sa assignCoeff(Index,Index) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void assignCoeffByOuterInner(Index outer, Index inner) { + Index row = rowIndexByOuterInner(outer, inner); + Index col = colIndexByOuterInner(outer, inner); + assignCoeff(row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacket(Index row, Index col) { + m_functor.template assignPacket(&m_dst.coeffRef(row, col), + m_src.template packet(row, col)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacket(Index index) { + m_functor.template assignPacket(&m_dst.coeffRef(index), m_src.template packet(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacketByOuterInner(Index outer, Index inner) { + Index row = rowIndexByOuterInner(outer, inner); + Index col = colIndexByOuterInner(outer, inner); + assignPacket(row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacketSegment(Index row, Index col, Index begin, Index count) { + m_functor.template assignPacketSegment( + &m_dst.coeffRef(row, col), m_src.template packetSegment(row, col, begin, count), begin, + count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacketSegment(Index index, Index begin, Index count) { + m_functor.template assignPacketSegment( + &m_dst.coeffRef(index), m_src.template packetSegment(index, begin, count), begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacketSegmentByOuterInner(Index outer, Index inner, Index begin, + Index count) { + Index row = rowIndexByOuterInner(outer, inner); + Index col = colIndexByOuterInner(outer, inner); + assignPacketSegment(row, col, begin, count); + } + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr Index rowIndexByOuterInner(Index outer, Index inner) { + typedef typename DstEvaluatorType::ExpressionTraits Traits; + return int(Traits::RowsAtCompileTime) == 1 ? 0 + : int(Traits::ColsAtCompileTime) == 1 ? inner + : int(DstEvaluatorType::Flags) & RowMajorBit ? outer + : inner; + } + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr Index colIndexByOuterInner(Index outer, Index inner) { + typedef typename DstEvaluatorType::ExpressionTraits Traits; + return int(Traits::ColsAtCompileTime) == 1 ? 0 + : int(Traits::RowsAtCompileTime) == 1 ? inner + : int(DstEvaluatorType::Flags) & RowMajorBit ? inner + : outer; + } + + EIGEN_DEVICE_FUNC const Scalar* dstDataPtr() const { return m_dstExpr.data(); } + + protected: + DstEvaluatorType& m_dst; + const SrcEvaluatorType& m_src; + const Functor& m_functor; + // TODO find a way to avoid the needs of the original expression + DstXprType& m_dstExpr; +}; + +// Special kernel used when computing small products whose operands have dynamic dimensions. It ensures that the +// PacketSize used is no larger than 4, thereby increasing the chance that vectorized instructions will be used +// when computing the product. + +template +class restricted_packet_dense_assignment_kernel + : public generic_dense_assignment_kernel { + protected: + typedef generic_dense_assignment_kernel Base; + + public: + typedef typename Base::Scalar Scalar; + typedef typename Base::DstXprType DstXprType; + typedef copy_using_evaluator_traits AssignmentTraits; + typedef typename AssignmentTraits::PacketType PacketType; + + EIGEN_DEVICE_FUNC restricted_packet_dense_assignment_kernel(DstEvaluatorTypeT& dst, const SrcEvaluatorTypeT& src, + const Functor& func, DstXprType& dstExpr) + : Base(dst, src, func, dstExpr) {} +}; + +/*************************************************************************** + * Part 5 : Entry point for dense rectangular assignment + ***************************************************************************/ + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize_if_allowed(DstXprType& dst, const SrcXprType& src, + const Functor& /*func*/) { + EIGEN_ONLY_USED_FOR_DEBUG(dst); + EIGEN_ONLY_USED_FOR_DEBUG(src); + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize_if_allowed(DstXprType& dst, const SrcXprType& src, + const internal::assign_op& /*func*/) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if (((dst.rows() != dstRows) || (dst.cols() != dstCols))) dst.resize(dstRows, dstCols); + eigen_assert(dst.rows() == dstRows && dst.cols() == dstCols); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_dense_assignment_loop(DstXprType& dst, const SrcXprType& src, + const Functor& func) { + typedef evaluator DstEvaluatorType; + typedef evaluator SrcEvaluatorType; + + SrcEvaluatorType srcEvaluator(src); + + // NOTE To properly handle A = (A*A.transpose())/s with A rectangular, + // we need to resize the destination after the source evaluator has been created. + resize_if_allowed(dst, src, func); + + DstEvaluatorType dstEvaluator(dst); + + typedef generic_dense_assignment_kernel Kernel; + Kernel kernel(dstEvaluator, srcEvaluator, func, dst.const_cast_derived()); + + dense_assignment_loop::run(kernel); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_dense_assignment_loop(DstXprType& dst, const SrcXprType& src) { + call_dense_assignment_loop(dst, src, internal::assign_op()); +} + +/*************************************************************************** + * Part 6 : Generic assignment + ***************************************************************************/ + +// Based on the respective shapes of the destination and source, +// the class AssignmentKind determine the kind of assignment mechanism. +// AssignmentKind must define a Kind typedef. +template +struct AssignmentKind; + +// Assignment kind defined in this file: +struct Dense2Dense {}; +struct EigenBase2EigenBase {}; + +template +struct AssignmentKind { + typedef EigenBase2EigenBase Kind; +}; +template <> +struct AssignmentKind { + typedef Dense2Dense Kind; +}; + +// This is the main assignment class +template ::Shape, + typename evaluator_traits::Shape>::Kind, + typename EnableIf = void> +struct Assignment; + +// The only purpose of this call_assignment() function is to deal with noalias() / "assume-aliasing" and automatic +// transposition. Indeed, I (Gael) think that this concept of "assume-aliasing" was a mistake, and it makes thing quite +// complicated. So this intermediate function removes everything related to "assume-aliasing" such that Assignment does +// not has to bother about these annoying details. + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment(Dst& dst, const Src& src) { + call_assignment(dst, src, internal::assign_op()); +} +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_assignment(const Dst& dst, const Src& src) { + call_assignment(dst, src, internal::assign_op()); +} + +// Deal with "assume-aliasing" +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment( + Dst& dst, const Src& src, const Func& func, std::enable_if_t::value, void*> = 0) { + typename plain_matrix_type::type tmp(src); + call_assignment_no_alias(dst, tmp, func); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment( + Dst& dst, const Src& src, const Func& func, std::enable_if_t::value, void*> = 0) { + call_assignment_no_alias(dst, src, func); +} + +// by-pass "assume-aliasing" +// When there is no aliasing, we require that 'dst' has been properly resized +template class StorageBase, typename Src, typename Func> +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment(NoAlias& dst, const Src& src, + const Func& func) { + call_assignment_no_alias(dst.expression(), src, func); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment_no_alias(Dst& dst, const Src& src, + const Func& func) { + enum { + NeedToTranspose = ((int(Dst::RowsAtCompileTime) == 1 && int(Src::ColsAtCompileTime) == 1) || + (int(Dst::ColsAtCompileTime) == 1 && int(Src::RowsAtCompileTime) == 1)) && + int(Dst::SizeAtCompileTime) != 1 + }; + + typedef std::conditional_t, Dst> ActualDstTypeCleaned; + typedef std::conditional_t, Dst&> ActualDstType; + ActualDstType actualDst(dst); + + // TODO check whether this is the right place to perform these checks: + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(ActualDstTypeCleaned, Src) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func, typename ActualDstTypeCleaned::Scalar, typename Src::Scalar); + + Assignment::run(actualDst, src, func); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_restricted_packet_assignment_no_alias(Dst& dst, const Src& src, + const Func& func) { + typedef evaluator DstEvaluatorType; + typedef evaluator SrcEvaluatorType; + typedef restricted_packet_dense_assignment_kernel Kernel; + + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func, typename Dst::Scalar, typename Src::Scalar); + + SrcEvaluatorType srcEvaluator(src); + resize_if_allowed(dst, src, func); + + DstEvaluatorType dstEvaluator(dst); + Kernel kernel(dstEvaluator, srcEvaluator, func, dst.const_cast_derived()); + + dense_assignment_loop::run(kernel); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment_no_alias(Dst& dst, const Src& src) { + call_assignment_no_alias(dst, src, internal::assign_op()); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment_no_alias_no_transpose(Dst& dst, const Src& src, + const Func& func) { + // TODO check whether this is the right place to perform these checks: + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Dst, Src) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func, typename Dst::Scalar, typename Src::Scalar); + + Assignment::run(dst, src, func); +} +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment_no_alias_no_transpose(Dst& dst, const Src& src) { + call_assignment_no_alias_no_transpose(dst, src, internal::assign_op()); +} + +// forward declaration +template +EIGEN_DEVICE_FUNC void check_for_aliasing(const Dst& dst, const Src& src); + +// Generic Dense to Dense assignment +// Note that the last template argument "Weak" is needed to make it possible to perform +// both partial specialization+SFINAE without ambiguous specialization +template +struct Assignment { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE constexpr void run(DstXprType& dst, const SrcXprType& src, + const Functor& func) { +#ifndef EIGEN_NO_DEBUG + if (!internal::is_constant_evaluated()) { + internal::check_for_aliasing(dst, src); + } +#endif + + call_dense_assignment_loop(dst, src, func); + } +}; + +template +struct Assignment, SrcPlainObject>, + assign_op, Dense2Dense, Weak> { + using Scalar = typename DstXprType::Scalar; + using NullaryOp = scalar_constant_op; + using SrcXprType = CwiseNullaryOp; + using Functor = assign_op; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, + const Functor& /*func*/) { + eigen_fill_impl::run(dst, src); + } +}; + +template +struct Assignment, SrcPlainObject>, + assign_op, Dense2Dense, Weak> { + using Scalar = typename DstXprType::Scalar; + using NullaryOp = scalar_zero_op; + using SrcXprType = CwiseNullaryOp; + using Functor = assign_op; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, + const Functor& /*func*/) { + eigen_zero_impl::run(dst, src); + } +}; + +// Generic assignment through evalTo. +// TODO: not sure we have to keep that one, but it helps porting current code to new evaluator mechanism. +// Note that the last template argument "Weak" is needed to make it possible to perform +// both partial specialization+SFINAE without ambiguous specialization +template +struct Assignment { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run( + DstXprType& dst, const SrcXprType& src, + const internal::assign_op& /*func*/) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.evalTo(dst); + } + + // NOTE The following two functions are templated to avoid their instantiation if not needed + // This is needed because some expressions supports evalTo only and/or have 'void' as scalar type. + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run( + DstXprType& dst, const SrcXprType& src, + const internal::add_assign_op& /*func*/) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.addTo(dst); + } + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run( + DstXprType& dst, const SrcXprType& src, + const internal::sub_assign_op& /*func*/) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.subTo(dst); + } +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_EVALUATOR_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Assign_MKL.h b/src/3rdparty/eigen/Eigen/src/Core/Assign_MKL.h new file mode 100644 index 0000000..7636445 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Assign_MKL.h @@ -0,0 +1,183 @@ +/* + Copyright (c) 2011, Intel Corporation. All rights reserved. + Copyright (C) 2015 Gael Guennebaud + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Intel Corporation nor the names of its contributors may + be used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + ******************************************************************************** + * Content : Eigen bindings to Intel(R) MKL + * MKL VML support for coefficient-wise unary Eigen expressions like a=b.sin() + ******************************************************************************** +*/ + +#ifndef EIGEN_ASSIGN_VML_H +#define EIGEN_ASSIGN_VML_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +class vml_assign_traits { + private: + enum { + DstHasDirectAccess = Dst::Flags & DirectAccessBit, + SrcHasDirectAccess = Src::Flags & DirectAccessBit, + StorageOrdersAgree = (int(Dst::IsRowMajor) == int(Src::IsRowMajor)), + InnerSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::SizeAtCompileTime) + : int(Dst::Flags) & RowMajorBit ? int(Dst::ColsAtCompileTime) + : int(Dst::RowsAtCompileTime), + InnerMaxSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::MaxSizeAtCompileTime) + : int(Dst::Flags) & RowMajorBit ? int(Dst::MaxColsAtCompileTime) + : int(Dst::MaxRowsAtCompileTime), + MaxSizeAtCompileTime = Dst::SizeAtCompileTime, + + MightEnableVml = bool(StorageOrdersAgree) && bool(DstHasDirectAccess) && bool(SrcHasDirectAccess) && + Src::InnerStrideAtCompileTime == 1 && Dst::InnerStrideAtCompileTime == 1, + MightLinearize = bool(MightEnableVml) && (int(Dst::Flags) & int(Src::Flags) & LinearAccessBit), + VmlSize = bool(MightLinearize) ? MaxSizeAtCompileTime : InnerMaxSize, + LargeEnough = (VmlSize == Dynamic) || VmlSize >= EIGEN_MKL_VML_THRESHOLD + }; + + public: + enum { EnableVml = MightEnableVml && LargeEnough, Traversal = MightLinearize ? LinearTraversal : DefaultTraversal }; +}; + +#define EIGEN_PP_EXPAND(ARG) ARG +#if !defined(EIGEN_FAST_MATH) || (EIGEN_FAST_MATH != 1) +#define EIGEN_VMLMODE_EXPAND_xLA , VML_HA +#else +#define EIGEN_VMLMODE_EXPAND_xLA , VML_LA +#endif + +#define EIGEN_VMLMODE_EXPAND_x_ + +#define EIGEN_VMLMODE_PREFIX_xLA vm +#define EIGEN_VMLMODE_PREFIX_x_ v +#define EIGEN_VMLMODE_PREFIX(VMLMODE) EIGEN_CAT(EIGEN_VMLMODE_PREFIX_x, VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, VMLOP, EIGENTYPE, VMLTYPE, VMLMODE) \ + template \ + struct Assignment, SrcXprNested>, \ + assign_op, Dense2Dense, \ + std::enable_if_t::EnableVml>> { \ + typedef CwiseUnaryOp, SrcXprNested> SrcXprType; \ + static void run(DstXprType &dst, const SrcXprType &src, const assign_op &func) { \ + resize_if_allowed(dst, src, func); \ + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); \ + if (vml_assign_traits::Traversal == (int)LinearTraversal) { \ + VMLOP(dst.size(), (const VMLTYPE *)src.nestedExpression().data(), \ + (VMLTYPE *)dst.data() EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE)); \ + } else { \ + const Index outerSize = dst.outerSize(); \ + for (Index outer = 0; outer < outerSize; ++outer) { \ + const EIGENTYPE *src_ptr = src.IsRowMajor ? &(src.nestedExpression().coeffRef(outer, 0)) \ + : &(src.nestedExpression().coeffRef(0, outer)); \ + EIGENTYPE *dst_ptr = dst.IsRowMajor ? &(dst.coeffRef(outer, 0)) : &(dst.coeffRef(0, outer)); \ + VMLOP(dst.innerSize(), (const VMLTYPE *)src_ptr, \ + (VMLTYPE *)dst_ptr EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE)); \ + } \ + } \ + } \ + }; + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE), s##VMLOP), float, float, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE), d##VMLOP), double, double, VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE), c##VMLOP), scomplex, \ + MKL_Complex8, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE), z##VMLOP), dcomplex, \ + MKL_Complex16, VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(EIGENOP, VMLOP, VMLMODE) + +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sin, Sin, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(asin, Asin, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sinh, Sinh, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(cos, Cos, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(acos, Acos, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(cosh, Cosh, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(tan, Tan, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(atan, Atan, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(tanh, Tanh, LA) +// EIGEN_MKL_VML_DECLARE_UNARY_CALLS(abs, Abs, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(exp, Exp, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(log, Ln, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(log10, Log10, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sqrt, Sqrt, _) + +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(square, Sqr, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(arg, Arg, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(round, Round, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(floor, Floor, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(ceil, Ceil, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(cbrt, Cbrt, _) + +#define EIGEN_MKL_VML_DECLARE_POW_CALL(EIGENOP, VMLOP, EIGENTYPE, VMLTYPE, VMLMODE) \ + template \ + struct Assignment, SrcXprNested, \ + const CwiseNullaryOp, Plain>>, \ + assign_op, Dense2Dense, \ + std::enable_if_t::EnableVml>> { \ + typedef CwiseBinaryOp, SrcXprNested, \ + const CwiseNullaryOp, Plain>> \ + SrcXprType; \ + static void run(DstXprType &dst, const SrcXprType &src, const assign_op &func) { \ + resize_if_allowed(dst, src, func); \ + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); \ + VMLTYPE exponent = reinterpret_cast(src.rhs().functor().m_other); \ + if (vml_assign_traits::Traversal == LinearTraversal) { \ + VMLOP(dst.size(), (const VMLTYPE *)src.lhs().data(), exponent, \ + (VMLTYPE *)dst.data() EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE)); \ + } else { \ + const Index outerSize = dst.outerSize(); \ + for (Index outer = 0; outer < outerSize; ++outer) { \ + const EIGENTYPE *src_ptr = \ + src.IsRowMajor ? &(src.lhs().coeffRef(outer, 0)) : &(src.lhs().coeffRef(0, outer)); \ + EIGENTYPE *dst_ptr = dst.IsRowMajor ? &(dst.coeffRef(outer, 0)) : &(dst.coeffRef(0, outer)); \ + VMLOP(dst.innerSize(), (const VMLTYPE *)src_ptr, exponent, \ + (VMLTYPE *)dst_ptr EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE)); \ + } \ + } \ + } \ + }; + +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmsPowx, float, float, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmdPowx, double, double, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmcPowx, scomplex, MKL_Complex8, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmzPowx, dcomplex, MKL_Complex16, LA) + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_VML_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/BandMatrix.h b/src/3rdparty/eigen/Eigen/src/Core/BandMatrix.h new file mode 100644 index 0000000..57b0322 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/BandMatrix.h @@ -0,0 +1,338 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_BANDMATRIX_H +#define EIGEN_BANDMATRIX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +class BandMatrixBase : public EigenBase { + public: + enum { + Flags = internal::traits::Flags, + CoeffReadCost = internal::traits::CoeffReadCost, + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + MaxRowsAtCompileTime = internal::traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = internal::traits::MaxColsAtCompileTime, + Supers = internal::traits::Supers, + Subs = internal::traits::Subs, + Options = internal::traits::Options + }; + typedef typename internal::traits::Scalar Scalar; + typedef Matrix DenseMatrixType; + typedef typename DenseMatrixType::StorageIndex StorageIndex; + typedef typename internal::traits::CoefficientsType CoefficientsType; + typedef EigenBase Base; + + protected: + enum { + DataRowsAtCompileTime = ((Supers != Dynamic) && (Subs != Dynamic)) ? 1 + Supers + Subs : Dynamic, + SizeAtCompileTime = min_size_prefer_dynamic(RowsAtCompileTime, ColsAtCompileTime) + }; + + public: + using Base::cols; + using Base::derived; + using Base::rows; + + /** \returns the number of super diagonals */ + inline Index supers() const { return derived().supers(); } + + /** \returns the number of sub diagonals */ + inline Index subs() const { return derived().subs(); } + + /** \returns an expression of the underlying coefficient matrix */ + inline const CoefficientsType& coeffs() const { return derived().coeffs(); } + + /** \returns an expression of the underlying coefficient matrix */ + inline CoefficientsType& coeffs() { return derived().coeffs(); } + + /** \returns a vector expression of the \a i -th column, + * only the meaningful part is returned. + * \warning the internal storage must be column major. */ + inline Block col(Index i) { + EIGEN_STATIC_ASSERT((int(Options) & int(RowMajor)) == 0, THIS_METHOD_IS_ONLY_FOR_COLUMN_MAJOR_MATRICES); + Index start = 0; + Index len = coeffs().rows(); + if (i <= supers()) { + start = supers() - i; + len = (std::min)(rows(), std::max(0, coeffs().rows() - (supers() - i))); + } else if (i >= rows() - subs()) + len = std::max(0, coeffs().rows() - (i + 1 - rows() + subs())); + return Block(coeffs(), start, i, len, 1); + } + + /** \returns a vector expression of the main diagonal */ + inline Block diagonal() { + return Block(coeffs(), supers(), 0, 1, (std::min)(rows(), cols())); + } + + /** \returns a vector expression of the main diagonal (const version) */ + inline const Block diagonal() const { + return Block(coeffs(), supers(), 0, 1, (std::min)(rows(), cols())); + } + + template + struct DiagonalIntReturnType { + enum { + ReturnOpposite = + (int(Options) & int(SelfAdjoint)) && (((Index) > 0 && Supers == 0) || ((Index) < 0 && Subs == 0)), + Conjugate = ReturnOpposite && NumTraits::IsComplex, + ActualIndex = ReturnOpposite ? -Index : Index, + DiagonalSize = + (RowsAtCompileTime == Dynamic || ColsAtCompileTime == Dynamic) + ? Dynamic + : (ActualIndex < 0 ? min_size_prefer_dynamic(ColsAtCompileTime, RowsAtCompileTime + ActualIndex) + : min_size_prefer_dynamic(RowsAtCompileTime, ColsAtCompileTime - ActualIndex)) + }; + typedef Block BuildType; + typedef std::conditional_t, BuildType>, BuildType> + Type; + }; + + /** \returns a vector expression of the \a N -th sub or super diagonal */ + template + inline typename DiagonalIntReturnType::Type diagonal() { + return typename DiagonalIntReturnType::BuildType(coeffs(), supers() - N, (std::max)(0, N), 1, diagonalLength(N)); + } + + /** \returns a vector expression of the \a N -th sub or super diagonal */ + template + inline const typename DiagonalIntReturnType::Type diagonal() const { + return typename DiagonalIntReturnType::BuildType(coeffs(), supers() - N, (std::max)(0, N), 1, diagonalLength(N)); + } + + /** \returns a vector expression of the \a i -th sub or super diagonal */ + inline Block diagonal(Index i) { + eigen_assert((i < 0 && -i <= subs()) || (i >= 0 && i <= supers())); + return Block(coeffs(), supers() - i, std::max(0, i), 1, diagonalLength(i)); + } + + /** \returns a vector expression of the \a i -th sub or super diagonal */ + inline const Block diagonal(Index i) const { + eigen_assert((i < 0 && -i <= subs()) || (i >= 0 && i <= supers())); + return Block(coeffs(), supers() - i, std::max(0, i), 1, + diagonalLength(i)); + } + + template + inline void evalTo(Dest& dst) const { + dst.resize(rows(), cols()); + dst.setZero(); + dst.diagonal() = diagonal(); + for (Index i = 1; i <= supers(); ++i) dst.diagonal(i) = diagonal(i); + for (Index i = 1; i <= subs(); ++i) dst.diagonal(-i) = diagonal(-i); + } + + DenseMatrixType toDenseMatrix() const { + DenseMatrixType res(rows(), cols()); + evalTo(res); + return res; + } + + protected: + inline Index diagonalLength(Index i) const { + return i < 0 ? (std::min)(cols(), rows() + i) : (std::min)(rows(), cols() - i); + } +}; + +/** + * \class BandMatrix + * \ingroup Core_Module + * + * \brief Represents a rectangular matrix with a banded storage + * + * \tparam Scalar_ Numeric type, i.e. float, double, int + * \tparam Rows_ Number of rows, or \b Dynamic + * \tparam Cols_ Number of columns, or \b Dynamic + * \tparam Supers_ Number of super diagonal + * \tparam Subs_ Number of sub diagonal + * \tparam Options_ A combination of either \b #RowMajor or \b #ColMajor, and of \b #SelfAdjoint + * The former controls \ref TopicStorageOrders "storage order", and defaults to + * column-major. The latter controls whether the matrix represents a selfadjoint + * matrix in which case either Supers of Subs have to be null. + * + * \sa class TridiagonalMatrix + */ + +template +struct traits > { + typedef Scalar_ Scalar; + typedef Dense StorageKind; + typedef Eigen::Index StorageIndex; + enum { + CoeffReadCost = NumTraits::ReadCost, + RowsAtCompileTime = Rows_, + ColsAtCompileTime = Cols_, + MaxRowsAtCompileTime = Rows_, + MaxColsAtCompileTime = Cols_, + Flags = LvalueBit, + Supers = Supers_, + Subs = Subs_, + Options = Options_, + DataRowsAtCompileTime = ((Supers != Dynamic) && (Subs != Dynamic)) ? 1 + Supers + Subs : Dynamic + }; + typedef Matrix + CoefficientsType; +}; + +template +class BandMatrix : public BandMatrixBase > { + public: + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::traits::StorageIndex StorageIndex; + typedef typename internal::traits::CoefficientsType CoefficientsType; + + explicit inline BandMatrix(Index rows = Rows, Index cols = Cols, Index supers = Supers, Index subs = Subs) + : m_coeffs(1 + supers + subs, cols), m_rows(rows), m_supers(supers), m_subs(subs) {} + + /** \returns the number of columns */ + constexpr Index rows() const { return m_rows.value(); } + + /** \returns the number of rows */ + constexpr Index cols() const { return m_coeffs.cols(); } + + /** \returns the number of super diagonals */ + constexpr Index supers() const { return m_supers.value(); } + + /** \returns the number of sub diagonals */ + constexpr Index subs() const { return m_subs.value(); } + + inline const CoefficientsType& coeffs() const { return m_coeffs; } + inline CoefficientsType& coeffs() { return m_coeffs; } + + protected: + CoefficientsType m_coeffs; + internal::variable_if_dynamic m_rows; + internal::variable_if_dynamic m_supers; + internal::variable_if_dynamic m_subs; +}; + +template +class BandMatrixWrapper; + +template +struct traits > { + typedef typename CoefficientsType_::Scalar Scalar; + typedef typename CoefficientsType_::StorageKind StorageKind; + typedef typename CoefficientsType_::StorageIndex StorageIndex; + enum { + CoeffReadCost = internal::traits::CoeffReadCost, + RowsAtCompileTime = Rows_, + ColsAtCompileTime = Cols_, + MaxRowsAtCompileTime = Rows_, + MaxColsAtCompileTime = Cols_, + Flags = LvalueBit, + Supers = Supers_, + Subs = Subs_, + Options = Options_, + DataRowsAtCompileTime = ((Supers != Dynamic) && (Subs != Dynamic)) ? 1 + Supers + Subs : Dynamic + }; + typedef CoefficientsType_ CoefficientsType; +}; + +template +class BandMatrixWrapper + : public BandMatrixBase > { + public: + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::traits::CoefficientsType CoefficientsType; + typedef typename internal::traits::StorageIndex StorageIndex; + + explicit inline BandMatrixWrapper(const CoefficientsType& coeffs, Index rows = Rows_, Index cols = Cols_, + Index supers = Supers_, Index subs = Subs_) + : m_coeffs(coeffs), m_rows(rows), m_supers(supers), m_subs(subs) { + EIGEN_UNUSED_VARIABLE(cols); + // eigen_assert(coeffs.cols()==cols() && (supers()+subs()+1)==coeffs.rows()); + } + + /** \returns the number of columns */ + constexpr Index rows() const { return m_rows.value(); } + + /** \returns the number of rows */ + constexpr Index cols() const { return m_coeffs.cols(); } + + /** \returns the number of super diagonals */ + constexpr Index supers() const { return m_supers.value(); } + + /** \returns the number of sub diagonals */ + constexpr Index subs() const { return m_subs.value(); } + + inline const CoefficientsType& coeffs() const { return m_coeffs; } + + protected: + const CoefficientsType& m_coeffs; + internal::variable_if_dynamic m_rows; + internal::variable_if_dynamic m_supers; + internal::variable_if_dynamic m_subs; +}; + +/** + * \class TridiagonalMatrix + * \ingroup Core_Module + * + * \brief Represents a tridiagonal matrix with a compact banded storage + * + * \tparam Scalar Numeric type, i.e. float, double, int + * \tparam Size Number of rows and cols, or \b Dynamic + * \tparam Options Can be 0 or \b SelfAdjoint + * + * \sa class BandMatrix + */ +template +class TridiagonalMatrix : public BandMatrix { + typedef BandMatrix Base; + typedef typename Base::StorageIndex StorageIndex; + + public: + explicit TridiagonalMatrix(Index size = Size) : Base(size, size, Options & SelfAdjoint ? 0 : 1, 1) {} + + inline typename Base::template DiagonalIntReturnType<1>::Type super() { return Base::template diagonal<1>(); } + inline const typename Base::template DiagonalIntReturnType<1>::Type super() const { + return Base::template diagonal<1>(); + } + inline typename Base::template DiagonalIntReturnType<-1>::Type sub() { return Base::template diagonal<-1>(); } + inline const typename Base::template DiagonalIntReturnType<-1>::Type sub() const { + return Base::template diagonal<-1>(); + } + + protected: +}; + +struct BandShape {}; + +template +struct evaluator_traits > + : public evaluator_traits_base > { + typedef BandShape Shape; +}; + +template +struct evaluator_traits > + : public evaluator_traits_base > { + typedef BandShape Shape; +}; + +template <> +struct AssignmentKind { + typedef EigenBase2EigenBase Kind; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_BANDMATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Block.h b/src/3rdparty/eigen/Eigen/src/Core/Block.h new file mode 100644 index 0000000..39abff7 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Block.h @@ -0,0 +1,429 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_BLOCK_H +#define EIGEN_BLOCK_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits> : traits { + typedef typename traits::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type XprTypeNested; + typedef std::remove_reference_t XprTypeNested_; + enum { + MatrixRows = traits::RowsAtCompileTime, + MatrixCols = traits::ColsAtCompileTime, + RowsAtCompileTime = MatrixRows == 0 ? 0 : BlockRows, + ColsAtCompileTime = MatrixCols == 0 ? 0 : BlockCols, + MaxRowsAtCompileTime = BlockRows == 0 ? 0 + : RowsAtCompileTime != Dynamic ? int(RowsAtCompileTime) + : int(traits::MaxRowsAtCompileTime), + MaxColsAtCompileTime = BlockCols == 0 ? 0 + : ColsAtCompileTime != Dynamic ? int(ColsAtCompileTime) + : int(traits::MaxColsAtCompileTime), + + XprTypeIsRowMajor = (int(traits::Flags) & RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime == 1 && MaxColsAtCompileTime != 1) ? 1 + : (MaxColsAtCompileTime == 1 && MaxRowsAtCompileTime != 1) ? 0 + : XprTypeIsRowMajor, + HasSameStorageOrderAsXprType = (IsRowMajor == XprTypeIsRowMajor), + InnerSize = IsRowMajor ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsXprType ? int(inner_stride_at_compile_time::ret) + : int(outer_stride_at_compile_time::ret), + OuterStrideAtCompileTime = HasSameStorageOrderAsXprType ? int(outer_stride_at_compile_time::ret) + : int(inner_stride_at_compile_time::ret), + + // FIXME, this traits is rather specialized for dense object and it needs to be cleaned further + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsRowMajorBit = IsRowMajor ? RowMajorBit : 0, + Flags = (traits::Flags & (DirectAccessBit | (InnerPanel_ ? CompressedAccessBit : 0))) | FlagsLvalueBit | + FlagsRowMajorBit, + // FIXME DirectAccessBit should not be handled by expressions + // + // Alignment is needed by MapBase's assertions + // We can sefely set it to false here. Internal alignment errors will be detected by an eigen_internal_assert in the + // respective evaluator + Alignment = 0, + InnerPanel = InnerPanel_ ? 1 : 0 + }; +}; + +template ::ret> +class BlockImpl_dense; + +} // end namespace internal + +template +class BlockImpl; + +/** \class Block + * \ingroup Core_Module + * + * \brief Expression of a fixed-size or dynamic-size block + * + * \tparam XprType the type of the expression in which we are taking a block + * \tparam BlockRows the number of rows of the block we are taking at compile time (optional) + * \tparam BlockCols the number of columns of the block we are taking at compile time (optional) + * \tparam InnerPanel is true, if the block maps to a set of rows of a row major matrix or + * to set of columns of a column major matrix (optional). The parameter allows to determine + * at compile time whether aligned access is possible on the block expression. + * + * This class represents an expression of either a fixed-size or dynamic-size block. It is the return + * type of DenseBase::block(Index,Index,Index,Index) and DenseBase::block(Index,Index) and + * most of the time this is the only way it is used. + * + * However, if you want to directly manipulate block expressions, + * for instance if you want to write a function returning such an expression, you + * will need to use this class. + * + * Here is an example illustrating the dynamic case: + * \include class_Block.cpp + * Output: \verbinclude class_Block.out + * + * \note Even though this expression has dynamic size, in the case where \a XprType + * has fixed size, this expression inherits a fixed maximal size which means that evaluating + * it does not cause a dynamic memory allocation. + * + * Here is an example illustrating the fixed-size case: + * \include class_FixedBlock.cpp + * Output: \verbinclude class_FixedBlock.out + * + * \sa DenseBase::block(Index,Index,Index,Index), DenseBase::block(Index,Index), class VectorBlock + */ +template +class Block + : public BlockImpl::StorageKind> { + typedef BlockImpl::StorageKind> Impl; + using BlockHelper = internal::block_xpr_helper; + + public: + // typedef typename Impl::Base Base; + typedef Impl Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Block) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Block) + + typedef internal::remove_all_t NestedExpression; + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Block(XprType& xpr, Index i) : Impl(xpr, i) { + eigen_assert((i >= 0) && (((BlockRows == 1) && (BlockCols == XprType::ColsAtCompileTime) && i < xpr.rows()) || + ((BlockRows == XprType::RowsAtCompileTime) && (BlockCols == 1) && i < xpr.cols()))); + } + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Block(XprType& xpr, Index startRow, Index startCol) + : Impl(xpr, startRow, startCol) { + EIGEN_STATIC_ASSERT(RowsAtCompileTime != Dynamic && ColsAtCompileTime != Dynamic, + THIS_METHOD_IS_ONLY_FOR_FIXED_SIZE) + eigen_assert(startRow >= 0 && BlockRows >= 0 && startRow + BlockRows <= xpr.rows() && startCol >= 0 && + BlockCols >= 0 && startCol + BlockCols <= xpr.cols()); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Block(XprType& xpr, Index startRow, Index startCol, Index blockRows, + Index blockCols) + : Impl(xpr, startRow, startCol, blockRows, blockCols) { + eigen_assert((RowsAtCompileTime == Dynamic || RowsAtCompileTime == blockRows) && + (ColsAtCompileTime == Dynamic || ColsAtCompileTime == blockCols)); + eigen_assert(startRow >= 0 && blockRows >= 0 && startRow <= xpr.rows() - blockRows && startCol >= 0 && + blockCols >= 0 && startCol <= xpr.cols() - blockCols); + } + + // convert nested blocks (e.g. Block>) to a simple block expression (Block) + + using ConstUnwindReturnType = Block; + using UnwindReturnType = Block; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ConstUnwindReturnType unwind() const { + return ConstUnwindReturnType(BlockHelper::base(*this), BlockHelper::row(*this, 0), BlockHelper::col(*this, 0), + this->rows(), this->cols()); + } + + template ::value>> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE UnwindReturnType unwind() { + return UnwindReturnType(BlockHelper::base(*this), BlockHelper::row(*this, 0), BlockHelper::col(*this, 0), + this->rows(), this->cols()); + } +}; + +// The generic default implementation for dense block simply forward to the internal::BlockImpl_dense +// that must be specialized for direct and non-direct access... +template +class BlockImpl + : public internal::BlockImpl_dense { + typedef internal::BlockImpl_dense Impl; + typedef typename XprType::StorageIndex StorageIndex; + + public: + typedef Impl Base; + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index i) : Impl(xpr, i) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index startRow, Index startCol) + : Impl(xpr, startRow, startCol) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index startRow, Index startCol, Index blockRows, + Index blockCols) + : Impl(xpr, startRow, startCol, blockRows, blockCols) {} +}; + +namespace internal { + +/** \internal Internal implementation of dense Blocks in the general case. */ +template +class BlockImpl_dense : public internal::dense_xpr_base>::type { + typedef Block BlockType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + + public: + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(BlockType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl_dense) + + // class InnerIterator; // FIXME apparently never used + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC inline BlockImpl_dense(XprType& xpr, Index i) + : m_xpr(xpr), + // It is a row if and only if BlockRows==1 and BlockCols==XprType::ColsAtCompileTime, + // and it is a column if and only if BlockRows==XprType::RowsAtCompileTime and BlockCols==1, + // all other cases are invalid. + // The case a 1x1 matrix seems ambiguous, but the result is the same anyway. + m_startRow((BlockRows == 1) && (BlockCols == XprType::ColsAtCompileTime) ? i : 0), + m_startCol((BlockRows == XprType::RowsAtCompileTime) && (BlockCols == 1) ? i : 0), + m_blockRows(BlockRows == 1 ? 1 : xpr.rows()), + m_blockCols(BlockCols == 1 ? 1 : xpr.cols()) {} + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC inline BlockImpl_dense(XprType& xpr, Index startRow, Index startCol) + : m_xpr(xpr), m_startRow(startRow), m_startCol(startCol), m_blockRows(BlockRows), m_blockCols(BlockCols) {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC inline BlockImpl_dense(XprType& xpr, Index startRow, Index startCol, Index blockRows, + Index blockCols) + : m_xpr(xpr), m_startRow(startRow), m_startCol(startCol), m_blockRows(blockRows), m_blockCols(blockCols) {} + + EIGEN_DEVICE_FUNC inline Index rows() const { return m_blockRows.value(); } + EIGEN_DEVICE_FUNC inline Index cols() const { return m_blockCols.value(); } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index rowId, Index colId) { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + return m_xpr.coeffRef(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index rowId, Index colId) const { + return m_xpr.derived().coeffRef(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index rowId, Index colId) const { + return m_xpr.coeff(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index index) { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + return m_xpr.coeffRef(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index index) const { + return m_xpr.coeffRef(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + EIGEN_DEVICE_FUNC inline const CoeffReturnType coeff(Index index) const { + return m_xpr.coeff(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + template + EIGEN_DEVICE_FUNC inline PacketScalar packet(Index rowId, Index colId) const { + return m_xpr.template packet(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + template + EIGEN_DEVICE_FUNC inline void writePacket(Index rowId, Index colId, const PacketScalar& val) { + m_xpr.template writePacket(rowId + m_startRow.value(), colId + m_startCol.value(), val); + } + + template + EIGEN_DEVICE_FUNC inline PacketScalar packet(Index index) const { + return m_xpr.template packet(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + template + EIGEN_DEVICE_FUNC inline void writePacket(Index index, const PacketScalar& val) { + m_xpr.template writePacket(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0), val); + } + +#ifdef EIGEN_PARSED_BY_DOXYGEN + /** \sa MapBase::data() */ + EIGEN_DEVICE_FUNC constexpr const Scalar* data() const; + EIGEN_DEVICE_FUNC inline Index innerStride() const; + EIGEN_DEVICE_FUNC inline Index outerStride() const; +#endif + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const internal::remove_all_t& nestedExpression() const { + return m_xpr; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE XprType& nestedExpression() { return m_xpr; } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr StorageIndex startRow() const noexcept { return m_startRow.value(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr StorageIndex startCol() const noexcept { return m_startCol.value(); } + + protected: + XprTypeNested m_xpr; + const internal::variable_if_dynamic + m_startRow; + const internal::variable_if_dynamic + m_startCol; + const internal::variable_if_dynamic m_blockRows; + const internal::variable_if_dynamic m_blockCols; +}; + +/** \internal Internal implementation of dense Blocks in the direct access case.*/ +template +class BlockImpl_dense + : public MapBase> { + typedef Block BlockType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + enum { XprTypeIsRowMajor = (int(traits::Flags) & RowMajorBit) != 0 }; + + /** \internal Returns base+offset (unless base is null, in which case returns null). + * Adding an offset to nullptr is undefined behavior, so we must avoid it. + */ + template + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE static Scalar* add_to_nullable_pointer(Scalar* base, Index offset) { + return base != nullptr ? base + offset : nullptr; + } + + public: + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(BlockType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl_dense) + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl_dense(XprType& xpr, Index i) + : Base((BlockRows == 0 || BlockCols == 0) + ? nullptr + : add_to_nullable_pointer( + xpr.data(), + i * (((BlockRows == 1) && (BlockCols == XprType::ColsAtCompileTime) && (!XprTypeIsRowMajor)) || + ((BlockRows == XprType::RowsAtCompileTime) && (BlockCols == 1) && + (XprTypeIsRowMajor)) + ? xpr.innerStride() + : xpr.outerStride())), + BlockRows == 1 ? 1 : xpr.rows(), BlockCols == 1 ? 1 : xpr.cols()), + m_xpr(xpr), + m_startRow((BlockRows == 1) && (BlockCols == XprType::ColsAtCompileTime) ? i : 0), + m_startCol((BlockRows == XprType::RowsAtCompileTime) && (BlockCols == 1) ? i : 0) { + init(); + } + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl_dense(XprType& xpr, Index startRow, Index startCol) + : Base((BlockRows == 0 || BlockCols == 0) + ? nullptr + : add_to_nullable_pointer(xpr.data(), + xpr.innerStride() * (XprTypeIsRowMajor ? startCol : startRow) + + xpr.outerStride() * (XprTypeIsRowMajor ? startRow : startCol))), + m_xpr(xpr), + m_startRow(startRow), + m_startCol(startCol) { + init(); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl_dense(XprType& xpr, Index startRow, Index startCol, Index blockRows, + Index blockCols) + : Base((blockRows == 0 || blockCols == 0) + ? nullptr + : add_to_nullable_pointer(xpr.data(), + xpr.innerStride() * (XprTypeIsRowMajor ? startCol : startRow) + + xpr.outerStride() * (XprTypeIsRowMajor ? startRow : startCol)), + blockRows, blockCols), + m_xpr(xpr), + m_startRow(startRow), + m_startCol(startCol) { + init(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const internal::remove_all_t& nestedExpression() const noexcept { + return m_xpr; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE XprType& nestedExpression() { return m_xpr; } + + /** \sa MapBase::innerStride() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index innerStride() const noexcept { + return internal::traits::HasSameStorageOrderAsXprType ? m_xpr.innerStride() : m_xpr.outerStride(); + } + + /** \sa MapBase::outerStride() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index outerStride() const noexcept { + return internal::traits::HasSameStorageOrderAsXprType ? m_xpr.outerStride() : m_xpr.innerStride(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr StorageIndex startRow() const noexcept { return m_startRow.value(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr StorageIndex startCol() const noexcept { return m_startCol.value(); } + +#ifndef __SUNPRO_CC + // FIXME sunstudio is not friendly with the above friend... + // META-FIXME there is no 'friend' keyword around here. Is this obsolete? + protected: +#endif + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal used by allowAligned() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl_dense(XprType& xpr, const Scalar* data, Index blockRows, + Index blockCols) + : Base(data, blockRows, blockCols), m_xpr(xpr) { + init(); + } +#endif + + protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void init() { + m_outerStride = + internal::traits::HasSameStorageOrderAsXprType ? m_xpr.outerStride() : m_xpr.innerStride(); + } + + XprTypeNested m_xpr; + const internal::variable_if_dynamic + m_startRow; + const internal::variable_if_dynamic + m_startCol; + Index m_outerStride; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_BLOCK_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CommaInitializer.h b/src/3rdparty/eigen/Eigen/src/Core/CommaInitializer.h new file mode 100644 index 0000000..c414117 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CommaInitializer.h @@ -0,0 +1,149 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_COMMAINITIALIZER_H +#define EIGEN_COMMAINITIALIZER_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class CommaInitializer + * \ingroup Core_Module + * + * \brief Helper class used by the comma initializer operator + * + * This class is internally used to implement the comma initializer feature. It is + * the return type of MatrixBase::operator<<, and most of the time this is the only + * way it is used. + * + * \sa \blank \ref MatrixBaseCommaInitRef "MatrixBase::operator<<", CommaInitializer::finished() + */ +template +struct CommaInitializer { + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC inline CommaInitializer(XprType& xpr, const Scalar& s) + : m_xpr(xpr), m_row(0), m_col(1), m_currentBlockRows(1) { + eigen_assert(m_xpr.rows() > 0 && m_xpr.cols() > 0 && "Cannot comma-initialize a 0x0 matrix (operator<<)"); + m_xpr.coeffRef(0, 0) = s; + } + + template + EIGEN_DEVICE_FUNC inline CommaInitializer(XprType& xpr, const DenseBase& other) + : m_xpr(xpr), m_row(0), m_col(other.cols()), m_currentBlockRows(other.rows()) { + eigen_assert(m_xpr.rows() >= other.rows() && m_xpr.cols() >= other.cols() && + "Cannot comma-initialize a 0x0 matrix (operator<<)"); + m_xpr.template block(0, 0, other.rows(), + other.cols()) = other; + } + + /* Copy/Move constructor which transfers ownership. This is crucial in + * absence of return value optimization to avoid assertions during destruction. */ + // FIXME in C++11 mode this could be replaced by a proper RValue constructor + EIGEN_DEVICE_FUNC inline CommaInitializer(const CommaInitializer& o) + : m_xpr(o.m_xpr), m_row(o.m_row), m_col(o.m_col), m_currentBlockRows(o.m_currentBlockRows) { + // Mark original object as finished. In absence of R-value references we need to const_cast: + const_cast(o).m_row = m_xpr.rows(); + const_cast(o).m_col = m_xpr.cols(); + const_cast(o).m_currentBlockRows = 0; + } + + /* inserts a scalar value in the target matrix */ + EIGEN_DEVICE_FUNC CommaInitializer &operator,(const Scalar& s) { + if (m_col == m_xpr.cols()) { + m_row += m_currentBlockRows; + m_col = 0; + m_currentBlockRows = 1; + eigen_assert(m_row < m_xpr.rows() && "Too many rows passed to comma initializer (operator<<)"); + } + eigen_assert(m_col < m_xpr.cols() && "Too many coefficients passed to comma initializer (operator<<)"); + eigen_assert(m_currentBlockRows == 1); + m_xpr.coeffRef(m_row, m_col++) = s; + return *this; + } + + /* inserts a matrix expression in the target matrix */ + template + EIGEN_DEVICE_FUNC CommaInitializer &operator,(const DenseBase& other) { + if (m_col == m_xpr.cols() && (other.cols() != 0 || other.rows() != m_currentBlockRows)) { + m_row += m_currentBlockRows; + m_col = 0; + m_currentBlockRows = other.rows(); + eigen_assert(m_row + m_currentBlockRows <= m_xpr.rows() && + "Too many rows passed to comma initializer (operator<<)"); + } + eigen_assert((m_col + other.cols() <= m_xpr.cols()) && + "Too many coefficients passed to comma initializer (operator<<)"); + eigen_assert(m_currentBlockRows == other.rows()); + m_xpr.template block(m_row, m_col, other.rows(), + other.cols()) = other; + m_col += other.cols(); + return *this; + } + + EIGEN_DEVICE_FUNC inline ~CommaInitializer() +#if defined VERIFY_RAISES_ASSERT && (!defined EIGEN_NO_ASSERTION_CHECKING) && defined EIGEN_EXCEPTIONS + noexcept(false) // Eigen::eigen_assert_exception +#endif + { + finished(); + } + + /** \returns the built matrix once all its coefficients have been set. + * Calling finished is 100% optional. Its purpose is to write expressions + * like this: + * \code + * quaternion.fromRotationMatrix((Matrix3f() << axis0, axis1, axis2).finished()); + * \endcode + */ + EIGEN_DEVICE_FUNC inline XprType& finished() { + eigen_assert(((m_row + m_currentBlockRows) == m_xpr.rows() || m_xpr.cols() == 0) && m_col == m_xpr.cols() && + "Too few coefficients passed to comma initializer (operator<<)"); + return m_xpr; + } + + XprType& m_xpr; // target expression + Index m_row; // current row id + Index m_col; // current col id + Index m_currentBlockRows; // current block height +}; + +/** \anchor MatrixBaseCommaInitRef + * Convenient operator to set the coefficients of a matrix. + * + * The coefficients must be provided in a row major order and exactly match + * the size of the matrix. Otherwise an assertion is raised. + * + * Example: \include MatrixBase_set.cpp + * Output: \verbinclude MatrixBase_set.out + * + * \note According the c++ standard, the argument expressions of this comma initializer are evaluated in arbitrary + * order. + * + * \sa CommaInitializer::finished(), class CommaInitializer + */ +template +EIGEN_DEVICE_FUNC inline CommaInitializer DenseBase::operator<<(const Scalar& s) { + return CommaInitializer(*static_cast(this), s); +} + +/** \sa operator<<(const Scalar&) */ +template +template +EIGEN_DEVICE_FUNC inline CommaInitializer DenseBase::operator<<( + const DenseBase& other) { + return CommaInitializer(*static_cast(this), other); +} + +} // end namespace Eigen + +#endif // EIGEN_COMMAINITIALIZER_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ConditionEstimator.h b/src/3rdparty/eigen/Eigen/src/Core/ConditionEstimator.h new file mode 100644 index 0000000..dd1770b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ConditionEstimator.h @@ -0,0 +1,173 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2016 Rasmus Munk Larsen (rmlarsen@google.com) +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CONDITIONESTIMATOR_H +#define EIGEN_CONDITIONESTIMATOR_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct rcond_compute_sign { + static inline Vector run(const Vector& v) { + const RealVector v_abs = v.cwiseAbs(); + return (v_abs.array() == static_cast(0)) + .select(Vector::Ones(v.size()), v.cwiseQuotient(v_abs)); + } +}; + +// Partial specialization to avoid elementwise division for real vectors. +template +struct rcond_compute_sign { + static inline Vector run(const Vector& v) { + return (v.array() < static_cast(0)) + .select(-Vector::Ones(v.size()), Vector::Ones(v.size())); + } +}; + +/** + * \returns an estimate of ||inv(matrix)||_1 given a decomposition of + * \a matrix that implements .solve() and .adjoint().solve() methods. + * + * This function implements Algorithms 4.1 and 5.1 from + * http://www.maths.manchester.ac.uk/~higham/narep/narep135.pdf + * which also forms the basis for the condition number estimators in + * LAPACK. Since at most 10 calls to the solve method of dec are + * performed, the total cost is O(dims^2), as opposed to O(dims^3) + * needed to compute the inverse matrix explicitly. + * + * The most common usage is in estimating the condition number + * ||matrix||_1 * ||inv(matrix)||_1. The first term ||matrix||_1 can be + * computed directly in O(n^2) operations. + * + * Supports the following decompositions: FullPivLU, PartialPivLU, LDLT, and + * LLT. + * + * \sa FullPivLU, PartialPivLU, LDLT, LLT. + */ +template +typename Decomposition::RealScalar rcond_invmatrix_L1_norm_estimate(const Decomposition& dec) { + typedef typename Decomposition::MatrixType MatrixType; + typedef typename Decomposition::Scalar Scalar; + typedef typename Decomposition::RealScalar RealScalar; + typedef typename internal::plain_col_type::type Vector; + typedef typename internal::plain_col_type::type RealVector; + const bool is_complex = (NumTraits::IsComplex != 0); + + eigen_assert(dec.rows() == dec.cols()); + const Index n = dec.rows(); + if (n == 0) return 0; + + // Disable Index to float conversion warning +#ifdef __INTEL_COMPILER +#pragma warning push +#pragma warning(disable : 2259) +#endif + Vector v = dec.solve(Vector::Ones(n) / Scalar(n)); +#ifdef __INTEL_COMPILER +#pragma warning pop +#endif + + // lower_bound is a lower bound on + // ||inv(matrix)||_1 = sup_v ||inv(matrix) v||_1 / ||v||_1 + // and is the objective maximized by the ("super-") gradient ascent + // algorithm below. + RealScalar lower_bound = v.template lpNorm<1>(); + if (n == 1) return lower_bound; + + // Gradient ascent algorithm follows: We know that the optimum is achieved at + // one of the simplices v = e_i, so in each iteration we follow a + // super-gradient to move towards the optimal one. + RealScalar old_lower_bound = lower_bound; + Vector sign_vector(n); + Vector old_sign_vector; + Index v_max_abs_index = -1; + Index old_v_max_abs_index = v_max_abs_index; + for (int k = 0; k < 4; ++k) { + sign_vector = internal::rcond_compute_sign::run(v); + if (k > 0 && !is_complex && sign_vector == old_sign_vector) { + // Break if the solution stagnated. + break; + } + // v_max_abs_index = argmax |real( inv(matrix)^T * sign_vector )| + v = dec.adjoint().solve(sign_vector); + v.real().cwiseAbs().maxCoeff(&v_max_abs_index); + if (v_max_abs_index == old_v_max_abs_index) { + // Break if the solution stagnated. + break; + } + // Move to the new simplex e_j, where j = v_max_abs_index. + v = dec.solve(Vector::Unit(n, v_max_abs_index)); // v = inv(matrix) * e_j. + lower_bound = v.template lpNorm<1>(); + if (lower_bound <= old_lower_bound) { + // Break if the gradient step did not increase the lower_bound. + break; + } + if (!is_complex) { + old_sign_vector = sign_vector; + } + old_v_max_abs_index = v_max_abs_index; + old_lower_bound = lower_bound; + } + // The following calculates an independent estimate of ||matrix||_1 by + // multiplying matrix by a vector with entries of slowly increasing + // magnitude and alternating sign: + // v_i = (-1)^{i} (1 + (i / (dim-1))), i = 0,...,dim-1. + // This improvement to Hager's algorithm above is due to Higham. It was + // added to make the algorithm more robust in certain corner cases where + // large elements in the matrix might otherwise escape detection due to + // exact cancellation (especially when op and op_adjoint correspond to a + // sequence of backsubstitutions and permutations), which could cause + // Hager's algorithm to vastly underestimate ||matrix||_1. + Scalar alternating_sign(RealScalar(1)); + for (Index i = 0; i < n; ++i) { + // The static_cast is needed when Scalar is a complex and RealScalar implements expression templates + v[i] = alternating_sign * static_cast(RealScalar(1) + (RealScalar(i) / (RealScalar(n - 1)))); + alternating_sign = -alternating_sign; + } + v = dec.solve(v); + const RealScalar alternate_lower_bound = (2 * v.template lpNorm<1>()) / (3 * RealScalar(n)); + return numext::maxi(lower_bound, alternate_lower_bound); +} + +/** \brief Reciprocal condition number estimator. + * + * Computing a decomposition of a dense matrix takes O(n^3) operations, while + * this method estimates the condition number quickly and reliably in O(n^2) + * operations. + * + * \returns an estimate of the reciprocal condition number + * (1 / (||matrix||_1 * ||inv(matrix)||_1)) of matrix, given ||matrix||_1 and + * its decomposition. Supports the following decompositions: FullPivLU, + * PartialPivLU, LDLT, and LLT. + * + * \sa FullPivLU, PartialPivLU, LDLT, LLT. + */ +template +typename Decomposition::RealScalar rcond_estimate_helper(typename Decomposition::RealScalar matrix_norm, + const Decomposition& dec) { + typedef typename Decomposition::RealScalar RealScalar; + eigen_assert(dec.rows() == dec.cols()); + if (dec.rows() == 0) return NumTraits::infinity(); + if (numext::is_exactly_zero(matrix_norm)) return RealScalar(0); + if (dec.rows() == 1) return RealScalar(1); + const RealScalar inverse_matrix_norm = rcond_invmatrix_L1_norm_estimate(dec); + return (numext::is_exactly_zero(inverse_matrix_norm) ? RealScalar(0) + : (RealScalar(1) / inverse_matrix_norm) / matrix_norm); +} + +} // namespace internal + +} // namespace Eigen + +#endif diff --git a/src/3rdparty/eigen/Eigen/src/Core/CoreEvaluators.h b/src/3rdparty/eigen/Eigen/src/Core/CoreEvaluators.h new file mode 100644 index 0000000..60857e2 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CoreEvaluators.h @@ -0,0 +1,2018 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011 Benoit Jacob +// Copyright (C) 2011-2014 Gael Guennebaud +// Copyright (C) 2011-2012 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_COREEVALUATORS_H +#define EIGEN_COREEVALUATORS_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +// This class returns the evaluator kind from the expression storage kind. +// Default assumes index based accessors +template +struct storage_kind_to_evaluator_kind { + typedef IndexBased Kind; +}; + +// This class returns the evaluator shape from the expression storage kind. +// It can be Dense, Sparse, Triangular, Diagonal, SelfAdjoint, Band, etc. +template +struct storage_kind_to_shape; + +template <> +struct storage_kind_to_shape { + typedef DenseShape Shape; +}; +template <> +struct storage_kind_to_shape { + typedef SolverShape Shape; +}; +template <> +struct storage_kind_to_shape { + typedef PermutationShape Shape; +}; +template <> +struct storage_kind_to_shape { + typedef TranspositionsShape Shape; +}; + +// Evaluators have to be specialized with respect to various criteria such as: +// - storage/structure/shape +// - scalar type +// - etc. +// Therefore, we need specialization of evaluator providing additional template arguments for each kind of evaluators. +// We currently distinguish the following kind of evaluators: +// - unary_evaluator for expressions taking only one arguments (CwiseUnaryOp, CwiseUnaryView, Transpose, +// MatrixWrapper, ArrayWrapper, Reverse, Replicate) +// - binary_evaluator for expression taking two arguments (CwiseBinaryOp) +// - ternary_evaluator for expression taking three arguments (CwiseTernaryOp) +// - product_evaluator for linear algebra products (Product); special case of binary_evaluator because it requires +// additional tags for dispatching. +// - mapbase_evaluator for Map, Block, Ref +// - block_evaluator for Block (special dispatching to a mapbase_evaluator or unary_evaluator) + +template ::Kind, + typename Arg2Kind = typename evaluator_traits::Kind, + typename Arg3Kind = typename evaluator_traits::Kind, + typename Arg1Scalar = typename traits::Scalar, + typename Arg2Scalar = typename traits::Scalar, + typename Arg3Scalar = typename traits::Scalar> +struct ternary_evaluator; + +template ::Kind, + typename RhsKind = typename evaluator_traits::Kind, + typename LhsScalar = typename traits::Scalar, + typename RhsScalar = typename traits::Scalar> +struct binary_evaluator; + +template ::Kind, + typename Scalar = typename T::Scalar> +struct unary_evaluator; + +// evaluator_traits contains traits for evaluator + +template +struct evaluator_traits_base { + // by default, get evaluator kind and shape from storage + typedef typename storage_kind_to_evaluator_kind::StorageKind>::Kind Kind; + typedef typename storage_kind_to_shape::StorageKind>::Shape Shape; +}; + +// Default evaluator traits +template +struct evaluator_traits : public evaluator_traits_base {}; + +template ::Shape> +struct evaluator_assume_aliasing { + static const bool value = false; +}; + +// By default, we assume a unary expression: +template +struct evaluator : public unary_evaluator { + typedef unary_evaluator Base; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const T& xpr) : Base(xpr) {} +}; + +// TODO: Think about const-correctness +template +struct evaluator : evaluator { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const T& xpr) : evaluator(xpr) {} +}; + +// ---------- base class for all evaluators ---------- + +template +struct evaluator_base { + // TODO that's not very nice to have to propagate all these traits. They are currently only needed to handle + // outer,inner indices. + typedef traits ExpressionTraits; + + enum { Alignment = 0 }; + // noncopyable: + // Don't make this class inherit noncopyable as this kills EBO (Empty Base Optimization) + // and make complex evaluator much larger than then should do. + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr evaluator_base() = default; + + private: + EIGEN_DEVICE_FUNC evaluator_base(const evaluator_base&); + EIGEN_DEVICE_FUNC const evaluator_base& operator=(const evaluator_base&); +}; + +// -------------------- Matrix and Array -------------------- +// +// evaluator is a common base class for the +// Matrix and Array evaluators. +// Here we directly specialize evaluator. This is not really a unary expression, and it is, by definition, dense, +// so no need for more sophisticated dispatching. + +// this helper permits to completely eliminate m_outerStride if it is known at compiletime. +template +class plainobjectbase_evaluator_data { + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr plainobjectbase_evaluator_data(const Scalar* ptr, Index outerStride) + : data(ptr) { +#ifndef EIGEN_INTERNAL_DEBUGGING + EIGEN_UNUSED_VARIABLE(outerStride); +#endif + eigen_internal_assert(outerStride == OuterStride); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index outerStride() const noexcept { return OuterStride; } + const Scalar* data; +}; + +template +class plainobjectbase_evaluator_data { + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr plainobjectbase_evaluator_data(const Scalar* ptr, Index outerStride) + : data(ptr), m_outerStride(outerStride) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index outerStride() const { return m_outerStride; } + const Scalar* data; + + protected: + Index m_outerStride; +}; + +template +struct evaluator> : evaluator_base { + typedef PlainObjectBase PlainObjectType; + typedef typename PlainObjectType::Scalar Scalar; + typedef typename PlainObjectType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = PlainObjectType::IsRowMajor, + IsVectorAtCompileTime = PlainObjectType::IsVectorAtCompileTime, + RowsAtCompileTime = PlainObjectType::RowsAtCompileTime, + ColsAtCompileTime = PlainObjectType::ColsAtCompileTime, + + CoeffReadCost = NumTraits::ReadCost, + Flags = traits::EvaluatorFlags, + Alignment = traits::Alignment + }; + enum { + // We do not need to know the outer stride for vectors + OuterStrideAtCompileTime = IsVectorAtCompileTime ? 0 + : int(IsRowMajor) ? ColsAtCompileTime + : RowsAtCompileTime + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr evaluator() : m_d(0, OuterStrideAtCompileTime) { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr explicit evaluator(const PlainObjectType& m) + : m_d(m.data(), IsVectorAtCompileTime ? 0 : m.outerStride()) { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType coeff(Index row, Index col) const { + return coeff(getIndex(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType coeff(Index index) const { return m_d.data[index]; } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& coeffRef(Index row, Index col) { + return coeffRef(getIndex(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& coeffRef(Index index) { + return const_cast(m_d.data)[index]; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + return packet(getIndex(row, col)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + return ploadt(m_d.data + index); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index row, Index col, const PacketType& x) { + writePacket(getIndex(row, col), x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index index, const PacketType& x) { + pstoret(const_cast(m_d.data) + index, x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + return packetSegment(getIndex(row, col), begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + return ploadtSegment(m_d.data + index, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index row, Index col, const PacketType& x, Index begin, + Index count) { + writePacketSegment(getIndex(row, col), x, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index index, const PacketType& x, Index begin, + Index count) { + pstoretSegment(const_cast(m_d.data) + index, x, begin, count); + } + + protected: + plainobjectbase_evaluator_data m_d; + + private: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index constexpr getIndex(Index row, Index col) const { + return IsRowMajor ? row * m_d.outerStride() + col : row + col * m_d.outerStride(); + } +}; + +template +struct evaluator> + : evaluator>> { + typedef Matrix XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr evaluator() = default; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr explicit evaluator(const XprType& m) + : evaluator>(m) {} +}; + +template +struct evaluator> + : evaluator>> { + typedef Array XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr evaluator() = default; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr explicit evaluator(const XprType& m) + : evaluator>(m) {} +}; + +// -------------------- Transpose -------------------- + +template +struct unary_evaluator, IndexBased> : evaluator_base> { + typedef Transpose XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + Flags = evaluator::Flags ^ RowMajorBit, + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit unary_evaluator(const XprType& t) : m_argImpl(t.nestedExpression()) {} + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_argImpl.coeff(col, row); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { return m_argImpl.coeff(index); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { return m_argImpl.coeffRef(col, row); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename XprType::Scalar& coeffRef(Index index) { + return m_argImpl.coeffRef(index); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + return m_argImpl.template packet(col, row); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + return m_argImpl.template packet(index); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index row, Index col, const PacketType& x) { + m_argImpl.template writePacket(col, row, x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index index, const PacketType& x) { + m_argImpl.template writePacket(index, x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + return m_argImpl.template packetSegment(col, row, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + return m_argImpl.template packetSegment(index, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index row, Index col, const PacketType& x, Index begin, + Index count) { + m_argImpl.template writePacketSegment(col, row, x, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index index, const PacketType& x, Index begin, + Index count) { + m_argImpl.template writePacketSegment(index, x, begin, count); + } + + protected: + evaluator m_argImpl; +}; + +// -------------------- CwiseNullaryOp -------------------- +// Like Matrix and Array, this is not really a unary expression, so we directly specialize evaluator. +// Likewise, there is not need to more sophisticated dispatching here. + +template ::value, + bool has_unary = has_unary_operator::value, + bool has_binary = has_binary_operator::value> +struct nullary_wrapper { + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { + return op(i, j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { + return op(i); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { + return op.template packetOp(i, j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { + return op.template packetOp(i); + } +}; + +template +struct nullary_wrapper { + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType = 0, IndexType = 0) const { + return op(); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType = 0, IndexType = 0) const { + return op.template packetOp(); + } +}; + +template +struct nullary_wrapper { + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j = 0) const { + return op(i, j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j = 0) const { + return op.template packetOp(i, j); + } +}; + +// We need the following specialization for vector-only functors assigned to a runtime vector, +// for instance, using linspace and assigning a RowVectorXd to a MatrixXd or even a row of a MatrixXd. +// In this case, i==0 and j is used for the actual iteration. +template +struct nullary_wrapper { + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { + eigen_assert(i == 0 || j == 0); + return op(i + j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { + eigen_assert(i == 0 || j == 0); + return op.template packetOp(i + j); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { + return op(i); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { + return op.template packetOp(i); + } +}; + +template +struct nullary_wrapper {}; + +#if 0 && EIGEN_COMP_MSVC > 0 +// Disable this ugly workaround. This is now handled in traits::match, +// but this piece of code might still become handly if some other weird compilation +// errors pop up again. + +// MSVC exhibits a weird compilation error when +// compiling: +// Eigen::MatrixXf A = MatrixXf::Random(3,3); +// Ref R = 2.f*A; +// and that has_*ary_operator> have not been instantiated yet. +// The "problem" is that evaluator<2.f*A> is instantiated by traits::match<2.f*A> +// and at that time has_*ary_operator returns true regardless of T. +// Then nullary_wrapper is badly instantiated as nullary_wrapper<.,.,true,true,true>. +// The trick is thus to defer the proper instantiation of nullary_wrapper when coeff(), +// and packet() are really instantiated as implemented below: + +// This is a simple wrapper around Index to enforce the re-instantiation of +// has_*ary_operator when needed. +template struct nullary_wrapper_workaround_msvc { + nullary_wrapper_workaround_msvc(const T&); + operator T()const; +}; + +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().operator()(op,i,j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().operator()(op,i); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().template packetOp(op,i,j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().template packetOp(op,i); + } +}; +#endif // MSVC workaround + +template +struct evaluator> + : evaluator_base> { + typedef CwiseNullaryOp XprType; + typedef remove_all_t PlainObjectTypeCleaned; + + enum { + CoeffReadCost = functor_traits::Cost, + + Flags = (evaluator::Flags & + (HereditaryBits | (functor_has_linear_access::ret ? LinearAccessBit : 0) | + (functor_traits::PacketAccess ? PacketAccessBit : 0))) | + (functor_traits::IsRepeatable ? 0 : EvalBeforeNestingBit), + Alignment = AlignedMax + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& n) : m_functor(n.functor()), m_wrapper() { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(IndexType row, IndexType col) const { + return m_wrapper(m_functor, row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(IndexType index) const { + return m_wrapper(m_functor, index); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(IndexType row, IndexType col) const { + return m_wrapper.template packetOp(m_functor, row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(IndexType index) const { + return m_wrapper.template packetOp(m_functor, index); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(IndexType row, IndexType col, Index /*begin*/, + Index /*count*/) const { + return packet(row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(IndexType index, Index /*begin*/, + Index /*count*/) const { + return packet(index); + } + + protected: + const NullaryOp m_functor; + const nullary_wrapper m_wrapper; +}; + +// -------------------- CwiseUnaryOp -------------------- + +template +struct unary_evaluator, IndexBased> : evaluator_base> { + typedef CwiseUnaryOp XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Flags = evaluator::Flags & + (HereditaryBits | LinearAccessBit | (functor_traits::PacketAccess ? PacketAccessBit : 0)), + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit unary_evaluator(const XprType& op) : m_d(op) { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_d.func()(m_d.argImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + return m_d.func()(m_d.argImpl.coeff(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + return m_d.func().packetOp(m_d.argImpl.template packet(row, col)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + return m_d.func().packetOp(m_d.argImpl.template packet(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + return m_d.func().packetOp(m_d.argImpl.template packetSegment(row, col, begin, count)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + return m_d.func().packetOp(m_d.argImpl.template packetSegment(index, begin, count)); + } + + protected: + // this helper permits to completely eliminate the functor if it is empty + struct Data { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Data(const XprType& xpr) + : op(xpr.functor()), argImpl(xpr.nestedExpression()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const UnaryOp& func() const { return op; } + UnaryOp op; + evaluator argImpl; + }; + + Data m_d; +}; + +// ----------------------- Casting --------------------- + +template +struct unary_evaluator, ArgType>, IndexBased> { + using CastOp = core_cast_op; + using XprType = CwiseUnaryOp; + + // Use the largest packet type by default + using SrcPacketType = typename packet_traits::type; + static constexpr int SrcPacketSize = unpacket_traits::size; + static constexpr int SrcPacketBytes = SrcPacketSize * sizeof(SrcType); + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + PacketAccess = functor_traits::PacketAccess, + ActualPacketAccessBit = PacketAccess ? PacketAccessBit : 0, + Flags = evaluator::Flags & (HereditaryBits | LinearAccessBit | ActualPacketAccessBit), + IsRowMajor = (evaluator::Flags & RowMajorBit), + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit unary_evaluator(const XprType& xpr) + : m_argImpl(xpr.nestedExpression()), m_rows(xpr.rows()), m_cols(xpr.cols()) { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + template + using AltSrcScalarOp = std::enable_if_t<(unpacket_traits::size < SrcPacketSize && + !find_packet_by_size::size>::value), + bool>; + template + using SrcPacketArgs1 = + std::enable_if_t<(find_packet_by_size::size>::value), bool>; + template + using SrcPacketArgs2 = std::enable_if_t<(unpacket_traits::size) == (2 * SrcPacketSize), bool>; + template + using SrcPacketArgs4 = std::enable_if_t<(unpacket_traits::size) == (4 * SrcPacketSize), bool>; + template + using SrcPacketArgs8 = std::enable_if_t<(unpacket_traits::size) == (8 * SrcPacketSize), bool>; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE bool check_array_bounds(Index row, Index col, Index begin, Index count) const { + return IsRowMajor ? (col + count + begin <= cols()) : (row + count + begin <= rows()); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE bool check_array_bounds(Index index, Index begin, Index count) const { + return index + count + begin <= size(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE SrcType srcCoeff(Index row, Index col, Index offset) const { + Index actualRow = IsRowMajor ? row : row + offset; + Index actualCol = IsRowMajor ? col + offset : col; + return m_argImpl.coeff(actualRow, actualCol); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE SrcType srcCoeff(Index index, Index offset) const { + Index actualIndex = index + offset; + return m_argImpl.coeff(actualIndex); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstType coeff(Index row, Index col) const { + return cast(srcCoeff(row, col, 0)); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstType coeff(Index index) const { + return cast(srcCoeff(index, 0)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType srcPacket(Index row, Index col, Index offset) const { + constexpr int PacketSize = unpacket_traits::size; + Index packetOffset = offset * PacketSize; + Index actualRow = IsRowMajor ? row : row + packetOffset; + Index actualCol = IsRowMajor ? col + packetOffset : col; + eigen_assert(check_array_bounds(actualRow, actualCol, 0, PacketSize) && "Array index out of bounds"); + return m_argImpl.template packet(actualRow, actualCol); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType srcPacket(Index index, Index offset) const { + constexpr int PacketSize = unpacket_traits::size; + Index packetOffset = offset * PacketSize; + Index actualIndex = index + packetOffset; + eigen_assert(check_array_bounds(actualIndex, 0, PacketSize) && "Array index out of bounds"); + return m_argImpl.template packet(actualIndex); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType srcPacketSegment(Index row, Index col, Index begin, Index count, + Index offset) const { + constexpr int PacketSize = unpacket_traits::size; + Index packetOffset = offset * PacketSize; + Index actualRow = IsRowMajor ? row : row + packetOffset; + Index actualCol = IsRowMajor ? col + packetOffset : col; + eigen_assert(check_array_bounds(actualRow, actualCol, begin, count) && "Array index out of bounds"); + return m_argImpl.template packetSegment(actualRow, actualCol, begin, count); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType srcPacketSegment(Index index, Index begin, Index count, + Index offset) const { + constexpr int PacketSize = unpacket_traits::size; + Index packetOffset = offset * PacketSize; + Index actualIndex = index + packetOffset; + eigen_assert(check_array_bounds(actualIndex, begin, count) && "Array index out of bounds"); + return m_argImpl.template packetSegment(actualIndex, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketBlock srcPacketSegmentHelper(Index row, Index col, + Index begin, + Index count) const { + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + PacketBlock packets; + for (Index i = 0; i < NumPackets; i++) packets.packet[i] = pzero(PacketType()); + Index offset = begin / SrcPacketSize; + Index actualBegin = begin % SrcPacketSize; + for (; offset < NumPackets; offset++) { + Index actualCount = numext::mini(SrcPacketSize - actualBegin, count); + packets.packet[offset] = srcPacketSegment(row, col, actualBegin, actualCount, offset); + if (count == actualCount) break; + actualBegin = 0; + count -= actualCount; + } + return packets; + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketBlock srcPacketSegmentHelper(Index index, + Index begin, + Index count) const { + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + PacketBlock packets; + for (Index i = 0; i < NumPackets; i++) packets.packet[i] = pzero(PacketType()); + Index offset = begin / SrcPacketSize; + Index actualBegin = begin % SrcPacketSize; + for (; offset < NumPackets; offset++) { + Index actualCount = numext::mini(SrcPacketSize - actualBegin, count); + packets.packet[offset] = srcPacketSegment(index, actualBegin, actualCount, offset); + if (count == actualCount) break; + actualBegin = 0; + count -= actualCount; + } + return packets; + } + + // There is no source packet type with equal or fewer elements than DstPacketType. + // This is problematic as the evaluation loop may attempt to access data outside the bounds of the array. + // For example, consider the cast utilizing pcast with an array of size 4: {0.0f,1.0f,2.0f,3.0f}. + // The first iteration of the evaluation loop will load 16 bytes: {0.0f,1.0f,2.0f,3.0f} and cast to {0.0,1.0}, which + // is acceptable. The second iteration will load 16 bytes: {2.0f,3.0f,?,?}, which is outside the bounds of the array. + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index row, Index col) const { + constexpr int DstPacketSize = unpacket_traits::size; + constexpr int SrcBytesIncrement = DstPacketSize * sizeof(SrcType); + constexpr int SrcLoadMode = plain_enum_min(SrcBytesIncrement, LoadMode); + return pcast(srcPacketSegment(row, col, 0, DstPacketSize, 0)); + } + // Use the source packet type with the same size as DstPacketType, if it exists + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index row, Index col) const { + constexpr int DstPacketSize = unpacket_traits::size; + using SizedSrcPacketType = typename find_packet_by_size::type; + constexpr int SrcBytesIncrement = DstPacketSize * sizeof(SrcType); + constexpr int SrcLoadMode = plain_enum_min(SrcBytesIncrement, LoadMode); + return pcast(srcPacket(row, col, 0)); + } + // unpacket_traits::size == 2 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index row, Index col) const { + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + return pcast(srcPacket(row, col, 0), + srcPacket(row, col, 1)); + } + // unpacket_traits::size == 4 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index row, Index col) const { + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + return pcast(srcPacket(row, col, 0), srcPacket(row, col, 1), + srcPacket(row, col, 2), + srcPacket(row, col, 3)); + } + // unpacket_traits::size == 8 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index row, Index col) const { + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + return pcast( + srcPacket(row, col, 0), srcPacket(row, col, 1), srcPacket(row, col, 2), + srcPacket(row, col, 3), srcPacket(row, col, 4), srcPacket(row, col, 5), + srcPacket(row, col, 6), srcPacket(row, col, 7)); + } + + // packetSegment variants + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index row, Index col, Index begin, + Index count) const { + constexpr int DstPacketSize = unpacket_traits::size; + constexpr int SrcBytesIncrement = DstPacketSize * sizeof(SrcType); + constexpr int SrcLoadMode = plain_enum_min(SrcBytesIncrement, LoadMode); + return pcast(srcPacketSegment(row, col, begin, count, 0)); + } + // Use the source packet type with the same size as DstPacketType, if it exists + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index row, Index col, Index begin, + Index count) const { + constexpr int DstPacketSize = unpacket_traits::size; + using SizedSrcPacketType = typename find_packet_by_size::type; + constexpr int SrcBytesIncrement = DstPacketSize * sizeof(SrcType); + constexpr int SrcLoadMode = plain_enum_min(SrcBytesIncrement, LoadMode); + return pcast( + srcPacketSegment(row, col, begin, count, 0)); + } + // unpacket_traits::size == 2 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index row, Index col, Index begin, + Index count) const { + constexpr int NumPackets = 2; + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + PacketBlock packets = + srcPacketSegmentHelper(row, col, begin, count); + return pcast(packets.packet[0], packets.packet[1]); + } + // unpacket_traits::size == 4 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index row, Index col, Index begin, + Index count) const { + constexpr int NumPackets = 4; + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + PacketBlock packets = + srcPacketSegmentHelper(row, col, begin, count); + return pcast(packets.packet[0], packets.packet[1], packets.packet[2], + packets.packet[3]); + } + // unpacket_traits::size == 8 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index row, Index col, Index begin, + Index count) const { + constexpr int NumPackets = 8; + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + PacketBlock packets = + srcPacketSegmentHelper(row, col, begin, count); + return pcast(packets.packet[0], packets.packet[1], packets.packet[2], + packets.packet[3], packets.packet[4], packets.packet[5], + packets.packet[6], packets.packet[7]); + } + + // Analogous routines for linear access. + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index index) const { + constexpr int DstPacketSize = unpacket_traits::size; + constexpr int SrcBytesIncrement = DstPacketSize * sizeof(SrcType); + constexpr int SrcLoadMode = plain_enum_min(SrcBytesIncrement, LoadMode); + return pcast(srcPacketSegment(index, 0, DstPacketSize, 0)); + } + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index index) const { + constexpr int DstPacketSize = unpacket_traits::size; + using SizedSrcPacketType = typename find_packet_by_size::type; + constexpr int SrcBytesIncrement = DstPacketSize * sizeof(SrcType); + constexpr int SrcLoadMode = plain_enum_min(SrcBytesIncrement, LoadMode); + return pcast(srcPacket(index, 0)); + } + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index index) const { + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + return pcast(srcPacket(index, 0), srcPacket(index, 1)); + } + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index index) const { + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + return pcast(srcPacket(index, 0), srcPacket(index, 1), + srcPacket(index, 2), srcPacket(index, 3)); + } + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packet(Index index) const { + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + return pcast(srcPacket(index, 0), srcPacket(index, 1), + srcPacket(index, 2), srcPacket(index, 3), + srcPacket(index, 4), srcPacket(index, 5), + srcPacket(index, 6), srcPacket(index, 7)); + } + + // packetSegment variants + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index index, Index begin, Index count) const { + constexpr int DstPacketSize = unpacket_traits::size; + constexpr int SrcBytesIncrement = DstPacketSize * sizeof(SrcType); + constexpr int SrcLoadMode = plain_enum_min(SrcBytesIncrement, LoadMode); + return pcast(srcPacketSegment(index, begin, count, 0)); + } + // Use the source packet type with the same size as DstPacketType, if it exists + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index index, Index begin, Index count) const { + constexpr int DstPacketSize = unpacket_traits::size; + using SizedSrcPacketType = typename find_packet_by_size::type; + constexpr int SrcBytesIncrement = DstPacketSize * sizeof(SrcType); + constexpr int SrcLoadMode = plain_enum_min(SrcBytesIncrement, LoadMode); + return pcast( + srcPacketSegment(index, begin, count, 0)); + } + // unpacket_traits::size == 2 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index index, Index begin, Index count) const { + constexpr int NumPackets = 2; + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + PacketBlock packets = + srcPacketSegmentHelper(index, begin, count); + return pcast(packets.packet[0], packets.packet[1]); + } + // unpacket_traits::size == 4 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index index, Index begin, Index count) const { + constexpr int NumPackets = 4; + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + PacketBlock packets = + srcPacketSegmentHelper(index, begin, count); + return pcast(packets.packet[0], packets.packet[1], packets.packet[2], + packets.packet[3]); + } + // unpacket_traits::size == 8 * SrcPacketSize + template = true> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DstPacketType packetSegment(Index index, Index begin, Index count) const { + constexpr int NumPackets = 8; + constexpr int SrcLoadMode = plain_enum_min(SrcPacketBytes, LoadMode); + PacketBlock packets = + srcPacketSegmentHelper(index, begin, count); + return pcast(packets.packet[0], packets.packet[1], packets.packet[2], + packets.packet[3], packets.packet[4], packets.packet[5], + packets.packet[6], packets.packet[7]); + } + + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index rows() const { return m_rows; } + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index cols() const { return m_cols; } + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index size() const { return m_rows * m_cols; } + + protected: + const evaluator m_argImpl; + const variable_if_dynamic m_rows; + const variable_if_dynamic m_cols; +}; + +// -------------------- CwiseTernaryOp -------------------- + +// this is a ternary expression +template +struct evaluator> + : public ternary_evaluator> { + typedef CwiseTernaryOp XprType; + typedef ternary_evaluator> Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +template +struct ternary_evaluator, IndexBased, IndexBased> + : evaluator_base> { + typedef CwiseTernaryOp XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost) + + int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Arg1Flags = evaluator::Flags, + Arg2Flags = evaluator::Flags, + Arg3Flags = evaluator::Flags, + SameType = is_same::value && + is_same::value, + StorageOrdersAgree = (int(Arg1Flags) & RowMajorBit) == (int(Arg2Flags) & RowMajorBit) && + (int(Arg1Flags) & RowMajorBit) == (int(Arg3Flags) & RowMajorBit), + Flags0 = (int(Arg1Flags) | int(Arg2Flags) | int(Arg3Flags)) & + (HereditaryBits | + (int(Arg1Flags) & int(Arg2Flags) & int(Arg3Flags) & + ((StorageOrdersAgree ? LinearAccessBit : 0) | + (functor_traits::PacketAccess && StorageOrdersAgree && SameType ? PacketAccessBit : 0)))), + Flags = (Flags0 & ~RowMajorBit) | (Arg1Flags & RowMajorBit), + Alignment = plain_enum_min(plain_enum_min(evaluator::Alignment, evaluator::Alignment), + evaluator::Alignment) + }; + + EIGEN_DEVICE_FUNC explicit ternary_evaluator(const XprType& xpr) : m_d(xpr) { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_d.func()(m_d.arg1Impl.coeff(row, col), m_d.arg2Impl.coeff(row, col), m_d.arg3Impl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + return m_d.func()(m_d.arg1Impl.coeff(index), m_d.arg2Impl.coeff(index), m_d.arg3Impl.coeff(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + return m_d.func().packetOp(m_d.arg1Impl.template packet(row, col), + m_d.arg2Impl.template packet(row, col), + m_d.arg3Impl.template packet(row, col)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + return m_d.func().packetOp(m_d.arg1Impl.template packet(index), + m_d.arg2Impl.template packet(index), + m_d.arg3Impl.template packet(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + return m_d.func().packetOp(m_d.arg1Impl.template packetSegment(row, col, begin, count), + m_d.arg2Impl.template packetSegment(row, col, begin, count), + m_d.arg3Impl.template packetSegment(row, col, begin, count)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + return m_d.func().packetOp(m_d.arg1Impl.template packetSegment(index, begin, count), + m_d.arg2Impl.template packetSegment(index, begin, count), + m_d.arg3Impl.template packetSegment(index, begin, count)); + } + + protected: + // this helper permits to completely eliminate the functor if it is empty + struct Data { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Data(const XprType& xpr) + : op(xpr.functor()), arg1Impl(xpr.arg1()), arg2Impl(xpr.arg2()), arg3Impl(xpr.arg3()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const TernaryOp& func() const { return op; } + TernaryOp op; + evaluator arg1Impl; + evaluator arg2Impl; + evaluator arg3Impl; + }; + + Data m_d; +}; + +template +struct scalar_boolean_select_spec { + using DummyTernaryOp = scalar_boolean_select_op; + using DummyArg3 = CwiseBinaryOp, CmpLhsType, CmpRhsType>; + using DummyXprType = CwiseTernaryOp; + + // only use the typed comparison if it is vectorized + static constexpr bool UseTyped = functor_traits>::PacketAccess; + using CondScalar = std::conditional_t; + + using TernaryOp = scalar_boolean_select_op; + using Arg3 = CwiseBinaryOp, CmpLhsType, CmpRhsType>; + using XprType = CwiseTernaryOp; + + using Base = ternary_evaluator; +}; + +// specialization for expressions like (a < b).select(c, d) to enable full vectorization +template +struct evaluator, Arg1, Arg2, + CwiseBinaryOp, CmpLhsType, CmpRhsType>>> + : public scalar_boolean_select_spec::Base { + using Helper = scalar_boolean_select_spec; + using Base = typename Helper::Base; + using DummyXprType = typename Helper::DummyXprType; + using Arg3 = typename Helper::Arg3; + using XprType = typename Helper::XprType; + + EIGEN_DEVICE_FUNC explicit evaluator(const DummyXprType& xpr) + : Base(XprType(xpr.arg1(), xpr.arg2(), Arg3(xpr.arg3().lhs(), xpr.arg3().rhs()))) {} +}; + +// -------------------- CwiseBinaryOp -------------------- + +// this is a binary expression +template +struct evaluator> : public binary_evaluator> { + typedef CwiseBinaryOp XprType; + typedef binary_evaluator> Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +template +struct binary_evaluator, IndexBased, IndexBased> + : evaluator_base> { + typedef CwiseBinaryOp XprType; + + enum { + CoeffReadCost = + int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + LhsFlags = evaluator::Flags, + RhsFlags = evaluator::Flags, + SameType = is_same::value, + StorageOrdersAgree = (int(LhsFlags) & RowMajorBit) == (int(RhsFlags) & RowMajorBit), + Flags0 = (int(LhsFlags) | int(RhsFlags)) & + (HereditaryBits | + (int(LhsFlags) & int(RhsFlags) & + ((StorageOrdersAgree ? LinearAccessBit : 0) | + (functor_traits::PacketAccess && StorageOrdersAgree && SameType ? PacketAccessBit : 0)))), + Flags = (Flags0 & ~RowMajorBit) | (LhsFlags & RowMajorBit), + Alignment = plain_enum_min(evaluator::Alignment, evaluator::Alignment) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit binary_evaluator(const XprType& xpr) : m_d(xpr) { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_d.func()(m_d.lhsImpl.coeff(row, col), m_d.rhsImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + return m_d.func()(m_d.lhsImpl.coeff(index), m_d.rhsImpl.coeff(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + return m_d.func().packetOp(m_d.lhsImpl.template packet(row, col), + m_d.rhsImpl.template packet(row, col)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + return m_d.func().packetOp(m_d.lhsImpl.template packet(index), + m_d.rhsImpl.template packet(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + return m_d.func().packetOp(m_d.lhsImpl.template packetSegment(row, col, begin, count), + m_d.rhsImpl.template packetSegment(row, col, begin, count)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + return m_d.func().packetOp(m_d.lhsImpl.template packetSegment(index, begin, count), + m_d.rhsImpl.template packetSegment(index, begin, count)); + } + + protected: + // this helper permits to completely eliminate the functor if it is empty + struct Data { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Data(const XprType& xpr) + : op(xpr.functor()), lhsImpl(xpr.lhs()), rhsImpl(xpr.rhs()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const BinaryOp& func() const { return op; } + BinaryOp op; + evaluator lhsImpl; + evaluator rhsImpl; + }; + + Data m_d; +}; + +// -------------------- CwiseUnaryView -------------------- + +template +struct unary_evaluator, IndexBased> + : evaluator_base> { + typedef CwiseUnaryView XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Flags = (evaluator::Flags & (HereditaryBits | LinearAccessBit | DirectAccessBit)), + + Alignment = 0 // FIXME it is not very clear why alignment is necessarily lost... + }; + + EIGEN_DEVICE_FUNC explicit unary_evaluator(const XprType& op) : m_d(op) { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_d.func()(m_d.argImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + return m_d.func()(m_d.argImpl.coeff(index)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { + return m_d.func()(m_d.argImpl.coeffRef(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { + return m_d.func()(m_d.argImpl.coeffRef(index)); + } + + protected: + // this helper permits to completely eliminate the functor if it is empty + struct Data { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Data(const XprType& xpr) + : op(xpr.functor()), argImpl(xpr.nestedExpression()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const UnaryOp& func() const { return op; } + UnaryOp op; + evaluator argImpl; + }; + + Data m_d; +}; + +// -------------------- Map -------------------- + +// FIXME perhaps the PlainObjectType could be provided by Derived::PlainObject ? +// but that might complicate template specialization +template +struct mapbase_evaluator; + +template +struct mapbase_evaluator : evaluator_base { + typedef Derived XprType; + typedef typename XprType::PointerType PointerType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = XprType::RowsAtCompileTime, + ColsAtCompileTime = XprType::ColsAtCompileTime, + CoeffReadCost = NumTraits::ReadCost + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit mapbase_evaluator(const XprType& map) + : m_data(const_cast(map.data())), + m_innerStride(map.innerStride()), + m_outerStride(map.outerStride()) { + EIGEN_STATIC_ASSERT(check_implication((evaluator::Flags & PacketAccessBit) != 0, + inner_stride_at_compile_time::ret == 1), + PACKET_ACCESS_REQUIRES_TO_HAVE_INNER_STRIDE_FIXED_TO_1); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + return m_data[index * m_innerStride.value()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { + return m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { return m_data[index * m_innerStride.value()]; } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + PointerType ptr = m_data + row * rowStride() + col * colStride(); + return ploadt(ptr); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + return ploadt(m_data + index * m_innerStride.value()); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index row, Index col, const PacketType& x) { + PointerType ptr = m_data + row * rowStride() + col * colStride(); + pstoret(ptr, x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index index, const PacketType& x) { + pstoret(m_data + index * m_innerStride.value(), x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + PointerType ptr = m_data + row * rowStride() + col * colStride(); + return ploadtSegment(ptr, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + return ploadtSegment(m_data + index * m_innerStride.value(), begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index row, Index col, const PacketType& x, Index begin, + Index count) { + PointerType ptr = m_data + row * rowStride() + col * colStride(); + pstoretSegment(ptr, x, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index index, const PacketType& x, Index begin, + Index count) { + pstoretSegment(m_data + index * m_innerStride.value(), x, begin, count); + } + + protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rowStride() const noexcept { + return XprType::IsRowMajor ? m_outerStride.value() : m_innerStride.value(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index colStride() const noexcept { + return XprType::IsRowMajor ? m_innerStride.value() : m_outerStride.value(); + } + + PointerType m_data; + const variable_if_dynamic m_innerStride; + const variable_if_dynamic m_outerStride; +}; + +template +struct evaluator> + : public mapbase_evaluator, PlainObjectType> { + typedef Map XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types once we can handle multi-sized packet types + typedef typename packet_traits::type PacketScalar; + + enum { + InnerStrideAtCompileTime = StrideType::InnerStrideAtCompileTime == 0 + ? int(PlainObjectType::InnerStrideAtCompileTime) + : int(StrideType::InnerStrideAtCompileTime), + OuterStrideAtCompileTime = StrideType::OuterStrideAtCompileTime == 0 + ? int(PlainObjectType::OuterStrideAtCompileTime) + : int(StrideType::OuterStrideAtCompileTime), + HasNoInnerStride = InnerStrideAtCompileTime == 1, + HasNoOuterStride = StrideType::OuterStrideAtCompileTime == 0, + HasNoStride = HasNoInnerStride && HasNoOuterStride, + IsDynamicSize = PlainObjectType::SizeAtCompileTime == Dynamic, + + PacketAccessMask = bool(HasNoInnerStride) ? ~int(0) : ~int(PacketAccessBit), + LinearAccessMask = + bool(HasNoStride) || bool(PlainObjectType::IsVectorAtCompileTime) ? ~int(0) : ~int(LinearAccessBit), + Flags = int(evaluator::Flags) & (LinearAccessMask & PacketAccessMask), + + Alignment = int(MapOptions) & int(AlignedMask) + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& map) : mapbase_evaluator(map) {} +}; + +// -------------------- Ref -------------------- + +template +struct evaluator> + : public mapbase_evaluator, PlainObjectType> { + typedef Ref XprType; + + enum { + Flags = evaluator>::Flags, + Alignment = evaluator>::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& ref) + : mapbase_evaluator(ref) {} +}; + +// -------------------- Block -------------------- + +template ::ret> +struct block_evaluator; + +template +struct evaluator> + : block_evaluator { + typedef Block XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types once we can handle multi-sized packet types + typedef typename packet_traits::type PacketScalar; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime, + + ArgTypeIsRowMajor = (int(evaluator::Flags) & RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime == 1 && MaxColsAtCompileTime != 1) ? 1 + : (MaxColsAtCompileTime == 1 && MaxRowsAtCompileTime != 1) ? 0 + : ArgTypeIsRowMajor, + HasSameStorageOrderAsArgType = (IsRowMajor == ArgTypeIsRowMajor), + InnerSize = IsRowMajor ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsArgType ? int(inner_stride_at_compile_time::ret) + : int(outer_stride_at_compile_time::ret), + OuterStrideAtCompileTime = HasSameStorageOrderAsArgType ? int(outer_stride_at_compile_time::ret) + : int(inner_stride_at_compile_time::ret), + MaskPacketAccessBit = (InnerStrideAtCompileTime == 1 || HasSameStorageOrderAsArgType) ? PacketAccessBit : 0, + + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1 || + (InnerPanel && (evaluator::Flags & LinearAccessBit))) + ? LinearAccessBit + : 0, + FlagsRowMajorBit = XprType::Flags & RowMajorBit, + Flags0 = evaluator::Flags & ((HereditaryBits & ~RowMajorBit) | DirectAccessBit | MaskPacketAccessBit), + Flags = Flags0 | FlagsLinearAccessBit | FlagsRowMajorBit, + + PacketAlignment = unpacket_traits::alignment, + Alignment0 = (InnerPanel && (OuterStrideAtCompileTime != Dynamic) && (OuterStrideAtCompileTime != 0) && + (((OuterStrideAtCompileTime * int(sizeof(Scalar))) % int(PacketAlignment)) == 0)) + ? int(PacketAlignment) + : 0, + Alignment = plain_enum_min(evaluator::Alignment, Alignment0) + }; + typedef block_evaluator block_evaluator_type; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& block) : block_evaluator_type(block) { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } +}; + +// no direct-access => dispatch to a unary evaluator +template +struct block_evaluator + : unary_evaluator> { + typedef Block XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit block_evaluator(const XprType& block) + : unary_evaluator(block) {} +}; + +template +struct unary_evaluator, IndexBased> + : evaluator_base> { + typedef Block XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit unary_evaluator(const XprType& block) + : m_argImpl(block.nestedExpression()), + m_startRow(block.startRow()), + m_startCol(block.startCol()), + m_linear_offset(ForwardLinearAccess + ? (ArgType::IsRowMajor + ? block.startRow() * block.nestedExpression().cols() + block.startCol() + : block.startCol() * block.nestedExpression().rows() + block.startRow()) + : 0) {} + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + RowsAtCompileTime = XprType::RowsAtCompileTime, + ForwardLinearAccess = (InnerPanel || int(XprType::IsRowMajor) == int(ArgType::IsRowMajor)) && + bool(evaluator::Flags & LinearAccessBit) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_argImpl.coeff(m_startRow.value() + row, m_startCol.value() + col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + return linear_coeff_impl(index, bool_constant()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { + return m_argImpl.coeffRef(m_startRow.value() + row, m_startCol.value() + col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { + return linear_coeffRef_impl(index, bool_constant()); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + return m_argImpl.template packet(m_startRow.value() + row, m_startCol.value() + col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + if (ForwardLinearAccess) + return m_argImpl.template packet(m_linear_offset.value() + index); + else + return packet(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index row, Index col, const PacketType& x) { + return m_argImpl.template writePacket(m_startRow.value() + row, m_startCol.value() + col, x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index index, const PacketType& x) { + if (ForwardLinearAccess) + return m_argImpl.template writePacket(m_linear_offset.value() + index, x); + else + return writePacket(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0, + x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + return m_argImpl.template packetSegment(m_startRow.value() + row, m_startCol.value() + col, + begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + if (ForwardLinearAccess) + return m_argImpl.template packetSegment(m_linear_offset.value() + index, begin, count); + else + return packetSegment(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0, + begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index row, Index col, const PacketType& x, Index begin, + Index count) { + return m_argImpl.template writePacketSegment(m_startRow.value() + row, + m_startCol.value() + col, x, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index index, const PacketType& x, Index begin, + Index count) { + if (ForwardLinearAccess) + return m_argImpl.template writePacketSegment(m_linear_offset.value() + index, x, begin, + count); + else + return writePacketSegment(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0, x, begin, count); + } + + protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType + linear_coeff_impl(Index index, internal::true_type /* ForwardLinearAccess */) const { + return m_argImpl.coeff(m_linear_offset.value() + index); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType + linear_coeff_impl(Index index, internal::false_type /* not ForwardLinearAccess */) const { + return coeff(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& linear_coeffRef_impl(Index index, + internal::true_type /* ForwardLinearAccess */) { + return m_argImpl.coeffRef(m_linear_offset.value() + index); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& linear_coeffRef_impl( + Index index, internal::false_type /* not ForwardLinearAccess */) { + return coeffRef(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0); + } + + evaluator m_argImpl; + const variable_if_dynamic m_startRow; + const variable_if_dynamic m_startCol; + const variable_if_dynamic m_linear_offset; +}; + +// TODO: This evaluator does not actually use the child evaluator; +// all action is via the data() as returned by the Block expression. + +template +struct block_evaluator + : mapbase_evaluator, + typename Block::PlainObject> { + typedef Block XprType; + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit block_evaluator(const XprType& block) + : mapbase_evaluator(block) { + eigen_internal_assert((internal::is_constant_evaluated() || + (std::uintptr_t(block.data()) % plain_enum_max(1, evaluator::Alignment)) == 0) && + "data is not aligned"); + } +}; + +// -------------------- Replicate -------------------- + +template +struct unary_evaluator> + : evaluator_base> { + typedef Replicate XprType; + typedef typename XprType::CoeffReturnType CoeffReturnType; + enum { Factor = (RowFactor == Dynamic || ColFactor == Dynamic) ? Dynamic : RowFactor * ColFactor }; + typedef typename nested_eval::type ArgTypeNested; + typedef remove_all_t ArgTypeNestedCleaned; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + LinearAccessMask = XprType::IsVectorAtCompileTime ? LinearAccessBit : 0, + Flags = (evaluator::Flags & (HereditaryBits | LinearAccessMask) & ~RowMajorBit) | + (traits::Flags & RowMajorBit), + + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit unary_evaluator(const XprType& replicate) + : m_arg(replicate.nestedExpression()), + m_argImpl(m_arg), + m_rows(replicate.nestedExpression().rows()), + m_cols(replicate.nestedExpression().cols()) {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + // try to avoid using modulo; this is a pure optimization strategy + const Index actual_row = traits::RowsAtCompileTime == 1 ? 0 : RowFactor == 1 ? row : row % m_rows.value(); + const Index actual_col = traits::ColsAtCompileTime == 1 ? 0 : ColFactor == 1 ? col : col % m_cols.value(); + + return m_argImpl.coeff(actual_row, actual_col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + // try to avoid using modulo; this is a pure optimization strategy + const Index actual_index = traits::RowsAtCompileTime == 1 + ? (ColFactor == 1 ? index : index % m_cols.value()) + : (RowFactor == 1 ? index : index % m_rows.value()); + + return m_argImpl.coeff(actual_index); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + const Index actual_row = traits::RowsAtCompileTime == 1 ? 0 : RowFactor == 1 ? row : row % m_rows.value(); + const Index actual_col = traits::ColsAtCompileTime == 1 ? 0 : ColFactor == 1 ? col : col % m_cols.value(); + + return m_argImpl.template packet(actual_row, actual_col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + const Index actual_index = traits::RowsAtCompileTime == 1 + ? (ColFactor == 1 ? index : index % m_cols.value()) + : (RowFactor == 1 ? index : index % m_rows.value()); + + return m_argImpl.template packet(actual_index); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + const Index actual_row = traits::RowsAtCompileTime == 1 ? 0 : RowFactor == 1 ? row : row % m_rows.value(); + const Index actual_col = traits::ColsAtCompileTime == 1 ? 0 : ColFactor == 1 ? col : col % m_cols.value(); + + return m_argImpl.template packetSegment(actual_row, actual_col, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + const Index actual_index = traits::RowsAtCompileTime == 1 + ? (ColFactor == 1 ? index : index % m_cols.value()) + : (RowFactor == 1 ? index : index % m_rows.value()); + + return m_argImpl.template packetSegment(actual_index, begin, count); + } + + protected: + const ArgTypeNested m_arg; + evaluator m_argImpl; + const variable_if_dynamic m_rows; + const variable_if_dynamic m_cols; +}; + +// -------------------- MatrixWrapper and ArrayWrapper -------------------- +// +// evaluator_wrapper_base is a common base class for the +// MatrixWrapper and ArrayWrapper evaluators. + +template +struct evaluator_wrapper_base : evaluator_base { + typedef remove_all_t ArgType; + enum { + CoeffReadCost = evaluator::CoeffReadCost, + Flags = evaluator::Flags, + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator_wrapper_base(const ArgType& arg) : m_argImpl(arg) {} + + typedef typename ArgType::Scalar Scalar; + typedef typename ArgType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_argImpl.coeff(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { return m_argImpl.coeff(index); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { return m_argImpl.coeffRef(row, col); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { return m_argImpl.coeffRef(index); } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + return m_argImpl.template packet(row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + return m_argImpl.template packet(index); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index row, Index col, const PacketType& x) { + m_argImpl.template writePacket(row, col, x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index index, const PacketType& x) { + m_argImpl.template writePacket(index, x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + return m_argImpl.template packetSegment(row, col, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + return m_argImpl.template packetSegment(index, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index row, Index col, const PacketType& x, Index begin, + Index count) { + m_argImpl.template writePacketSegment(row, col, x, begin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index index, const PacketType& x, Index begin, + Index count) { + m_argImpl.template writePacketSegment(index, x, begin, count); + } + + protected: + evaluator m_argImpl; +}; + +template +struct unary_evaluator> : evaluator_wrapper_base> { + typedef MatrixWrapper XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit unary_evaluator(const XprType& wrapper) + : evaluator_wrapper_base>(wrapper.nestedExpression()) {} +}; + +template +struct unary_evaluator> : evaluator_wrapper_base> { + typedef ArrayWrapper XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit unary_evaluator(const XprType& wrapper) + : evaluator_wrapper_base>(wrapper.nestedExpression()) {} +}; + +// -------------------- Reverse -------------------- + +// defined in Reverse.h: +template +struct reverse_packet_cond; + +template +struct unary_evaluator> : evaluator_base> { + typedef Reverse XprType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = XprType::IsRowMajor, + IsColMajor = !IsRowMajor, + ReverseRow = (Direction == Vertical) || (Direction == BothDirections), + ReverseCol = (Direction == Horizontal) || (Direction == BothDirections), + ReversePacket = (Direction == BothDirections) || ((Direction == Vertical) && IsColMajor) || + ((Direction == Horizontal) && IsRowMajor), + + CoeffReadCost = evaluator::CoeffReadCost, + + // let's enable LinearAccess only with vectorization because of the product overhead + // FIXME enable DirectAccess with negative strides? + Flags0 = evaluator::Flags, + LinearAccess = + ((Direction == BothDirections) && (int(Flags0) & PacketAccessBit)) || + ((ReverseRow && XprType::ColsAtCompileTime == 1) || (ReverseCol && XprType::RowsAtCompileTime == 1)) + ? LinearAccessBit + : 0, + + Flags = int(Flags0) & (HereditaryBits | PacketAccessBit | LinearAccess), + + Alignment = 0 // FIXME in some rare cases, Alignment could be preserved, like a Vector4f. + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit unary_evaluator(const XprType& reverse) + : m_argImpl(reverse.nestedExpression()), + m_rows(ReverseRow ? reverse.nestedExpression().rows() : 1), + m_cols(ReverseCol ? reverse.nestedExpression().cols() : 1) {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + return m_argImpl.coeff(ReverseRow ? m_rows.value() - row - 1 : row, ReverseCol ? m_cols.value() - col - 1 : col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + return m_argImpl.coeff(m_rows.value() * m_cols.value() - index - 1); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { + return m_argImpl.coeffRef(ReverseRow ? m_rows.value() - row - 1 : row, ReverseCol ? m_cols.value() - col - 1 : col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { + return m_argImpl.coeffRef(m_rows.value() * m_cols.value() - index - 1); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1; + static constexpr int OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1; + using reverse_packet = reverse_packet_cond; + + Index actualRow = ReverseRow ? m_rows.value() - row - OffsetRow : row; + Index actualCol = ReverseCol ? m_cols.value() - col - OffsetCol : col; + + return reverse_packet::run(m_argImpl.template packet(actualRow, actualCol)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + static constexpr int PacketSize = unpacket_traits::size; + + Index actualIndex = m_rows.value() * m_cols.value() - index - PacketSize; + + return preverse(m_argImpl.template packet(actualIndex)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index row, Index col, const PacketType& x) { + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1; + static constexpr int OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1; + using reverse_packet = reverse_packet_cond; + + Index actualRow = ReverseRow ? m_rows.value() - row - OffsetRow : row; + Index actualCol = ReverseCol ? m_cols.value() - col - OffsetCol : col; + + m_argImpl.template writePacket(actualRow, actualCol, reverse_packet::run(x)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacket(Index index, const PacketType& x) { + static constexpr int PacketSize = unpacket_traits::size; + + Index actualIndex = m_rows.value() * m_cols.value() - index - PacketSize; + + m_argImpl.template writePacket(actualIndex, preverse(x)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1; + static constexpr int OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1; + using reverse_packet = reverse_packet_cond; + + Index actualRow = ReverseRow ? m_rows.value() - row - OffsetRow : row; + Index actualCol = ReverseCol ? m_cols.value() - col - OffsetCol : col; + Index actualBegin = ReversePacket ? (PacketSize - count - begin) : begin; + + return reverse_packet::run( + m_argImpl.template packetSegment(actualRow, actualCol, actualBegin, count)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + static constexpr int PacketSize = unpacket_traits::size; + + Index actualIndex = m_rows.value() * m_cols.value() - index - PacketSize; + Index actualBegin = PacketSize - count - begin; + + return preverse(m_argImpl.template packetSegment(actualIndex, actualBegin, count)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index row, Index col, const PacketType& x, Index begin, + Index count) { + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1; + static constexpr int OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1; + using reverse_packet = reverse_packet_cond; + + Index actualRow = ReverseRow ? m_rows.value() - row - OffsetRow : row; + Index actualCol = ReverseCol ? m_cols.value() - col - OffsetCol : col; + Index actualBegin = ReversePacket ? (PacketSize - count - begin) : begin; + + m_argImpl.template writePacketSegment(actualRow, actualCol, reverse_packet::run(x), actualBegin, count); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void writePacketSegment(Index index, const PacketType& x, Index begin, + Index count) { + static constexpr int PacketSize = unpacket_traits::size; + + Index actualIndex = m_rows.value() * m_cols.value() - index - PacketSize; + Index actualBegin = PacketSize - count - begin; + + m_argImpl.template writePacketSegment(actualIndex, preverse(x), actualBegin, count); + } + + protected: + evaluator m_argImpl; + + // If we do not reverse rows, then we do not need to know the number of rows; same for columns + // Nonetheless, in this case it is important to set to 1 such that the coeff(index) method works fine for vectors. + const variable_if_dynamic m_rows; + const variable_if_dynamic m_cols; +}; + +// -------------------- Diagonal -------------------- + +template +struct evaluator> : evaluator_base> { + typedef Diagonal XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + + Flags = + (unsigned int)(evaluator::Flags & (HereditaryBits | DirectAccessBit) & ~RowMajorBit) | LinearAccessBit, + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& diagonal) + : m_argImpl(diagonal.nestedExpression()), m_index(diagonal.index()) {} + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index) const { + return m_argImpl.coeff(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index index) const { + return m_argImpl.coeff(index + rowOffset(), index + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index) { + return m_argImpl.coeffRef(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { + return m_argImpl.coeffRef(index + rowOffset(), index + colOffset()); + } + + protected: + evaluator m_argImpl; + const variable_if_dynamicindex m_index; + + private: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rowOffset() const { + return m_index.value() > 0 ? 0 : -m_index.value(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index colOffset() const { + return m_index.value() > 0 ? m_index.value() : 0; + } +}; + +//---------------------------------------------------------------------- +// deprecated code +//---------------------------------------------------------------------- + +// -------------------- EvalToTemp -------------------- + +// expression class for evaluating nested expression to a temporary + +template +class EvalToTemp; + +template +struct traits> : public traits {}; + +template +class EvalToTemp : public dense_xpr_base>::type { + public: + typedef typename dense_xpr_base::type Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(EvalToTemp) + + explicit EvalToTemp(const ArgType& arg) : m_arg(arg) {} + + const ArgType& arg() const { return m_arg; } + + constexpr Index rows() const noexcept { return m_arg.rows(); } + + constexpr Index cols() const noexcept { return m_arg.cols(); } + + private: + const ArgType& m_arg; +}; + +template +struct evaluator> : public evaluator { + typedef EvalToTemp XprType; + typedef typename ArgType::PlainObject PlainObject; + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) : m_result(xpr.arg()) { + internal::construct_at(this, m_result); + } + + // This constructor is used when nesting an EvalTo evaluator in another evaluator + EIGEN_DEVICE_FUNC evaluator(const ArgType& arg) : m_result(arg) { internal::construct_at(this, m_result); } + + protected: + PlainObject m_result; +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_COREEVALUATORS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CoreIterators.h b/src/3rdparty/eigen/Eigen/src/Core/CoreIterators.h new file mode 100644 index 0000000..f62cf23 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CoreIterators.h @@ -0,0 +1,141 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_COREITERATORS_H +#define EIGEN_COREITERATORS_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/* This file contains the respective InnerIterator definition of the expressions defined in Eigen/Core + */ + +namespace internal { + +template +class inner_iterator_selector; + +} + +/** \class InnerIterator + * \brief An InnerIterator allows to loop over the element of any matrix expression. + * + * \warning To be used with care because an evaluator is constructed every time an InnerIterator iterator is + * constructed. + * + * TODO: add a usage example + */ +template +class InnerIterator { + protected: + typedef internal::inner_iterator_selector::Kind> IteratorType; + typedef internal::evaluator EvaluatorType; + typedef typename internal::traits::Scalar Scalar; + + public: + /** Construct an iterator over the \a outerId -th row or column of \a xpr */ + InnerIterator(const XprType &xpr, const Index &outerId) : m_eval(xpr), m_iter(m_eval, outerId, xpr.innerSize()) {} + + /// \returns the value of the current coefficient. + EIGEN_STRONG_INLINE Scalar value() const { return m_iter.value(); } + /** Increment the iterator \c *this to the next non-zero coefficient. + * Explicit zeros are not skipped over. To skip explicit zeros, see class SparseView + */ + EIGEN_STRONG_INLINE InnerIterator &operator++() { + m_iter.operator++(); + return *this; + } + EIGEN_STRONG_INLINE InnerIterator &operator+=(Index i) { + m_iter.operator+=(i); + return *this; + } + EIGEN_STRONG_INLINE InnerIterator operator+(Index i) { + InnerIterator result(*this); + result += i; + return result; + } + + /// \returns the column or row index of the current coefficient. + EIGEN_STRONG_INLINE Index index() const { return m_iter.index(); } + /// \returns the row index of the current coefficient. + EIGEN_STRONG_INLINE Index row() const { return m_iter.row(); } + /// \returns the column index of the current coefficient. + EIGEN_STRONG_INLINE Index col() const { return m_iter.col(); } + /// \returns \c true if the iterator \c *this still references a valid coefficient. + EIGEN_STRONG_INLINE operator bool() const { return m_iter; } + + protected: + EvaluatorType m_eval; + IteratorType m_iter; + + private: + // If you get here, then you're not using the right InnerIterator type, e.g.: + // SparseMatrix A; + // SparseMatrix::InnerIterator it(A,0); + template + InnerIterator(const EigenBase &, Index outer); +}; + +namespace internal { + +// Generic inner iterator implementation for dense objects +template +class inner_iterator_selector { + protected: + typedef evaluator EvaluatorType; + typedef typename traits::Scalar Scalar; + enum { IsRowMajor = (XprType::Flags & RowMajorBit) == RowMajorBit }; + + public: + EIGEN_STRONG_INLINE inner_iterator_selector(const EvaluatorType &eval, const Index &outerId, const Index &innerSize) + : m_eval(eval), m_inner(0), m_outer(outerId), m_end(innerSize) {} + + EIGEN_STRONG_INLINE Scalar value() const { + return (IsRowMajor) ? m_eval.coeff(m_outer, m_inner) : m_eval.coeff(m_inner, m_outer); + } + + EIGEN_STRONG_INLINE inner_iterator_selector &operator++() { + m_inner++; + return *this; + } + + EIGEN_STRONG_INLINE Index index() const { return m_inner; } + inline Index row() const { return IsRowMajor ? m_outer : index(); } + inline Index col() const { return IsRowMajor ? index() : m_outer; } + + EIGEN_STRONG_INLINE operator bool() const { return m_inner < m_end && m_inner >= 0; } + + protected: + const EvaluatorType &m_eval; + Index m_inner; + const Index m_outer; + const Index m_end; +}; + +// For iterator-based evaluator, inner-iterator is already implemented as +// evaluator<>::InnerIterator +template +class inner_iterator_selector : public evaluator::InnerIterator { + protected: + typedef typename evaluator::InnerIterator Base; + typedef evaluator EvaluatorType; + + public: + EIGEN_STRONG_INLINE inner_iterator_selector(const EvaluatorType &eval, const Index &outerId, + const Index & /*innerSize*/) + : Base(eval, outerId) {} +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_COREITERATORS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseBinaryOp.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseBinaryOp.h new file mode 100644 index 0000000..e2b2da5 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseBinaryOp.h @@ -0,0 +1,166 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_BINARY_OP_H +#define EIGEN_CWISE_BINARY_OP_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits> { + // we must not inherit from traits since it has + // the potential to cause problems with MSVC + typedef remove_all_t Ancestor; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime + }; + + // even though we require Lhs and Rhs to have the same scalar type (see CwiseBinaryOp constructor), + // we still want to handle the case when the result type is different. + typedef typename result_of::type Scalar; + typedef typename cwise_promote_storage_type::StorageKind, typename traits::StorageKind, + BinaryOp>::ret StorageKind; + typedef typename promote_index_type::StorageIndex, typename traits::StorageIndex>::type + StorageIndex; + typedef typename Lhs::Nested LhsNested; + typedef typename Rhs::Nested RhsNested; + typedef std::remove_reference_t LhsNested_; + typedef std::remove_reference_t RhsNested_; + enum { + Flags = cwise_promote_storage_order::StorageKind, typename traits::StorageKind, + LhsNested_::Flags & RowMajorBit, RhsNested_::Flags & RowMajorBit>::value + }; +}; +} // end namespace internal + +template +class CwiseBinaryOpImpl; + +/** \class CwiseBinaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise binary operator is applied to two expressions + * + * \tparam BinaryOp template functor implementing the operator + * \tparam LhsType the type of the left-hand side + * \tparam RhsType the type of the right-hand side + * + * This class represents an expression where a coefficient-wise binary operator is applied to two expressions. + * It is the return type of binary operators, by which we mean only those binary operators where + * both the left-hand side and the right-hand side are Eigen expressions. + * For example, the return type of matrix1+matrix2 is a CwiseBinaryOp. + * + * Most of the time, this is the only way that it is used, so you typically don't have to name + * CwiseBinaryOp types explicitly. + * + * \sa MatrixBase::binaryExpr(const MatrixBase &,const CustomBinaryOp &) const, class CwiseUnaryOp, class + * CwiseNullaryOp + */ +template +class CwiseBinaryOp : public CwiseBinaryOpImpl::StorageKind, + typename internal::traits::StorageKind, BinaryOp>::ret>, + internal::no_assignment_operator { + public: + typedef internal::remove_all_t Functor; + typedef internal::remove_all_t Lhs; + typedef internal::remove_all_t Rhs; + + typedef typename CwiseBinaryOpImpl< + BinaryOp, LhsType, RhsType, + typename internal::cwise_promote_storage_type::StorageKind, + typename internal::traits::StorageKind, BinaryOp>::ret>::Base + Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseBinaryOp) + + EIGEN_CHECK_BINARY_COMPATIBILIY(BinaryOp, typename Lhs::Scalar, typename Rhs::Scalar) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Lhs, Rhs) + + typedef typename internal::ref_selector::type LhsNested; + typedef typename internal::ref_selector::type RhsNested; + typedef std::remove_reference_t LhsNested_; + typedef std::remove_reference_t RhsNested_; + +#if EIGEN_COMP_MSVC + // Required for Visual Studio or the Copy constructor will probably not get inlined! + EIGEN_STRONG_INLINE CwiseBinaryOp(const CwiseBinaryOp&) = default; +#endif + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CwiseBinaryOp(const Lhs& aLhs, const Rhs& aRhs, + const BinaryOp& func = BinaryOp()) + : m_lhs(aLhs), m_rhs(aRhs), m_functor(func) { + eigen_assert(aLhs.rows() == aRhs.rows() && aLhs.cols() == aRhs.cols()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const noexcept { + // return the fixed size type if available to enable compile time optimizations + return internal::traits>::RowsAtCompileTime == Dynamic ? m_rhs.rows() + : m_lhs.rows(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const noexcept { + // return the fixed size type if available to enable compile time optimizations + return internal::traits>::ColsAtCompileTime == Dynamic ? m_rhs.cols() + : m_lhs.cols(); + } + + /** \returns the left hand side nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const LhsNested_& lhs() const { return m_lhs; } + /** \returns the right hand side nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const RhsNested_& rhs() const { return m_rhs; } + /** \returns the functor representing the binary operation */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const BinaryOp& functor() const { return m_functor; } + + protected: + LhsNested m_lhs; + RhsNested m_rhs; + const BinaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseBinaryOpImpl : public internal::generic_xpr_base>::type { + public: + typedef typename internal::generic_xpr_base>::type Base; +}; + +/** replaces \c *this by \c *this - \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::operator-=(const MatrixBase& other) { + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this + \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::operator+=(const MatrixBase& other) { + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_CWISE_BINARY_OP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseNullaryOp.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseNullaryOp.h new file mode 100644 index 0000000..084f503 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseNullaryOp.h @@ -0,0 +1,975 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_NULLARY_OP_H +#define EIGEN_CWISE_NULLARY_OP_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > : traits { + enum { Flags = traits::Flags & RowMajorBit }; +}; + +} // namespace internal + +/** \class CwiseNullaryOp + * \ingroup Core_Module + * + * \brief Generic expression of a matrix where all coefficients are defined by a functor + * + * \tparam NullaryOp template functor implementing the operator + * \tparam PlainObjectType the underlying plain matrix/array type + * + * This class represents an expression of a generic nullary operator. + * It is the return type of the Ones(), Zero(), Constant(), Identity() and Random() methods, + * and most of the time this is the only way it is used. + * + * However, if you want to write a function returning such an expression, you + * will need to use this class. + * + * The functor NullaryOp must expose one of the following method: + + +
\c operator()() if the procedural generation does not depend on the coefficient entries + (e.g., random numbers)
\c operator()(Index i)if the procedural generation makes + sense for vectors only and that it depends on the coefficient index \c i (e.g., linspace)
\c + operator()(Index i,Index j)if the procedural generation depends on the matrix coordinates \c i, \c j (e.g., + to generate a checkerboard with 0 and 1)
+ * It is also possible to expose the last two operators if the generation makes sense for matrices but can be optimized + for vectors. + * + * See DenseBase::NullaryExpr(Index,const CustomNullaryOp&) for an example binding + * C++11 random number generators. + * + * A nullary expression can also be used to implement custom sophisticated matrix manipulations + * that cannot be covered by the existing set of natively supported matrix manipulations. + * See this \ref TopicCustomizing_NullaryExpr "page" for some examples and additional explanations + * on the behavior of CwiseNullaryOp. + * + * \sa class CwiseUnaryOp, class CwiseBinaryOp, DenseBase::NullaryExpr + */ +template +class CwiseNullaryOp : public internal::dense_xpr_base >::type, + internal::no_assignment_operator { + public: + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(CwiseNullaryOp) + + EIGEN_DEVICE_FUNC CwiseNullaryOp(Index rows, Index cols, const NullaryOp& func = NullaryOp()) + : m_rows(rows), m_cols(cols), m_functor(func) { + eigen_assert(rows >= 0 && (RowsAtCompileTime == Dynamic || RowsAtCompileTime == rows) && cols >= 0 && + (ColsAtCompileTime == Dynamic || ColsAtCompileTime == cols)); + } + EIGEN_DEVICE_FUNC CwiseNullaryOp(Index size, const NullaryOp& func = NullaryOp()) + : CwiseNullaryOp(RowsAtCompileTime == 1 ? 1 : size, RowsAtCompileTime == 1 ? size : 1, func) { + EIGEN_STATIC_ASSERT(CwiseNullaryOp::IsVectorAtCompileTime, YOU_TRIED_CALLING_A_VECTOR_METHOD_ON_A_MATRIX); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return m_rows.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return m_cols.value(); } + + /** \returns the functor representing the nullary operation */ + EIGEN_DEVICE_FUNC const NullaryOp& functor() const { return m_functor; } + + protected: + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; + const NullaryOp m_functor; +}; + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so NullaryExpr(const CustomNullaryOp&) should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN + const CwiseNullaryOp::PlainObject> +#else + const CwiseNullaryOp +#endif + DenseBase::NullaryExpr(Index rows, Index cols, const CustomNullaryOp& func) { + return CwiseNullaryOp(rows, cols, func); +} + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so NullaryExpr(const CustomNullaryOp&) should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * Here is an example with C++11 random generators: \include random_cpp11.cpp + * Output: \verbinclude random_cpp11.out + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN + const CwiseNullaryOp::PlainObject> +#else + const CwiseNullaryOp +#endif + DenseBase::NullaryExpr(Index size, const CustomNullaryOp& func) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + if (RowsAtCompileTime == 1) + return CwiseNullaryOp(1, size, func); + else + return CwiseNullaryOp(size, 1, func); +} + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * This variant is only for fixed-size DenseBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN + const CwiseNullaryOp::PlainObject> +#else + const CwiseNullaryOp +#endif + DenseBase::NullaryExpr(const CustomNullaryOp& func) { + return CwiseNullaryOp(RowsAtCompileTime, ColsAtCompileTime, func); +} + +/** \returns an expression of a constant matrix of value \a value + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this DenseBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Constant(const Scalar&) should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(Index rows, Index cols, const Scalar& value) { + return DenseBase::NullaryExpr(rows, cols, internal::scalar_constant_op(value)); +} + +/** \returns an expression of a constant matrix of value \a value + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this DenseBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Constant(const Scalar&) should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(Index size, const Scalar& value) { + return DenseBase::NullaryExpr(size, internal::scalar_constant_op(value)); +} + +/** \returns an expression of a constant matrix of value \a value + * + * This variant is only for fixed-size DenseBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(const Scalar& value) { + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, + internal::scalar_constant_op(value)); +} + +/** \deprecated because of accuracy loss. In Eigen 3.3, it is an alias for LinSpaced(Index,const Scalar&,const Scalar&) + * + * \only_for_vectors + * + * Example: \include DenseBase_LinSpaced_seq_deprecated.cpp + * Output: \verbinclude DenseBase_LinSpaced_seq_deprecated.out + * + * \sa LinSpaced(Index,const Scalar&, const Scalar&), setLinSpaced(Index,const Scalar&,const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Sequential_t, Index size, const Scalar& low, const Scalar& high) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return DenseBase::NullaryExpr(size, internal::linspaced_op(low, high, size)); +} + +/** \deprecated because of accuracy loss. In Eigen 3.3, it is an alias for LinSpaced(const Scalar&,const Scalar&) + * + * \sa LinSpaced(const Scalar&, const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Sequential_t, const Scalar& low, const Scalar& high) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(Derived::SizeAtCompileTime, + internal::linspaced_op(low, high, Derived::SizeAtCompileTime)); +} + +/** + * \brief Sets a linearly spaced vector. + * + * The function generates 'size' equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * Example: \include DenseBase_LinSpaced.cpp + * Output: \verbinclude DenseBase_LinSpaced.out + * + * For integer scalar types, an even spacing is possible if and only if the length of the range, + * i.e., \c high-low is a scalar multiple of \c size-1, or if \c size is a scalar multiple of the + * number of values \c high-low+1 (meaning each value can be repeated the same number of time). + * If one of these two considions is not satisfied, then \c high is lowered to the largest value + * satisfying one of this constraint. + * Here are some examples: + * + * Example: \include DenseBase_LinSpacedInt.cpp + * Output: \verbinclude DenseBase_LinSpacedInt.out + * + * \sa setLinSpaced(Index,const Scalar&,const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Index size, const Scalar& low, const Scalar& high) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return DenseBase::NullaryExpr(size, internal::linspaced_op(low, high, size)); +} + +/** + * \copydoc DenseBase::LinSpaced(Index, const DenseBase::Scalar&, const DenseBase::Scalar&) + * Special version for fixed size types which does not require the size parameter. + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(const Scalar& low, const Scalar& high) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(Derived::SizeAtCompileTime, + internal::linspaced_op(low, high, Derived::SizeAtCompileTime)); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessEqualSpacedReturnType +DenseBase::EqualSpaced(Index size, const Scalar& low, const Scalar& step) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return DenseBase::NullaryExpr(size, internal::equalspaced_op(low, step)); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessEqualSpacedReturnType +DenseBase::EqualSpaced(const Scalar& low, const Scalar& step) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return DenseBase::NullaryExpr(Derived::SizeAtCompileTime, internal::equalspaced_op(low, step)); +} + +/** \returns true if all coefficients in this matrix are approximately equal to \a val, to within precision \a prec */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isApproxToConstant(const Scalar& val, const RealScalar& prec) const { + typename internal::nested_eval::type self(derived()); + for (Index j = 0; j < cols(); ++j) + for (Index i = 0; i < rows(); ++i) + if (!internal::isApprox(self.coeff(i, j), val, prec)) return false; + return true; +} + +/** This is just an alias for isApproxToConstant(). + * + * \returns true if all coefficients in this matrix are approximately equal to \a value, to within precision \a prec */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isConstant(const Scalar& val, const RealScalar& prec) const { + return isApproxToConstant(val, prec); +} + +/** Alias for setConstant(): sets all coefficients in this expression to \a val. + * + * \sa setConstant(), Constant(), class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void DenseBase::fill(const Scalar& val) { + setConstant(val); +} + +/** Sets all coefficients in this expression to value \a val. + * + * \sa fill(), setConstant(Index,const Scalar&), setConstant(Index,Index,const Scalar&), setZero(), setOnes(), + * Constant(), class CwiseNullaryOp, setZero(), setOnes() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setConstant(const Scalar& val) { + internal::eigen_fill_impl::run(derived(), val); + return derived(); +} + +/** Resizes to the given \a size, and sets all coefficients in this expression to the given value \a val. + * + * \only_for_vectors + * + * Example: \include Matrix_setConstant_int.cpp + * Output: \verbinclude Matrix_setConstant_int.out + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,Index,const Scalar&), class CwiseNullaryOp, + * MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setConstant(Index size, const Scalar& val) { + resize(size); + return setConstant(val); +} + +/** Resizes to the given size, and sets all coefficients in this expression to the given value \a val. + * + * \param rows the new number of rows + * \param cols the new number of columns + * \param val the value to which all coefficients are set + * + * Example: \include Matrix_setConstant_int_int.cpp + * Output: \verbinclude Matrix_setConstant_int_int.out + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, + * MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setConstant(Index rows, Index cols, + const Scalar& val) { + resize(rows, cols); + return setConstant(val); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to the given value \a val. For the parameter + * of type NoChange_t, just pass the special value \c NoChange. + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, + * MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setConstant(NoChange_t, Index cols, + const Scalar& val) { + return setConstant(rows(), cols, val); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to the given value \a val. For the parameter + * of type NoChange_t, just pass the special value \c NoChange. + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, + * MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setConstant(Index rows, NoChange_t, + const Scalar& val) { + return setConstant(rows, cols(), val); +} + +/** + * \brief Sets a linearly spaced vector. + * + * The function generates 'size' equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * Example: \include DenseBase_setLinSpaced.cpp + * Output: \verbinclude DenseBase_setLinSpaced.out + * + * For integer scalar types, do not miss the explanations on the definition + * of \link LinSpaced(Index,const Scalar&,const Scalar&) even spacing \endlink. + * + * \sa LinSpaced(Index,const Scalar&,const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setLinSpaced(Index newSize, const Scalar& low, + const Scalar& high) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return derived() = Derived::NullaryExpr(newSize, internal::linspaced_op(low, high, newSize)); +} + +/** + * \brief Sets a linearly spaced vector. + * + * The function fills \c *this with equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * For integer scalar types, do not miss the explanations on the definition + * of \link LinSpaced(Index,const Scalar&,const Scalar&) even spacing \endlink. + * + * \sa LinSpaced(Index,const Scalar&,const Scalar&), setLinSpaced(Index, const Scalar&, const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setLinSpaced(const Scalar& low, const Scalar& high) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return setLinSpaced(size(), low, high); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setEqualSpaced(Index newSize, const Scalar& low, + const Scalar& step) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return derived() = Derived::NullaryExpr(newSize, internal::equalspaced_op(low, step)); +} +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setEqualSpaced(const Scalar& low, + const Scalar& step) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return setEqualSpaced(size(), low, step); +} + +// zero: + +/** \returns an expression of a zero matrix. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Zero() should be used + * instead. + * + * Example: \include MatrixBase_zero_int_int.cpp + * Output: \verbinclude MatrixBase_zero_int_int.out + * + * \sa Zero(), Zero(Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ZeroReturnType DenseBase::Zero( + Index rows, Index cols) { + return ZeroReturnType(rows, cols); +} + +/** \returns an expression of a zero vector. + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Zero() should be used + * instead. + * + * Example: \include MatrixBase_zero_int.cpp + * Output: \verbinclude MatrixBase_zero_int.out + * + * \sa Zero(), Zero(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ZeroReturnType DenseBase::Zero( + Index size) { + return ZeroReturnType(size); +} + +/** \returns an expression of a fixed-size zero matrix or vector. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_zero.cpp + * Output: \verbinclude MatrixBase_zero.out + * + * \sa Zero(Index), Zero(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ZeroReturnType DenseBase::Zero() { + return ZeroReturnType(RowsAtCompileTime, ColsAtCompileTime); +} + +/** \returns true if *this is approximately equal to the zero matrix, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isZero.cpp + * Output: \verbinclude MatrixBase_isZero.out + * + * \sa class CwiseNullaryOp, Zero() + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isZero(const RealScalar& prec) const { + typename internal::nested_eval::type self(derived()); + for (Index j = 0; j < cols(); ++j) + for (Index i = 0; i < rows(); ++i) + if (!internal::isMuchSmallerThan(self.coeff(i, j), static_cast(1), prec)) return false; + return true; +} + +/** Sets all coefficients in this expression to zero. + * + * Example: \include MatrixBase_setZero.cpp + * Output: \verbinclude MatrixBase_setZero.out + * + * \sa class CwiseNullaryOp, Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setZero() { + internal::eigen_zero_impl::run(derived()); + return derived(); +} + +/** Resizes to the given \a size, and sets all coefficients in this expression to zero. + * + * \only_for_vectors + * + * Example: \include Matrix_setZero_int.cpp + * Output: \verbinclude Matrix_setZero_int.out + * + * \sa DenseBase::setZero(), setZero(Index,Index), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setZero(Index newSize) { + resize(newSize); + return setZero(); +} + +/** Resizes to the given size, and sets all coefficients in this expression to zero. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setZero_int_int.cpp + * Output: \verbinclude Matrix_setZero_int_int.out + * + * \sa DenseBase::setZero(), setZero(Index), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setZero(Index rows, Index cols) { + resize(rows, cols); + return setZero(); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to zero. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa DenseBase::setZero(), setZero(Index), setZero(Index, Index), setZero(Index, NoChange_t), class CwiseNullaryOp, + * DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setZero(NoChange_t, Index cols) { + return setZero(rows(), cols); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to zero. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa DenseBase::setZero(), setZero(Index), setZero(Index, Index), setZero(NoChange_t, Index), class CwiseNullaryOp, + * DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setZero(Index rows, NoChange_t) { + return setZero(rows, cols()); +} + +// ones: + +/** \returns an expression of a matrix where all coefficients equal one. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Ones() should be used + * instead. + * + * Example: \include MatrixBase_ones_int_int.cpp + * Output: \verbinclude MatrixBase_ones_int_int.out + * + * \sa Ones(), Ones(Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType DenseBase::Ones( + Index rows, Index cols) { + return Constant(rows, cols, Scalar(1)); +} + +/** \returns an expression of a vector where all coefficients equal one. + * + * The parameter \a newSize is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Ones() should be used + * instead. + * + * Example: \include MatrixBase_ones_int.cpp + * Output: \verbinclude MatrixBase_ones_int.out + * + * \sa Ones(), Ones(Index,Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType DenseBase::Ones( + Index newSize) { + return Constant(newSize, Scalar(1)); +} + +/** \returns an expression of a fixed-size matrix or vector where all coefficients equal one. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_ones.cpp + * Output: \verbinclude MatrixBase_ones.out + * + * \sa Ones(Index), Ones(Index,Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType DenseBase::Ones() { + return Constant(Scalar(1)); +} + +/** \returns true if *this is approximately equal to the matrix where all coefficients + * are equal to 1, within the precision given by \a prec. + * + * Example: \include MatrixBase_isOnes.cpp + * Output: \verbinclude MatrixBase_isOnes.out + * + * \sa class CwiseNullaryOp, Ones() + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isOnes(const RealScalar& prec) const { + return isApproxToConstant(Scalar(1), prec); +} + +/** Sets all coefficients in this expression to one. + * + * Example: \include MatrixBase_setOnes.cpp + * Output: \verbinclude MatrixBase_setOnes.out + * + * \sa class CwiseNullaryOp, Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setOnes() { + return setConstant(Scalar(1)); +} + +/** Resizes to the given \a newSize, and sets all coefficients in this expression to one. + * + * \only_for_vectors + * + * Example: \include Matrix_setOnes_int.cpp + * Output: \verbinclude Matrix_setOnes_int.out + * + * \sa MatrixBase::setOnes(), setOnes(Index,Index), class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setOnes(Index newSize) { + resize(newSize); + return setConstant(Scalar(1)); +} + +/** Resizes to the given size, and sets all coefficients in this expression to one. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setOnes_int_int.cpp + * Output: \verbinclude Matrix_setOnes_int_int.out + * + * \sa MatrixBase::setOnes(), setOnes(Index), class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setOnes(Index rows, Index cols) { + resize(rows, cols); + return setConstant(Scalar(1)); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to one. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa MatrixBase::setOnes(), setOnes(Index), setOnes(Index, Index), setOnes(NoChange_t, Index), class CwiseNullaryOp, + * MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setOnes(Index rows, NoChange_t) { + return setOnes(rows, cols()); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to one. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa MatrixBase::setOnes(), setOnes(Index), setOnes(Index, Index), setOnes(Index, NoChange_t) class CwiseNullaryOp, + * MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& PlainObjectBase::setOnes(NoChange_t, Index cols) { + return setOnes(rows(), cols); +} + +// Identity: + +/** \returns an expression of the identity matrix (not necessarily square). + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Identity() should be used + * instead. + * + * Example: \include MatrixBase_identity_int_int.cpp + * Output: \verbinclude MatrixBase_identity_int_int.out + * + * \sa Identity(), setIdentity(), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::IdentityReturnType +MatrixBase::Identity(Index rows, Index cols) { + return DenseBase::NullaryExpr(rows, cols, internal::scalar_identity_op()); +} + +/** \returns an expression of the identity matrix (not necessarily square). + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variant taking size arguments. + * + * Example: \include MatrixBase_identity.cpp + * Output: \verbinclude MatrixBase_identity.out + * + * \sa Identity(Index,Index), setIdentity(), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::IdentityReturnType +MatrixBase::Identity() { + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return MatrixBase::NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, internal::scalar_identity_op()); +} + +/** \returns true if *this is approximately equal to the identity matrix + * (not necessarily square), + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isIdentity.cpp + * Output: \verbinclude MatrixBase_isIdentity.out + * + * \sa class CwiseNullaryOp, Identity(), Identity(Index,Index), setIdentity() + */ +template +bool MatrixBase::isIdentity(const RealScalar& prec) const { + typename internal::nested_eval::type self(derived()); + for (Index j = 0; j < cols(); ++j) { + for (Index i = 0; i < rows(); ++i) { + if (i == j) { + if (!internal::isApprox(self.coeff(i, j), static_cast(1), prec)) return false; + } else { + if (!internal::isMuchSmallerThan(self.coeff(i, j), static_cast(1), prec)) return false; + } + } + } + return true; +} + +namespace internal { + +template = 16)> +struct setIdentity_impl { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Derived& run(Derived& m) { + return m = Derived::Identity(m.rows(), m.cols()); + } +}; + +template +struct setIdentity_impl { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Derived& run(Derived& m) { + m.setZero(); + const Index size = numext::mini(m.rows(), m.cols()); + for (Index i = 0; i < size; ++i) m.coeffRef(i, i) = typename Derived::Scalar(1); + return m; + } +}; + +} // end namespace internal + +/** Writes the identity expression (not necessarily square) into *this. + * + * Example: \include MatrixBase_setIdentity.cpp + * Output: \verbinclude MatrixBase_setIdentity.out + * + * \sa class CwiseNullaryOp, Identity(), Identity(Index,Index), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setIdentity() { + return internal::setIdentity_impl::run(derived()); +} + +/** \brief Resizes to the given size, and writes the identity expression (not necessarily square) into *this. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setIdentity_int_int.cpp + * Output: \verbinclude Matrix_setIdentity_int_int.out + * + * \sa MatrixBase::setIdentity(), class CwiseNullaryOp, MatrixBase::Identity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setIdentity(Index rows, Index cols) { + derived().resize(rows, cols); + return setIdentity(); +} + +/** \returns an expression of the i-th unit (basis) vector. + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index), MatrixBase::UnitX(), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::Unit( + Index newSize, Index i) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return BasisReturnType(SquareMatrixType::Identity(newSize, newSize), i); +} + +/** \returns an expression of the i-th unit (basis) vector. + * + * \only_for_vectors + * + * This variant is for fixed-size vector only. + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::UnitX(), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::Unit( + Index i) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return BasisReturnType(SquareMatrixType::Identity(), i); +} + +/** \returns an expression of the X axis unit vector (1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), + * MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitX() { + return Derived::Unit(0); +} + +/** \returns an expression of the Y axis unit vector (0,1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), + * MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitY() { + return Derived::Unit(1); +} + +/** \returns an expression of the Z axis unit vector (0,0,1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), + * MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitZ() { + return Derived::Unit(2); +} + +/** \returns an expression of the W axis unit vector (0,0,0,1) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), + * MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitW() { + return Derived::Unit(3); +} + +/** \brief Set the coefficients of \c *this to the i-th unit (basis) vector + * + * \param i index of the unique coefficient to be set to 1 + * + * \only_for_vectors + * + * \sa MatrixBase::setIdentity(), class CwiseNullaryOp, MatrixBase::Unit(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setUnit(Index i) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + eigen_assert(i < size()); + derived().setZero(); + derived().coeffRef(i) = Scalar(1); + return derived(); +} + +/** \brief Resizes to the given \a newSize, and writes the i-th unit (basis) vector into *this. + * + * \param newSize the new size of the vector + * \param i index of the unique coefficient to be set to 1 + * + * \only_for_vectors + * + * \sa MatrixBase::setIdentity(), class CwiseNullaryOp, MatrixBase::Unit(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setUnit(Index newSize, Index i) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + eigen_assert(i < newSize); + derived().resize(newSize); + return setUnit(i); +} + +} // end namespace Eigen + +#endif // EIGEN_CWISE_NULLARY_OP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseTernaryOp.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseTernaryOp.h new file mode 100644 index 0000000..9bb0d40 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseTernaryOp.h @@ -0,0 +1,171 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2016 Eugene Brevdo +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_TERNARY_OP_H +#define EIGEN_CWISE_TERNARY_OP_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits> { + // we must not inherit from traits since it has + // the potential to cause problems with MSVC + typedef remove_all_t Ancestor; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime + }; + + // even though we require Arg1, Arg2, and Arg3 to have the same scalar type + // (see CwiseTernaryOp constructor), + // we still want to handle the case when the result type is different. + typedef typename result_of::type Scalar; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + + typedef typename Arg1::Nested Arg1Nested; + typedef typename Arg2::Nested Arg2Nested; + typedef typename Arg3::Nested Arg3Nested; + typedef std::remove_reference_t Arg1Nested_; + typedef std::remove_reference_t Arg2Nested_; + typedef std::remove_reference_t Arg3Nested_; + enum { Flags = Arg1Nested_::Flags & RowMajorBit }; +}; +} // end namespace internal + +template +class CwiseTernaryOpImpl; + +/** \class CwiseTernaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise ternary operator is + * applied to two expressions + * + * \tparam TernaryOp template functor implementing the operator + * \tparam Arg1Type the type of the first argument + * \tparam Arg2Type the type of the second argument + * \tparam Arg3Type the type of the third argument + * + * This class represents an expression where a coefficient-wise ternary + * operator is applied to three expressions. + * It is the return type of ternary operators, by which we mean only those + * ternary operators where + * all three arguments are Eigen expressions. + * For example, the return type of betainc(matrix1, matrix2, matrix3) is a + * CwiseTernaryOp. + * + * Most of the time, this is the only way that it is used, so you typically + * don't have to name + * CwiseTernaryOp types explicitly. + * + * \sa MatrixBase::ternaryExpr(const MatrixBase &, const + * MatrixBase &, const CustomTernaryOp &) const, class CwiseBinaryOp, + * class CwiseUnaryOp, class CwiseNullaryOp + */ +template +class CwiseTernaryOp : public CwiseTernaryOpImpl::StorageKind>, + internal::no_assignment_operator { + public: + typedef internal::remove_all_t Arg1; + typedef internal::remove_all_t Arg2; + typedef internal::remove_all_t Arg3; + + // require the sizes to match + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Arg1, Arg2) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Arg1, Arg3) + + // The index types should match + EIGEN_STATIC_ASSERT((internal::is_same::StorageKind, + typename internal::traits::StorageKind>::value), + STORAGE_KIND_MUST_MATCH) + EIGEN_STATIC_ASSERT((internal::is_same::StorageKind, + typename internal::traits::StorageKind>::value), + STORAGE_KIND_MUST_MATCH) + + typedef typename CwiseTernaryOpImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseTernaryOp) + + typedef typename internal::ref_selector::type Arg1Nested; + typedef typename internal::ref_selector::type Arg2Nested; + typedef typename internal::ref_selector::type Arg3Nested; + typedef std::remove_reference_t Arg1Nested_; + typedef std::remove_reference_t Arg2Nested_; + typedef std::remove_reference_t Arg3Nested_; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CwiseTernaryOp(const Arg1& a1, const Arg2& a2, const Arg3& a3, + const TernaryOp& func = TernaryOp()) + : m_arg1(a1), m_arg2(a2), m_arg3(a3), m_functor(func) { + eigen_assert(a1.rows() == a2.rows() && a1.cols() == a2.cols() && a1.rows() == a3.rows() && a1.cols() == a3.cols()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index rows() const { + // return the fixed size type if available to enable compile time + // optimizations + if (internal::traits>::RowsAtCompileTime == Dynamic && + internal::traits>::RowsAtCompileTime == Dynamic) + return m_arg3.rows(); + else if (internal::traits>::RowsAtCompileTime == Dynamic && + internal::traits>::RowsAtCompileTime == Dynamic) + return m_arg2.rows(); + else + return m_arg1.rows(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index cols() const { + // return the fixed size type if available to enable compile time + // optimizations + if (internal::traits>::ColsAtCompileTime == Dynamic && + internal::traits>::ColsAtCompileTime == Dynamic) + return m_arg3.cols(); + else if (internal::traits>::ColsAtCompileTime == Dynamic && + internal::traits>::ColsAtCompileTime == Dynamic) + return m_arg2.cols(); + else + return m_arg1.cols(); + } + + /** \returns the first argument nested expression */ + EIGEN_DEVICE_FUNC const Arg1Nested_& arg1() const { return m_arg1; } + /** \returns the first argument nested expression */ + EIGEN_DEVICE_FUNC const Arg2Nested_& arg2() const { return m_arg2; } + /** \returns the third argument nested expression */ + EIGEN_DEVICE_FUNC const Arg3Nested_& arg3() const { return m_arg3; } + /** \returns the functor representing the ternary operation */ + EIGEN_DEVICE_FUNC const TernaryOp& functor() const { return m_functor; } + + protected: + Arg1Nested m_arg1; + Arg2Nested m_arg2; + Arg3Nested m_arg3; + const TernaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseTernaryOpImpl : public internal::generic_xpr_base>::type { + public: + typedef typename internal::generic_xpr_base>::type Base; +}; + +} // end namespace Eigen + +#endif // EIGEN_CWISE_TERNARY_OP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryOp.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryOp.h new file mode 100644 index 0000000..94ec1a0 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryOp.h @@ -0,0 +1,91 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_UNARY_OP_H +#define EIGEN_CWISE_UNARY_OP_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > : traits { + typedef typename result_of::type Scalar; + typedef typename XprType::Nested XprTypeNested; + typedef std::remove_reference_t XprTypeNested_; + enum { Flags = XprTypeNested_::Flags & RowMajorBit }; +}; +} // namespace internal + +template +class CwiseUnaryOpImpl; + +/** \class CwiseUnaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise unary operator is applied to an expression + * + * \tparam UnaryOp template functor implementing the operator + * \tparam XprType the type of the expression to which we are applying the unary operator + * + * This class represents an expression where a unary operator is applied to an expression. + * It is the return type of all operations taking exactly 1 input expression, regardless of the + * presence of other inputs such as scalars. For example, the operator* in the expression 3*matrix + * is considered unary, because only the right-hand side is an expression, and its + * return type is a specialization of CwiseUnaryOp. + * + * Most of the time, this is the only way that it is used, so you typically don't have to name + * CwiseUnaryOp types explicitly. + * + * \sa MatrixBase::unaryExpr(const CustomUnaryOp &) const, class CwiseBinaryOp, class CwiseNullaryOp + */ +template +class CwiseUnaryOp : public CwiseUnaryOpImpl::StorageKind>, + internal::no_assignment_operator { + public: + typedef typename CwiseUnaryOpImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseUnaryOp) + typedef typename internal::ref_selector::type XprTypeNested; + typedef internal::remove_all_t NestedExpression; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit CwiseUnaryOp(const XprType& xpr, const UnaryOp& func = UnaryOp()) + : m_xpr(xpr), m_functor(func) {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const noexcept { return m_xpr.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const noexcept { return m_xpr.cols(); } + + /** \returns the functor representing the unary operation */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const UnaryOp& functor() const { return m_functor; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const internal::remove_all_t& nestedExpression() const { + return m_xpr; + } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE internal::remove_all_t& nestedExpression() { return m_xpr; } + + protected: + XprTypeNested m_xpr; + const UnaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseUnaryOpImpl : public internal::generic_xpr_base >::type { + public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +} // end namespace Eigen + +#endif // EIGEN_CWISE_UNARY_OP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryView.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryView.h new file mode 100644 index 0000000..7dd7623 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryView.h @@ -0,0 +1,167 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_UNARY_VIEW_H +#define EIGEN_CWISE_UNARY_VIEW_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > : traits { + typedef typename result_of::Scalar&)>::type1 ScalarRef; + static_assert(std::is_reference::value, "Views must return a reference type."); + typedef remove_all_t Scalar; + typedef typename MatrixType::Nested MatrixTypeNested; + typedef remove_all_t MatrixTypeNested_; + enum { + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags = + traits::Flags & + (RowMajorBit | FlagsLvalueBit | DirectAccessBit), // FIXME DirectAccessBit should not be handled by expressions + MatrixTypeInnerStride = inner_stride_at_compile_time::ret, + // need to cast the sizeof's from size_t to int explicitly, otherwise: + // "error: no integral type can represent all of the enumerator values + InnerStrideAtCompileTime = + StrideType::InnerStrideAtCompileTime == 0 + ? (MatrixTypeInnerStride == Dynamic + ? int(Dynamic) + : int(MatrixTypeInnerStride) * int(sizeof(typename traits::Scalar) / sizeof(Scalar))) + : int(StrideType::InnerStrideAtCompileTime), + + OuterStrideAtCompileTime = StrideType::OuterStrideAtCompileTime == 0 + ? (outer_stride_at_compile_time::ret == Dynamic + ? int(Dynamic) + : outer_stride_at_compile_time::ret * + int(sizeof(typename traits::Scalar) / sizeof(Scalar))) + : int(StrideType::OuterStrideAtCompileTime) + }; +}; + +// Generic API dispatcher +template ::value> +class CwiseUnaryViewImpl : public generic_xpr_base >::type { + public: + typedef typename generic_xpr_base >::type Base; +}; + +template +class CwiseUnaryViewImpl + : public dense_xpr_base >::type { + public: + typedef CwiseUnaryView Derived; + typedef typename dense_xpr_base >::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Derived) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(CwiseUnaryViewImpl) + + EIGEN_DEVICE_FUNC inline const Scalar* data() const { return &(this->coeffRef(0)); } + + EIGEN_DEVICE_FUNC constexpr Index innerStride() const { + return StrideType::InnerStrideAtCompileTime != 0 ? int(StrideType::InnerStrideAtCompileTime) + : derived().nestedExpression().innerStride() * + sizeof(typename traits::Scalar) / sizeof(Scalar); + } + + EIGEN_DEVICE_FUNC constexpr Index outerStride() const { + return StrideType::OuterStrideAtCompileTime != 0 ? int(StrideType::OuterStrideAtCompileTime) + : derived().nestedExpression().outerStride() * + sizeof(typename traits::Scalar) / sizeof(Scalar); + } + + protected: + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(CwiseUnaryViewImpl) + + // Allow const access to coeffRef for the case of direct access being enabled. + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index index) const { + return internal::evaluator(derived()).coeffRef(index); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index row, Index col) const { + return internal::evaluator(derived()).coeffRef(row, col); + } +}; + +template +class CwiseUnaryViewImpl + : public CwiseUnaryViewImpl { + public: + typedef CwiseUnaryViewImpl Base; + typedef CwiseUnaryView Derived; + EIGEN_DENSE_PUBLIC_INTERFACE(Derived) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(CwiseUnaryViewImpl) + + using Base::data; + EIGEN_DEVICE_FUNC inline Scalar* data() { return &(this->coeffRef(0)); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { + return internal::evaluator(derived()).coeffRef(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { + return internal::evaluator(derived()).coeffRef(index); + } + + protected: + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(CwiseUnaryViewImpl) +}; + +} // namespace internal + +/** \class CwiseUnaryView + * \ingroup Core_Module + * + * \brief Generic lvalue expression of a coefficient-wise unary operator of a matrix or a vector + * + * \tparam ViewOp template functor implementing the view + * \tparam MatrixType the type of the matrix we are applying the unary operator + * + * This class represents a lvalue expression of a generic unary view operator of a matrix or a vector. + * It is the return type of real() and imag(), and most of the time this is the only way it is used. + * + * \sa MatrixBase::unaryViewExpr(const CustomUnaryOp &) const, class CwiseUnaryOp + */ +template +class CwiseUnaryView : public internal::CwiseUnaryViewImpl::StorageKind> { + public: + typedef typename internal::CwiseUnaryViewImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseUnaryView) + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef internal::remove_all_t NestedExpression; + + explicit EIGEN_DEVICE_FUNC inline CwiseUnaryView(MatrixType& mat, const ViewOp& func = ViewOp()) + : m_matrix(mat), m_functor(func) {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(CwiseUnaryView) + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const noexcept { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const noexcept { return m_matrix.cols(); } + + /** \returns the functor representing unary operation */ + EIGEN_DEVICE_FUNC const ViewOp& functor() const { return m_functor; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC const internal::remove_all_t& nestedExpression() const { return m_matrix; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC std::remove_reference_t& nestedExpression() { return m_matrix; } + + protected: + MatrixTypeNested m_matrix; + ViewOp m_functor; +}; + +} // namespace Eigen + +#endif // EIGEN_CWISE_UNARY_VIEW_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DenseBase.h b/src/3rdparty/eigen/Eigen/src/Core/DenseBase.h new file mode 100644 index 0000000..c81e1d1 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DenseBase.h @@ -0,0 +1,673 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSEBASE_H +#define EIGEN_DENSEBASE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +// The index type defined by EIGEN_DEFAULT_DENSE_INDEX_TYPE must be a signed type. +EIGEN_STATIC_ASSERT(NumTraits::IsSigned, THE_INDEX_TYPE_MUST_BE_A_SIGNED_TYPE) + +/** \class DenseBase + * \ingroup Core_Module + * + * \brief Base class for all dense matrices, vectors, and arrays + * + * This class is the base that is inherited by all dense objects (matrix, vector, arrays, + * and related expression types). The common Eigen API for dense objects is contained in this class. + * + * \tparam Derived is the derived type, e.g., a matrix type or an expression. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_DENSEBASE_PLUGIN. + * + * \sa \blank \ref TopicClassHierarchy + */ +template +class DenseBase +#ifndef EIGEN_PARSED_BY_DOXYGEN + : public DenseCoeffsBase::value> +#else + : public DenseCoeffsBase +#endif // not EIGEN_PARSED_BY_DOXYGEN +{ + public: + /** Inner iterator type to iterate over the coefficients of a row or column. + * \sa class InnerIterator + */ + typedef Eigen::InnerIterator InnerIterator; + + typedef typename internal::traits::StorageKind StorageKind; + + /** + * \brief The type used to store indices + * \details This typedef is relevant for types that store multiple indices such as + * PermutationMatrix or Transpositions, otherwise it defaults to Eigen::Index + * \sa \blank \ref TopicPreprocessorDirectives, Eigen::Index, SparseMatrixBase. + */ + typedef typename internal::traits::StorageIndex StorageIndex; + + /** The numeric type of the expression' coefficients, e.g. float, double, int or std::complex, etc. */ + typedef typename internal::traits::Scalar Scalar; + + /** The numeric type of the expression' coefficients, e.g. float, double, int or std::complex, etc. + * + * It is an alias for the Scalar type */ + typedef Scalar value_type; + + typedef typename NumTraits::Real RealScalar; + typedef DenseCoeffsBase::value> Base; + + using Base::coeff; + using Base::coeffByOuterInner; + using Base::colIndexByOuterInner; + using Base::cols; + using Base::const_cast_derived; + using Base::derived; + using Base::rowIndexByOuterInner; + using Base::rows; + using Base::size; + using Base::operator(); + using Base::operator[]; + using Base::colStride; + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + using Base::stride; + using Base::w; + using Base::x; + using Base::y; + using Base::z; + typedef typename Base::CoeffReturnType CoeffReturnType; + + enum { + + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + /**< The number of rows at compile-time. This is just a copy of the value provided + * by the \a Derived type. If a value is not known at compile-time, + * it is set to the \a Dynamic constant. + * \sa MatrixBase::rows(), MatrixBase::cols(), ColsAtCompileTime, SizeAtCompileTime */ + + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + /**< The number of columns at compile-time. This is just a copy of the value provided + * by the \a Derived type. If a value is not known at compile-time, + * it is set to the \a Dynamic constant. + * \sa MatrixBase::rows(), MatrixBase::cols(), RowsAtCompileTime, SizeAtCompileTime */ + + SizeAtCompileTime = (internal::size_of_xpr_at_compile_time::ret), + /**< This is equal to the number of coefficients, i.e. the number of + * rows times the number of columns, or to \a Dynamic if this is not + * known at compile-time. \sa RowsAtCompileTime, ColsAtCompileTime */ + + MaxRowsAtCompileTime = internal::traits::MaxRowsAtCompileTime, + /**< This value is equal to the maximum possible number of rows that this expression + * might have. If this expression might have an arbitrarily high number of rows, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa RowsAtCompileTime, MaxColsAtCompileTime, MaxSizeAtCompileTime + */ + + MaxColsAtCompileTime = internal::traits::MaxColsAtCompileTime, + /**< This value is equal to the maximum possible number of columns that this expression + * might have. If this expression might have an arbitrarily high number of columns, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa ColsAtCompileTime, MaxRowsAtCompileTime, MaxSizeAtCompileTime + */ + + MaxSizeAtCompileTime = internal::size_at_compile_time(internal::traits::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime), + /**< This value is equal to the maximum possible number of coefficients that this expression + * might have. If this expression might have an arbitrarily high number of coefficients, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa SizeAtCompileTime, MaxRowsAtCompileTime, MaxColsAtCompileTime + */ + + IsVectorAtCompileTime = + internal::traits::RowsAtCompileTime == 1 || internal::traits::ColsAtCompileTime == 1, + /**< This is set to true if either the number of rows or the number of + * columns is known at compile-time to be equal to 1. Indeed, in that case, + * we are dealing with a column-vector (if there is only one column) or with + * a row-vector (if there is only one row). */ + + NumDimensions = int(MaxSizeAtCompileTime) == 1 ? 0 + : bool(IsVectorAtCompileTime) ? 1 + : 2, + /**< This value is equal to Tensor::NumDimensions, i.e. 0 for scalars, 1 for vectors, + * and 2 for matrices. + */ + + Flags = internal::traits::Flags, + /**< This stores expression \ref flags flags which may or may not be inherited by new expressions + * constructed from this one. See the \ref flags "list of flags". + */ + + IsRowMajor = int(Flags) & RowMajorBit, /**< True if this expression has row-major storage order. */ + + InnerSizeAtCompileTime = int(IsVectorAtCompileTime) ? int(SizeAtCompileTime) + : int(IsRowMajor) ? int(ColsAtCompileTime) + : int(RowsAtCompileTime), + + InnerStrideAtCompileTime = internal::inner_stride_at_compile_time::ret, + OuterStrideAtCompileTime = internal::outer_stride_at_compile_time::ret + }; + + typedef typename internal::find_best_packet::type PacketScalar; + + enum { IsPlainObjectBase = 0 }; + + /** The plain matrix type corresponding to this expression. + * \sa PlainObject */ + typedef Matrix::Scalar, internal::traits::RowsAtCompileTime, + internal::traits::ColsAtCompileTime, + AutoAlign | (internal::traits::Flags & RowMajorBit ? RowMajor : ColMajor), + internal::traits::MaxRowsAtCompileTime, internal::traits::MaxColsAtCompileTime> + PlainMatrix; + + /** The plain array type corresponding to this expression. + * \sa PlainObject */ + typedef Array::Scalar, internal::traits::RowsAtCompileTime, + internal::traits::ColsAtCompileTime, + AutoAlign | (internal::traits::Flags & RowMajorBit ? RowMajor : ColMajor), + internal::traits::MaxRowsAtCompileTime, internal::traits::MaxColsAtCompileTime> + PlainArray; + + /** \brief The plain matrix or array type corresponding to this expression. + * + * This is not necessarily exactly the return type of eval(). In the case of plain matrices, + * the return type of eval() is a const reference to a matrix, not a matrix! It is however guaranteed + * that the return type of eval() is either PlainObject or const PlainObject&. + */ + typedef std::conditional_t::XprKind, MatrixXpr>::value, + PlainMatrix, PlainArray> + PlainObject; + + /** \returns the outer size. + * + * \note For a vector, this returns just 1. For a matrix (non-vector), this is the major dimension + * with respect to the \ref TopicStorageOrders "storage order", i.e., the number of columns for a + * column-major matrix, and the number of rows for a row-major matrix. */ + EIGEN_DEVICE_FUNC constexpr Index outerSize() const { + return IsVectorAtCompileTime ? 1 : int(IsRowMajor) ? this->rows() : this->cols(); + } + + /** \returns the inner size. + * + * \note For a vector, this is just the size. For a matrix (non-vector), this is the minor dimension + * with respect to the \ref TopicStorageOrders "storage order", i.e., the number of rows for a + * column-major matrix, and the number of columns for a row-major matrix. */ + EIGEN_DEVICE_FUNC constexpr Index innerSize() const { + return IsVectorAtCompileTime ? this->size() : int(IsRowMajor) ? this->cols() : this->rows(); + } + + /** Only plain matrices/arrays, not expressions, may be resized; therefore the only useful resize methods are + * Matrix::resize() and Array::resize(). The present method only asserts that the new size equals the old size, and + * does nothing else. + */ + EIGEN_DEVICE_FUNC void resize(Index newSize) { + EIGEN_ONLY_USED_FOR_DEBUG(newSize); + eigen_assert(newSize == this->size() && "DenseBase::resize() does not actually allow to resize."); + } + /** Only plain matrices/arrays, not expressions, may be resized; therefore the only useful resize methods are + * Matrix::resize() and Array::resize(). The present method only asserts that the new size equals the old size, and + * does nothing else. + */ + EIGEN_DEVICE_FUNC void resize(Index rows, Index cols) { + EIGEN_ONLY_USED_FOR_DEBUG(rows); + EIGEN_ONLY_USED_FOR_DEBUG(cols); + eigen_assert(rows == this->rows() && cols == this->cols() && + "DenseBase::resize() does not actually allow to resize."); + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp, PlainObject> ConstantReturnType; + /** \internal Represents a matrix with all coefficients equal to zero*/ + typedef CwiseNullaryOp, PlainObject> ZeroReturnType; + /** \internal \deprecated Represents a vector with linearly spaced coefficients that allows sequential access only. */ + EIGEN_DEPRECATED typedef CwiseNullaryOp, PlainObject> SequentialLinSpacedReturnType; + /** \internal Represents a vector with linearly spaced coefficients that allows random access. */ + typedef CwiseNullaryOp, PlainObject> RandomAccessLinSpacedReturnType; + /** \internal Represents a vector with equally spaced coefficients that allows random access. */ + typedef CwiseNullaryOp, PlainObject> RandomAccessEqualSpacedReturnType; + /** \internal the return type of MatrixBase::eigenvalues() */ + typedef Matrix::Scalar>::Real, + internal::traits::ColsAtCompileTime, 1> + EigenvaluesReturnType; + +#endif // not EIGEN_PARSED_BY_DOXYGEN + + /** Copies \a other into *this. \returns a reference to *this. */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const DenseBase& other); + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const DenseBase& other); + + template + EIGEN_DEVICE_FUNC Derived& operator=(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC Derived& operator+=(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC Derived& operator-=(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC Derived& operator=(const ReturnByValue& func); + + /** \internal + * Copies \a other into *this without evaluating other. \returns a reference to *this. */ + template + /** \deprecated */ + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC Derived& lazyAssign(const DenseBase& other); + + EIGEN_DEVICE_FUNC CommaInitializer operator<<(const Scalar& s); + + template + /** \deprecated it now returns \c *this */ + EIGEN_DEPRECATED const Derived& flagged() const { + return derived(); + } + + template + EIGEN_DEVICE_FUNC CommaInitializer operator<<(const DenseBase& other); + + typedef Transpose TransposeReturnType; + EIGEN_DEVICE_FUNC TransposeReturnType transpose(); + typedef Transpose ConstTransposeReturnType; + EIGEN_DEVICE_FUNC const ConstTransposeReturnType transpose() const; + EIGEN_DEVICE_FUNC void transposeInPlace(); + + EIGEN_DEVICE_FUNC static const ConstantReturnType Constant(Index rows, Index cols, const Scalar& value); + EIGEN_DEVICE_FUNC static const ConstantReturnType Constant(Index size, const Scalar& value); + EIGEN_DEVICE_FUNC static const ConstantReturnType Constant(const Scalar& value); + + EIGEN_DEPRECATED_WITH_REASON("The method may result in accuracy loss. Use .EqualSpaced() instead.") + EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType LinSpaced(Sequential_t, Index size, const Scalar& low, + const Scalar& high); + EIGEN_DEPRECATED_WITH_REASON("The method may result in accuracy loss. Use .EqualSpaced() instead.") + EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType LinSpaced(Sequential_t, const Scalar& low, + const Scalar& high); + + EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType LinSpaced(Index size, const Scalar& low, + const Scalar& high); + EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType LinSpaced(const Scalar& low, const Scalar& high); + + EIGEN_DEVICE_FUNC static const RandomAccessEqualSpacedReturnType EqualSpaced(Index size, const Scalar& low, + const Scalar& step); + EIGEN_DEVICE_FUNC static const RandomAccessEqualSpacedReturnType EqualSpaced(const Scalar& low, const Scalar& step); + + template + EIGEN_DEVICE_FUNC static const CwiseNullaryOp NullaryExpr(Index rows, Index cols, + const CustomNullaryOp& func); + template + EIGEN_DEVICE_FUNC static const CwiseNullaryOp NullaryExpr(Index size, + const CustomNullaryOp& func); + template + EIGEN_DEVICE_FUNC static const CwiseNullaryOp NullaryExpr(const CustomNullaryOp& func); + + EIGEN_DEVICE_FUNC static const ZeroReturnType Zero(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const ZeroReturnType Zero(Index size); + EIGEN_DEVICE_FUNC static const ZeroReturnType Zero(); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(Index size); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(); + + EIGEN_DEVICE_FUNC void fill(const Scalar& value); + EIGEN_DEVICE_FUNC Derived& setConstant(const Scalar& value); + EIGEN_DEVICE_FUNC Derived& setLinSpaced(Index size, const Scalar& low, const Scalar& high); + EIGEN_DEVICE_FUNC Derived& setLinSpaced(const Scalar& low, const Scalar& high); + EIGEN_DEVICE_FUNC Derived& setEqualSpaced(Index size, const Scalar& low, const Scalar& step); + EIGEN_DEVICE_FUNC Derived& setEqualSpaced(const Scalar& low, const Scalar& step); + EIGEN_DEVICE_FUNC Derived& setZero(); + EIGEN_DEVICE_FUNC Derived& setOnes(); + EIGEN_DEVICE_FUNC Derived& setRandom(); + + template + EIGEN_DEVICE_FUNC bool isApprox(const DenseBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isMuchSmallerThan(const RealScalar& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + template + EIGEN_DEVICE_FUNC bool isMuchSmallerThan(const DenseBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + + EIGEN_DEVICE_FUNC bool isApproxToConstant(const Scalar& value, + const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isConstant(const Scalar& value, + const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isZero(const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isOnes(const RealScalar& prec = NumTraits::dummy_precision()) const; + + EIGEN_DEVICE_FUNC inline bool hasNaN() const; + EIGEN_DEVICE_FUNC inline bool allFinite() const; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator*=(const Scalar& other); + template ::value, typename = std::enable_if_t> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator*=(const RealScalar& other); + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator/=(const Scalar& other); + template ::value, typename = std::enable_if_t> + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator/=(const RealScalar& other); + + typedef internal::add_const_on_value_type_t::type> EvalReturnType; + /** \returns the matrix or vector obtained by evaluating this expression. + * + * Notice that in the case of a plain matrix or vector (not an expression) this function just returns + * a const reference, in order to avoid a useless copy. + * + * \warning Be careful with eval() and the auto C++ keyword, as detailed in this \link TopicPitfalls_auto_keyword page + * \endlink. + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EvalReturnType eval() const { + // Even though MSVC does not honor strong inlining when the return type + // is a dynamic matrix, we desperately need strong inlining for fixed + // size types on MSVC. + return typename internal::eval::type(derived()); + } + + /** swaps *this with the expression \a other. + * + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void swap(const DenseBase& other) { + EIGEN_STATIC_ASSERT(!OtherDerived::IsPlainObjectBase, THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + eigen_assert(rows() == other.rows() && cols() == other.cols()); + call_assignment(derived(), other.const_cast_derived(), internal::swap_assign_op()); + } + + /** swaps *this with the matrix or array \a other. + * + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void swap(PlainObjectBase& other) { + eigen_assert(rows() == other.rows() && cols() == other.cols()); + call_assignment(derived(), other.derived(), internal::swap_assign_op()); + } + + EIGEN_DEVICE_FUNC inline const NestByValue nestByValue() const; + EIGEN_DEVICE_FUNC inline const ForceAlignedAccess forceAlignedAccess() const; + EIGEN_DEVICE_FUNC inline ForceAlignedAccess forceAlignedAccess(); + template + EIGEN_DEVICE_FUNC inline const std::conditional_t, Derived&> + forceAlignedAccessIf() const; + template + EIGEN_DEVICE_FUNC inline std::conditional_t, Derived&> forceAlignedAccessIf(); + + EIGEN_DEVICE_FUNC Scalar sum() const; + EIGEN_DEVICE_FUNC Scalar mean() const; + EIGEN_DEVICE_FUNC Scalar trace() const; + + EIGEN_DEVICE_FUNC Scalar prod() const; + + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar minCoeff() const; + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar maxCoeff() const; + + // By default, the fastest version with undefined NaN propagation semantics is + // used. + // TODO(rmlarsen): Replace with default template argument when we move to + // c++11 or beyond. + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar minCoeff() const { + return minCoeff(); + } + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar maxCoeff() const { + return maxCoeff(); + } + + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar minCoeff(IndexType* row, IndexType* col) const; + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar maxCoeff(IndexType* row, IndexType* col) const; + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar minCoeff(IndexType* index) const; + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar maxCoeff(IndexType* index) const; + + // TODO(rmlarsen): Replace these methods with a default template argument. + template + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar minCoeff(IndexType* row, IndexType* col) const { + return minCoeff(row, col); + } + template + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar maxCoeff(IndexType* row, IndexType* col) const { + return maxCoeff(row, col); + } + template + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar minCoeff(IndexType* index) const { + return minCoeff(index); + } + template + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar maxCoeff(IndexType* index) const { + return maxCoeff(index); + } + + template + EIGEN_DEVICE_FUNC Scalar redux(const BinaryOp& func) const; + + template + EIGEN_DEVICE_FUNC void visit(Visitor& func) const; + + /** \returns a WithFormat proxy object allowing to print a matrix the with given + * format \a fmt. + * + * See class IOFormat for some examples. + * + * \sa class IOFormat, class WithFormat + */ + inline const WithFormat format(const IOFormat& fmt) const { return WithFormat(derived(), fmt); } + + /** \returns the unique coefficient of a 1x1 expression */ + EIGEN_DEVICE_FUNC CoeffReturnType value() const { + EIGEN_STATIC_ASSERT_SIZE_1x1(Derived) eigen_assert(this->rows() == 1 && this->cols() == 1); + return derived().coeff(0, 0); + } + + EIGEN_DEVICE_FUNC bool all() const; + EIGEN_DEVICE_FUNC bool any() const; + EIGEN_DEVICE_FUNC Index count() const; + + typedef VectorwiseOp RowwiseReturnType; + typedef const VectorwiseOp ConstRowwiseReturnType; + typedef VectorwiseOp ColwiseReturnType; + typedef const VectorwiseOp ConstColwiseReturnType; + + /** \returns a VectorwiseOp wrapper of *this for broadcasting and partial reductions + * + * Example: \include MatrixBase_rowwise.cpp + * Output: \verbinclude MatrixBase_rowwise.out + * + * \sa colwise(), class VectorwiseOp, \ref TutorialReductionsVisitorsBroadcasting + */ + // Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC inline ConstRowwiseReturnType rowwise() const { return ConstRowwiseReturnType(derived()); } + EIGEN_DEVICE_FUNC RowwiseReturnType rowwise(); + + /** \returns a VectorwiseOp wrapper of *this broadcasting and partial reductions + * + * Example: \include MatrixBase_colwise.cpp + * Output: \verbinclude MatrixBase_colwise.out + * + * \sa rowwise(), class VectorwiseOp, \ref TutorialReductionsVisitorsBroadcasting + */ + EIGEN_DEVICE_FUNC inline ConstColwiseReturnType colwise() const { return ConstColwiseReturnType(derived()); } + EIGEN_DEVICE_FUNC ColwiseReturnType colwise(); + + typedef CwiseNullaryOp, PlainObject> RandomReturnType; + static const RandomReturnType Random(Index rows, Index cols); + static const RandomReturnType Random(Index size); + static const RandomReturnType Random(); + + template + inline EIGEN_DEVICE_FUNC + CwiseTernaryOp::Scalar, + typename DenseBase::Scalar, Scalar>, + ThenDerived, ElseDerived, Derived> + select(const DenseBase& thenMatrix, const DenseBase& elseMatrix) const; + + template + inline EIGEN_DEVICE_FUNC + CwiseTernaryOp::Scalar, + typename DenseBase::Scalar, Scalar>, + ThenDerived, typename DenseBase::ConstantReturnType, Derived> + select(const DenseBase& thenMatrix, const typename DenseBase::Scalar& elseScalar) const; + + template + inline EIGEN_DEVICE_FUNC + CwiseTernaryOp::Scalar, + typename DenseBase::Scalar, Scalar>, + typename DenseBase::ConstantReturnType, ElseDerived, Derived> + select(const typename DenseBase::Scalar& thenScalar, const DenseBase& elseMatrix) const; + + template + RealScalar lpNorm() const; + + template + EIGEN_DEVICE_FUNC const Replicate replicate() const; + /** + * \return an expression of the replication of \c *this + * + * Example: \include MatrixBase_replicate_int_int.cpp + * Output: \verbinclude MatrixBase_replicate_int_int.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(), class Replicate + */ + // Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC const Replicate replicate(Index rowFactor, Index colFactor) const { + return Replicate(derived(), rowFactor, colFactor); + } + + typedef Reverse ReverseReturnType; + typedef const Reverse ConstReverseReturnType; + EIGEN_DEVICE_FUNC ReverseReturnType reverse(); + /** This is the const version of reverse(). */ + // Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC ConstReverseReturnType reverse() const { return ConstReverseReturnType(derived()); } + EIGEN_DEVICE_FUNC void reverseInPlace(); + +#ifdef EIGEN_PARSED_BY_DOXYGEN + /** STL-like RandomAccessIterator + * iterator type as returned by the begin() and end() methods. + */ + typedef random_access_iterator_type iterator; + /** This is the const version of iterator (aka read-only) */ + typedef random_access_iterator_type const_iterator; +#else + typedef std::conditional_t<(Flags & DirectAccessBit) == DirectAccessBit, + internal::pointer_based_stl_iterator, + internal::generic_randaccess_stl_iterator > + iterator_type; + + typedef std::conditional_t<(Flags & DirectAccessBit) == DirectAccessBit, + internal::pointer_based_stl_iterator, + internal::generic_randaccess_stl_iterator > + const_iterator_type; + + // Stl-style iterators are supported only for vectors. + + typedef std::conditional_t iterator; + + typedef std::conditional_t const_iterator; +#endif + + inline iterator begin(); + inline const_iterator begin() const; + inline const_iterator cbegin() const; + inline iterator end(); + inline const_iterator end() const; + inline const_iterator cend() const; + + using RealViewReturnType = std::conditional_t::IsComplex, RealView, Derived&>; + using ConstRealViewReturnType = + std::conditional_t::IsComplex, RealView, const Derived&>; + + EIGEN_DEVICE_FUNC RealViewReturnType realView(); + EIGEN_DEVICE_FUNC ConstRealViewReturnType realView() const; + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::DenseBase +#define EIGEN_DOC_BLOCK_ADDONS_NOT_INNER_PANEL +#define EIGEN_DOC_BLOCK_ADDONS_INNER_PANEL_IF(COND) +#define EIGEN_DOC_UNARY_ADDONS(X, Y) +#include "../plugins/CommonCwiseUnaryOps.inc" +#include "../plugins/BlockMethods.inc" +#include "../plugins/IndexedViewMethods.inc" +#include "../plugins/ReshapedMethods.inc" +#ifdef EIGEN_DENSEBASE_PLUGIN +#include EIGEN_DENSEBASE_PLUGIN +#endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_BLOCK_ADDONS_NOT_INNER_PANEL +#undef EIGEN_DOC_BLOCK_ADDONS_INNER_PANEL_IF +#undef EIGEN_DOC_UNARY_ADDONS + + // disable the use of evalTo for dense objects with a nice compilation error + template + EIGEN_DEVICE_FUNC inline void evalTo(Dest&) const { + EIGEN_STATIC_ASSERT((internal::is_same::value), + THE_EVAL_EVALTO_FUNCTION_SHOULD_NEVER_BE_CALLED_FOR_DENSE_OBJECTS); + } + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(DenseBase) + /** Default constructor. Do nothing. */ +#ifdef EIGEN_INTERNAL_DEBUGGING + EIGEN_DEVICE_FUNC constexpr DenseBase() { + /* Just checks for self-consistency of the flags. + * Only do it when debugging Eigen, as this borders on paranoia and could slow compilation down + */ + EIGEN_STATIC_ASSERT( + (internal::check_implication(MaxRowsAtCompileTime == 1 && MaxColsAtCompileTime != 1, int(IsRowMajor)) && + internal::check_implication(MaxColsAtCompileTime == 1 && MaxRowsAtCompileTime != 1, int(!IsRowMajor))), + INVALID_STORAGE_ORDER_FOR_THIS_VECTOR_EXPRESSION) + } +#else + EIGEN_DEVICE_FUNC constexpr DenseBase() = default; +#endif + + private: + EIGEN_DEVICE_FUNC explicit DenseBase(int); + EIGEN_DEVICE_FUNC DenseBase(int, int); + template + EIGEN_DEVICE_FUNC explicit DenseBase(const DenseBase&); +}; + +/** Free-function swap. + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + // Use forwarding references to capture all combinations of cv-qualified l+r-value cases. + std::enable_if_t>, std::decay_t>::value && + std::is_base_of>, std::decay_t>::value, + void> + swap(DerivedA&& a, DerivedB&& b) { + a.swap(b); +} + +} // end namespace Eigen + +#endif // EIGEN_DENSEBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DenseCoeffsBase.h b/src/3rdparty/eigen/Eigen/src/Core/DenseCoeffsBase.h new file mode 100644 index 0000000..377df57 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DenseCoeffsBase.h @@ -0,0 +1,568 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSECOEFFSBASE_H +#define EIGEN_DENSECOEFFSBASE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct add_const_on_value_type_if_arithmetic { + typedef std::conditional_t::value, T, add_const_on_value_type_t> type; +}; +} // namespace internal + +/** \brief Base class providing read-only coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #ReadOnlyAccessors Constant indicating read-only access + * + * This class defines the \c operator() \c const function and friends, which can be used to read specific + * entries of a matrix or array. + * + * \sa DenseCoeffsBase, DenseCoeffsBase, + * \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public EigenBase { + public: + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + + // Explanation for this CoeffReturnType typedef. + // - This is the return type of the coeff() method. + // - The LvalueBit means exactly that we can offer a coeffRef() method, which means exactly that we can get references + // to coeffs, which means exactly that we can have coeff() return a const reference (as opposed to returning a value). + // - The DirectAccessBit means exactly that the underlying data of coefficients can be directly accessed as a plain + // strided array, which means exactly that the underlying data of coefficients does exist in memory, which means + // exactly that the coefficients is const-referencable, which means exactly that we can have coeff() return a const + // reference. For example, Map have DirectAccessBit but not LvalueBit, so that Map.coeff() + // does points to a const Scalar& which exists in memory, while does not allow coeffRef() as it would not provide a + // lvalue. Notice that DirectAccessBit and LvalueBit are mutually orthogonal. + // - The is_arithmetic check is required since "const int", "const double", etc. will cause warnings on some systems + // while the declaration of "const T", where T is a non arithmetic type does not. Always returning "const Scalar&" is + // not possible, since the underlying expressions might not offer a valid address the reference could be referring to. + typedef std::conditional_t::Flags&(LvalueBit | DirectAccessBit)), const Scalar&, + std::conditional_t::value, Scalar, const Scalar>> + CoeffReturnType; + + typedef typename internal::add_const_on_value_type_if_arithmetic::type>::type + PacketReturnType; + + typedef EigenBase Base; + using Base::cols; + using Base::derived; + using Base::rows; + using Base::size; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index rowIndexByOuterInner(Index outer, Index inner) const { + return int(Derived::RowsAtCompileTime) == 1 ? 0 + : int(Derived::ColsAtCompileTime) == 1 ? inner + : int(Derived::Flags) & RowMajorBit ? outer + : inner; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index colIndexByOuterInner(Index outer, Index inner) const { + return int(Derived::ColsAtCompileTime) == 1 ? 0 + : int(Derived::RowsAtCompileTime) == 1 ? inner + : int(Derived::Flags) & RowMajorBit ? inner + : outer; + } + + /** Short version: don't use this function, use + * \link operator()(Index,Index) const \endlink instead. + * + * Long version: this function is similar to + * \link operator()(Index,Index) const \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator()(Index,Index) const \endlink. + * + * \sa operator()(Index,Index) const, coeffRef(Index,Index), coeff(Index) const + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType coeff(Index row, Index col) const { + eigen_internal_assert(row >= 0 && row < rows() && col >= 0 && col < cols()); + return internal::evaluator(derived()).coeff(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType coeffByOuterInner(Index outer, Index inner) const { + return coeff(rowIndexByOuterInner(outer, inner), colIndexByOuterInner(outer, inner)); + } + + /** \returns the coefficient at given the given row and column. + * + * \sa operator()(Index,Index), operator[](Index) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType operator()(Index row, Index col) const { + eigen_assert(row >= 0 && row < rows() && col >= 0 && col < cols()); + return coeff(row, col); + } + + /** Short version: don't use this function, use + * \link operator[](Index) const \endlink instead. + * + * Long version: this function is similar to + * \link operator[](Index) const \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameter \a index is in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator[](Index) const \endlink. + * + * \sa operator[](Index) const, coeffRef(Index), coeff(Index,Index) const + */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType coeff(Index index) const { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).coeff(index); + } + + /** \returns the coefficient at given index. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index), operator()(Index,Index) const, x() const, y() const, + * z() const, w() const + */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType operator[](Index index) const { + EIGEN_STATIC_ASSERT(Derived::IsVectorAtCompileTime, + THE_BRACKET_OPERATOR_IS_ONLY_FOR_VECTORS__USE_THE_PARENTHESIS_OPERATOR_INSTEAD) + eigen_assert(index >= 0 && index < size()); + return coeff(index); + } + + /** \returns the coefficient at given index. + * + * This is synonymous to operator[](Index) const. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index), operator()(Index,Index) const, x() const, y() const, + * z() const, w() const + */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType operator()(Index index) const { + eigen_assert(index >= 0 && index < size()); + return coeff(index); + } + + /** equivalent to operator[](0). */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType x() const { return (*this)[0]; } + + /** equivalent to operator[](1). */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType y() const { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime == -1 || Derived::SizeAtCompileTime >= 2, OUT_OF_RANGE_ACCESS); + return (*this)[1]; + } + + /** equivalent to operator[](2). */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType z() const { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime == -1 || Derived::SizeAtCompileTime >= 3, OUT_OF_RANGE_ACCESS); + return (*this)[2]; + } + + /** equivalent to operator[](3). */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr CoeffReturnType w() const { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime == -1 || Derived::SizeAtCompileTime >= 4, OUT_OF_RANGE_ACCESS); + return (*this)[3]; + } + + /** \internal + * \returns the packet of coefficients starting at the given row and column. It is your responsibility + * to ensure that a packet really starts there. This method is only available on expressions having the + * PacketAccessBit. + * + * The \a LoadMode parameter may have the value \a #Aligned or \a #Unaligned. Its effect is to select + * the appropriate vectorization instruction. Aligned access is faster, but is only possible for packets + * starting at an address which is a multiple of the packet size. + */ + + template + EIGEN_STRONG_INLINE PacketReturnType packet(Index row, Index col) const { + typedef typename internal::packet_traits::type DefaultPacketType; + eigen_internal_assert(row >= 0 && row < rows() && col >= 0 && col < cols()); + return internal::evaluator(derived()).template packet(row, col); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketReturnType packetByOuterInner(Index outer, Index inner) const { + return packet(rowIndexByOuterInner(outer, inner), colIndexByOuterInner(outer, inner)); + } + + /** \internal + * \returns the packet of coefficients starting at the given index. It is your responsibility + * to ensure that a packet really starts there. This method is only available on expressions having the + * PacketAccessBit and the LinearAccessBit. + * + * The \a LoadMode parameter may have the value \a #Aligned or \a #Unaligned. Its effect is to select + * the appropriate vectorization instruction. Aligned access is faster, but is only possible for packets + * starting at an address which is a multiple of the packet size. + */ + + template + EIGEN_STRONG_INLINE PacketReturnType packet(Index index) const { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + typedef typename internal::packet_traits::type DefaultPacketType; + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).template packet(index); + } + + protected: + // explanation: DenseBase is doing "using ..." on the methods from DenseCoeffsBase. + // But some methods are only available in the DirectAccess case. + // So we add dummy methods here with these names, so that "using... " doesn't fail. + // It's not private so that the child class DenseBase can access them, and it's not public + // either since it's an implementation detail, so has to be protected. + void coeffRef(); + void coeffRefByOuterInner(); + void writePacket(); + void writePacketByOuterInner(); + void copyCoeff(); + void copyCoeffByOuterInner(); + void copyPacket(); + void copyPacketByOuterInner(); + void stride(); + void innerStride(); + void outerStride(); + void rowStride(); + void colStride(); +}; + +/** \brief Base class providing read/write coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #WriteAccessors Constant indicating read/write access + * + * This class defines the non-const \c operator() function and friends, which can be used to write specific + * entries of a matrix or array. This class inherits DenseCoeffsBase which + * defines the const variant for reading specific entries. + * + * \sa DenseCoeffsBase, \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public DenseCoeffsBase { + public: + typedef DenseCoeffsBase Base; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + using Base::coeff; + using Base::colIndexByOuterInner; + using Base::cols; + using Base::derived; + using Base::rowIndexByOuterInner; + using Base::rows; + using Base::size; + using Base::operator[]; + using Base::operator(); + using Base::w; + using Base::x; + using Base::y; + using Base::z; + + /** Short version: don't use this function, use + * \link operator()(Index,Index) \endlink instead. + * + * Long version: this function is similar to + * \link operator()(Index,Index) \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator()(Index,Index) \endlink. + * + * \sa operator()(Index,Index), coeff(Index, Index) const, coeffRef(Index) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& coeffRef(Index row, Index col) { + eigen_internal_assert(row >= 0 && row < rows() && col >= 0 && col < cols()); + return internal::evaluator(derived()).coeffRef(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRefByOuterInner(Index outer, Index inner) { + return coeffRef(rowIndexByOuterInner(outer, inner), colIndexByOuterInner(outer, inner)); + } + + /** \returns a reference to the coefficient at given the given row and column. + * + * \sa operator[](Index) + */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& operator()(Index row, Index col) { + eigen_assert(row >= 0 && row < rows() && col >= 0 && col < cols()); + return coeffRef(row, col); + } + + /** Short version: don't use this function, use + * \link operator[](Index) \endlink instead. + * + * Long version: this function is similar to + * \link operator[](Index) \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator[](Index) \endlink. + * + * \sa operator[](Index), coeff(Index) const, coeffRef(Index,Index) + */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& coeffRef(Index index) { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).coeffRef(index); + } + + /** \returns a reference to the coefficient at given index. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index) const, operator()(Index,Index), x(), y(), z(), w() + */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& operator[](Index index) { + EIGEN_STATIC_ASSERT(Derived::IsVectorAtCompileTime, + THE_BRACKET_OPERATOR_IS_ONLY_FOR_VECTORS__USE_THE_PARENTHESIS_OPERATOR_INSTEAD) + eigen_assert(index >= 0 && index < size()); + return coeffRef(index); + } + + /** \returns a reference to the coefficient at given index. + * + * This is synonymous to operator[](Index). + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index) const, operator()(Index,Index), x(), y(), z(), w() + */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& operator()(Index index) { + eigen_assert(index >= 0 && index < size()); + return coeffRef(index); + } + + /** equivalent to operator[](0). */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& x() { return (*this)[0]; } + + /** equivalent to operator[](1). */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& y() { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime == -1 || Derived::SizeAtCompileTime >= 2, OUT_OF_RANGE_ACCESS); + return (*this)[1]; + } + + /** equivalent to operator[](2). */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& z() { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime == -1 || Derived::SizeAtCompileTime >= 3, OUT_OF_RANGE_ACCESS); + return (*this)[2]; + } + + /** equivalent to operator[](3). */ + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& w() { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime == -1 || Derived::SizeAtCompileTime >= 4, OUT_OF_RANGE_ACCESS); + return (*this)[3]; + } +}; + +/** \brief Base class providing direct read-only coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #DirectAccessors Constant indicating direct access + * + * This class defines functions to work with strides which can be used to access entries directly. This class + * inherits DenseCoeffsBase which defines functions to access entries read-only using + * \c operator() . + * + * \sa \blank \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public DenseCoeffsBase { + public: + typedef DenseCoeffsBase Base; + typedef typename internal::traits::Scalar Scalar; + typedef typename NumTraits::Real RealScalar; + + using Base::cols; + using Base::derived; + using Base::rows; + using Base::size; + + /** \returns the pointer increment between two consecutive elements within a slice in the inner direction. + * + * \sa outerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC constexpr Index innerStride() const { return derived().innerStride(); } + + /** \returns the pointer increment between two consecutive inner slices (for example, between two consecutive columns + * in a column-major matrix). + * + * \sa innerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC constexpr Index outerStride() const { return derived().outerStride(); } + + // FIXME shall we remove it ? + constexpr Index stride() const { return Derived::IsVectorAtCompileTime ? innerStride() : outerStride(); } + + /** \returns the pointer increment between two consecutive rows. + * + * \sa innerStride(), outerStride(), colStride() + */ + EIGEN_DEVICE_FUNC constexpr Index rowStride() const { return Derived::IsRowMajor ? outerStride() : innerStride(); } + + /** \returns the pointer increment between two consecutive columns. + * + * \sa innerStride(), outerStride(), rowStride() + */ + EIGEN_DEVICE_FUNC constexpr Index colStride() const { return Derived::IsRowMajor ? innerStride() : outerStride(); } +}; + +/** \brief Base class providing direct read/write coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #DirectWriteAccessors Constant indicating direct access + * + * This class defines functions to work with strides which can be used to access entries directly. This class + * inherits DenseCoeffsBase which defines functions to access entries read/write using + * \c operator(). + * + * \sa \blank \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public DenseCoeffsBase { + public: + typedef DenseCoeffsBase Base; + typedef typename internal::traits::Scalar Scalar; + typedef typename NumTraits::Real RealScalar; + + using Base::cols; + using Base::derived; + using Base::rows; + using Base::size; + + /** \returns the pointer increment between two consecutive elements within a slice in the inner direction. + * + * \sa outerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return derived().innerStride(); } + + /** \returns the pointer increment between two consecutive inner slices (for example, between two consecutive columns + * in a column-major matrix). + * + * \sa innerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return derived().outerStride(); } + + // FIXME shall we remove it ? + constexpr Index stride() const noexcept { return Derived::IsVectorAtCompileTime ? innerStride() : outerStride(); } + + /** \returns the pointer increment between two consecutive rows. + * + * \sa innerStride(), outerStride(), colStride() + */ + EIGEN_DEVICE_FUNC constexpr Index rowStride() const noexcept { + return Derived::IsRowMajor ? outerStride() : innerStride(); + } + + /** \returns the pointer increment between two consecutive columns. + * + * \sa innerStride(), outerStride(), rowStride() + */ + EIGEN_DEVICE_FUNC constexpr Index colStride() const noexcept { + return Derived::IsRowMajor ? innerStride() : outerStride(); + } +}; + +namespace internal { + +template +struct first_aligned_impl { + static constexpr Index run(const Derived&) noexcept { return 0; } +}; + +template +struct first_aligned_impl { + static inline Index run(const Derived& m) { return internal::first_aligned(m.data(), m.size()); } +}; + +/** \internal \returns the index of the first element of the array stored by \a m that is properly aligned with respect + * to \a Alignment for vectorization. + * + * \tparam Alignment requested alignment in Bytes. + * + * There is also the variant first_aligned(const Scalar*, Integer) defined in Memory.h. See it for more + * documentation. + */ +template +static inline Index first_aligned(const DenseBase& m) { + enum { ReturnZero = (int(evaluator::Alignment) >= Alignment) || !(Derived::Flags & DirectAccessBit) }; + return first_aligned_impl::run(m.derived()); +} + +template +static inline Index first_default_aligned(const DenseBase& m) { + typedef typename Derived::Scalar Scalar; + typedef typename packet_traits::type DefaultPacketType; + return internal::first_aligned::alignment), Derived>(m); +} + +template ::ret> +struct inner_stride_at_compile_time { + enum { ret = traits::InnerStrideAtCompileTime }; +}; + +template +struct inner_stride_at_compile_time { + enum { ret = 0 }; +}; + +template ::ret> +struct outer_stride_at_compile_time { + enum { ret = traits::OuterStrideAtCompileTime }; +}; + +template +struct outer_stride_at_compile_time { + enum { ret = 0 }; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DENSECOEFFSBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DenseStorage.h b/src/3rdparty/eigen/Eigen/src/Core/DenseStorage.h new file mode 100644 index 0000000..45c8779 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DenseStorage.h @@ -0,0 +1,573 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2009 Benoit Jacob +// Copyright (C) 2010-2013 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIXSTORAGE_H +#define EIGEN_MATRIXSTORAGE_H + +#ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN +#define EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(X) \ + X; \ + EIGEN_DENSE_STORAGE_CTOR_PLUGIN; +#else +#define EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(X) +#endif + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +#if defined(EIGEN_DISABLE_UNALIGNED_ARRAY_ASSERT) +#define EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(Alignment) +#else +#define EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(Alignment) \ + eigen_assert((is_constant_evaluated() || (std::uintptr_t(array) % Alignment == 0)) && \ + "this assertion is explained here: " \ + "http://eigen.tuxfamily.org/dox-devel/group__TopicUnalignedArrayAssert.html" \ + " **** READ THIS WEB PAGE !!! ****"); +#endif + +#if EIGEN_STACK_ALLOCATION_LIMIT +#define EIGEN_MAKE_STACK_ALLOCATION_ASSERT(X) \ + EIGEN_STATIC_ASSERT(X <= EIGEN_STACK_ALLOCATION_LIMIT, OBJECT_ALLOCATED_ON_STACK_IS_TOO_BIG) +#else +#define EIGEN_MAKE_STACK_ALLOCATION_ASSERT(X) +#endif + +/** \internal + * Static array. If the MatrixOrArrayOptions require auto-alignment, the array will be automatically aligned: + * to 16 bytes boundary if the total size is a multiple of 16 bytes. + */ + +template ::value> +struct plain_array { + EIGEN_ALIGN_TO_BOUNDARY(Alignment) T array[Size]; +#if defined(EIGEN_NO_DEBUG) || defined(EIGEN_TESTING_PLAINOBJECT_CTOR) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr plain_array() = default; +#else + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr plain_array() { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(Alignment) + EIGEN_MAKE_STACK_ALLOCATION_ASSERT(Size * sizeof(T)) + } +#endif +}; + +template +struct plain_array { + // on some 32-bit platforms, stack-allocated arrays are aligned to 4 bytes, not the preferred alignment of T + EIGEN_ALIGN_TO_BOUNDARY(alignof(T)) T array[Size]; +#if defined(EIGEN_NO_DEBUG) || defined(EIGEN_TESTING_PLAINOBJECT_CTOR) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr plain_array() = default; +#else + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr plain_array() { EIGEN_MAKE_STACK_ALLOCATION_ASSERT(Size * sizeof(T)) } +#endif +}; + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap_plain_array(plain_array& a, + plain_array& b, + Index a_size, Index b_size) { + Index common_size = numext::mini(a_size, b_size); + std::swap_ranges(a.array, a.array + common_size, b.array); + if (a_size > b_size) + smart_copy(a.array + common_size, a.array + a_size, b.array + common_size); + else if (b_size > a_size) + smart_copy(b.array + common_size, b.array + b_size, a.array + common_size); +} + +template +class DenseStorage_impl { + plain_array m_data; + + public: +#ifndef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl&) = default; +#else + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = Size) + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl& other) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = Size) + smart_copy(other.m_data.array, other.m_data.array + Size, m_data.array); + } +#endif + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index /*size*/, Index /*rows*/, Index /*cols*/) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) { + numext::swap(m_data, other.m_data); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index /*size*/, Index /*rows*/, + Index /*cols*/) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index /*size*/, Index /*rows*/, Index /*cols*/) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return Rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return Rows * Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return m_data.array; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return m_data.array; } +}; +template +class DenseStorage_impl { + plain_array m_data; + Index m_rows = 0; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl& other) + : m_rows(other.m_rows) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = other.size()) + smart_copy(other.m_data.array, other.m_data.array + other.size(), m_data.array); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index size, Index rows, Index /*cols*/) + : m_rows(rows) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + EIGEN_UNUSED_VARIABLE(size) + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl& other) { + smart_copy(other.m_data.array, other.m_data.array + other.size(), m_data.array); + m_rows = other.m_rows; + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) { + swap_plain_array(m_data, other.m_data, size(), other.size()); + numext::swap(m_rows, other.m_rows); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index /*size*/, Index rows, Index /*cols*/) { + m_rows = rows; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index /*size*/, Index rows, Index /*cols*/) { + m_rows = rows; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return m_rows * Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return m_data.array; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return m_data.array; } +}; +template +class DenseStorage_impl { + plain_array m_data; + Index m_cols = 0; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl& other) + : m_cols(other.m_cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = other.size()) + smart_copy(other.m_data.array, other.m_data.array + other.size(), m_data.array); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index size, Index /*rows*/, Index cols) + : m_cols(cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + EIGEN_UNUSED_VARIABLE(size) + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl& other) { + smart_copy(other.m_data.array, other.m_data.array + other.size(), m_data.array); + m_cols = other.m_cols; + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) { + swap_plain_array(m_data, other.m_data, size(), other.size()); + numext::swap(m_cols, other.m_cols); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index /*size*/, Index /*rows*/, Index cols) { + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index /*size*/, Index /*rows*/, Index cols) { + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return Rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return Rows * m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return m_data.array; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return m_data.array; } +}; +template +class DenseStorage_impl { + plain_array m_data; + Index m_rows = 0; + Index m_cols = 0; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl& other) + : m_rows(other.m_rows), m_cols(other.m_cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = other.size()) + smart_copy(other.m_data.array, other.m_data.array + other.size(), m_data.array); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index size, Index rows, Index cols) + : m_rows(rows), m_cols(cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + EIGEN_UNUSED_VARIABLE(size) + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl& other) { + smart_copy(other.m_data.array, other.m_data.array + other.size(), m_data.array); + m_rows = other.m_rows; + m_cols = other.m_cols; + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) { + swap_plain_array(m_data, other.m_data, size(), other.size()); + numext::swap(m_rows, other.m_rows); + numext::swap(m_cols, other.m_cols); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index /*size*/, Index rows, Index cols) { + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index /*size*/, Index rows, Index cols) { + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return m_rows * m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return m_data.array; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return m_data.array; } +}; +// null matrix variants +template +class DenseStorage_impl { + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index /*size*/, Index /*rows*/, Index /*cols*/) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl&) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index /*size*/, Index /*rows*/, + Index /*cols*/) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index /*size*/, Index /*rows*/, Index /*cols*/) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return Rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return Rows * Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return nullptr; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return nullptr; } +}; +template +class DenseStorage_impl { + Index m_rows = 0; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index /*size*/, Index rows, Index /*cols*/) + : m_rows(rows) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) noexcept { + numext::swap(m_rows, other.m_rows); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index /*size*/, Index rows, Index /*cols*/) { + m_rows = rows; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index /*size*/, Index rows, Index /*cols*/) { + m_rows = rows; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return m_rows * Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return nullptr; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return nullptr; } +}; +template +class DenseStorage_impl { + Index m_cols = 0; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index /*size*/, Index /*rows*/, Index cols) + : m_cols(cols) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) noexcept { + numext::swap(m_cols, other.m_cols); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index /*size*/, Index /*rows*/, Index cols) { + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index /*size*/, Index /*rows*/, Index cols) { + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return Rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return Rows * m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return nullptr; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return nullptr; } +}; +template +class DenseStorage_impl { + Index m_rows = 0; + Index m_cols = 0; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index /*size*/, Index rows, Index cols) + : m_rows(rows), m_cols(cols) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) noexcept { + numext::swap(m_rows, other.m_rows); + numext::swap(m_cols, other.m_cols); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index /*size*/, Index rows, Index cols) { + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index /*size*/, Index rows, Index cols) { + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return m_rows * m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return nullptr; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return nullptr; } +}; +// fixed-size matrix with dynamic memory allocation not currently supported +template +class DenseStorage_impl {}; +// dynamic-sized variants +template +class DenseStorage_impl { + static constexpr bool Align = (Options & DontAlign) == 0; + T* m_data = nullptr; + Index m_rows = 0; + + public: + static constexpr int Size = Dynamic; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl& other) + : m_data(conditional_aligned_new_auto(other.size())), m_rows(other.m_rows) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = other.size()) + smart_copy(other.m_data, other.m_data + other.size(), m_data); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index size, Index rows, Index /*cols*/) + : m_data(conditional_aligned_new_auto(size)), m_rows(rows) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(DenseStorage_impl&& other) noexcept + : m_data(other.m_data), m_rows(other.m_rows) { + other.m_data = nullptr; + other.m_rows = 0; + } + EIGEN_DEVICE_FUNC ~DenseStorage_impl() { conditional_aligned_delete_auto(m_data, size()); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl& other) { + resize(other.size(), other.rows(), other.cols()); + smart_copy(other.m_data, other.m_data + other.size(), m_data); + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(DenseStorage_impl&& other) noexcept { + this->swap(other); + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) noexcept { + numext::swap(m_data, other.m_data); + numext::swap(m_rows, other.m_rows); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index size, Index rows, Index /*cols*/) { + m_data = conditional_aligned_realloc_new_auto(m_data, size, this->size()); + m_rows = rows; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index size, Index rows, Index /*cols*/) { + Index oldSize = this->size(); + if (oldSize != size) { + conditional_aligned_delete_auto(m_data, oldSize); + m_data = conditional_aligned_new_auto(size); + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_rows = rows; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return m_rows * Cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return m_data; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return m_data; } +}; +template +class DenseStorage_impl { + static constexpr bool Align = (Options & DontAlign) == 0; + T* m_data = nullptr; + Index m_cols = 0; + + public: + static constexpr int Size = Dynamic; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl& other) + : m_data(conditional_aligned_new_auto(other.size())), m_cols(other.m_cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = other.size()) + smart_copy(other.m_data, other.m_data + other.size(), m_data); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index size, Index /*rows*/, Index cols) + : m_data(conditional_aligned_new_auto(size)), m_cols(cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(DenseStorage_impl&& other) noexcept + : m_data(other.m_data), m_cols(other.m_cols) { + other.m_data = nullptr; + other.m_cols = 0; + } + EIGEN_DEVICE_FUNC ~DenseStorage_impl() { conditional_aligned_delete_auto(m_data, size()); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl& other) { + resize(other.size(), other.rows(), other.cols()); + smart_copy(other.m_data, other.m_data + other.size(), m_data); + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(DenseStorage_impl&& other) noexcept { + this->swap(other); + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) noexcept { + numext::swap(m_data, other.m_data); + numext::swap(m_cols, other.m_cols); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index size, Index /*rows*/, Index cols) { + m_data = conditional_aligned_realloc_new_auto(m_data, size, this->size()); + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index size, Index /*rows*/, Index cols) { + Index oldSize = this->size(); + if (oldSize != size) { + conditional_aligned_delete_auto(m_data, oldSize); + m_data = conditional_aligned_new_auto(size); + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return Rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return Rows * m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return m_data; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return m_data; } +}; +template +class DenseStorage_impl { + static constexpr bool Align = (Options & DontAlign) == 0; + T* m_data = nullptr; + Index m_rows = 0; + Index m_cols = 0; + + public: + static constexpr int Size = Dynamic; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(const DenseStorage_impl& other) + : m_data(conditional_aligned_new_auto(other.size())), m_rows(other.m_rows), m_cols(other.m_cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = other.size()) + smart_copy(other.m_data, other.m_data + other.size(), m_data); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(Index size, Index rows, Index cols) + : m_data(conditional_aligned_new_auto(size)), m_rows(rows), m_cols(cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl(DenseStorage_impl&& other) noexcept + : m_data(other.m_data), m_rows(other.m_rows), m_cols(other.m_cols) { + other.m_data = nullptr; + other.m_rows = 0; + other.m_cols = 0; + } + EIGEN_DEVICE_FUNC ~DenseStorage_impl() { conditional_aligned_delete_auto(m_data, size()); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(const DenseStorage_impl& other) { + resize(other.size(), other.rows(), other.cols()); + smart_copy(other.m_data, other.m_data + other.size(), m_data); + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage_impl& operator=(DenseStorage_impl&& other) noexcept { + this->swap(other); + return *this; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void swap(DenseStorage_impl& other) noexcept { + numext::swap(m_data, other.m_data); + numext::swap(m_rows, other.m_rows); + numext::swap(m_cols, other.m_cols); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void conservativeResize(Index size, Index rows, Index cols) { + m_data = conditional_aligned_realloc_new_auto(m_data, size, this->size()); + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index size, Index rows, Index cols) { + Index oldSize = this->size(); + if (oldSize != size) { + conditional_aligned_delete_auto(m_data, oldSize); + m_data = conditional_aligned_new_auto(size); + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const { return m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index size() const { return m_rows * m_cols; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr T* data() { return m_data; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const T* data() const { return m_data; } +}; +template +struct use_default_move { + static constexpr bool DynamicObject = Size == Dynamic; + static constexpr bool TrivialObject = + (!NumTraits::RequireInitialization) && (Rows >= 0) && (Cols >= 0) && (Size == Rows * Cols); + static constexpr bool value = DynamicObject || TrivialObject; +}; +} // end namespace internal + +/** \internal + * + * \class DenseStorage_impl + * \ingroup Core_Module + * + * \brief Stores the data of a matrix + * + * This class stores the data of fixed-size, dynamic-size or mixed matrices + * in a way as compact as possible. + * + * \sa Matrix + */ +template ::value> +class DenseStorage : public internal::DenseStorage_impl { + using Base = internal::DenseStorage_impl; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage(const DenseStorage&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage(Index size, Index rows, Index cols) + : Base(size, rows, cols) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage& operator=(const DenseStorage&) = default; + // if DenseStorage meets the requirements of use_default_move, then use the move construction and move assignment + // operation defined in DenseStorage_impl, or the compiler-generated version if none is defined + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage(DenseStorage&&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage& operator=(DenseStorage&&) = default; +}; +template +class DenseStorage + : public internal::DenseStorage_impl { + using Base = internal::DenseStorage_impl; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage() = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage(const DenseStorage&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage(Index size, Index rows, Index cols) + : Base(size, rows, cols) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage& operator=(const DenseStorage&) = default; + // if DenseStorage does not meet the requirements of use_default_move, then defer to the copy construction and copy + // assignment behavior + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage(DenseStorage&& other) + : DenseStorage(static_cast(other)) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr DenseStorage& operator=(DenseStorage&& other) { + *this = other; + return *this; + } +}; + +} // end namespace Eigen + +#endif // EIGEN_MATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DeviceWrapper.h b/src/3rdparty/eigen/Eigen/src/Core/DeviceWrapper.h new file mode 100644 index 0000000..012dce1 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DeviceWrapper.h @@ -0,0 +1,153 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2023 Charlie Schlosser +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DEVICEWRAPPER_H +#define EIGEN_DEVICEWRAPPER_H + +namespace Eigen { +template +struct DeviceWrapper { + using Base = EigenBase>; + using Scalar = typename Derived::Scalar; + + EIGEN_DEVICE_FUNC DeviceWrapper(Base& xpr, Device& device) : m_xpr(xpr.derived()), m_device(device) {} + EIGEN_DEVICE_FUNC DeviceWrapper(const Base& xpr, Device& device) : m_xpr(xpr.derived()), m_device(device) {} + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const EigenBase& other) { + using AssignOp = internal::assign_op; + internal::call_assignment(*this, other.derived(), AssignOp()); + return m_xpr; + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator+=(const EigenBase& other) { + using AddAssignOp = internal::add_assign_op; + internal::call_assignment(*this, other.derived(), AddAssignOp()); + return m_xpr; + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator-=(const EigenBase& other) { + using SubAssignOp = internal::sub_assign_op; + internal::call_assignment(*this, other.derived(), SubAssignOp()); + return m_xpr; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& derived() { return m_xpr; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Device& device() { return m_device; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE NoAlias noalias() { + return NoAlias(*this); + } + + Derived& m_xpr; + Device& m_device; +}; + +namespace internal { + +// this is where we differentiate between lazy assignment and specialized kernels (e.g. matrix products) +template ::Shape, + typename evaluator_traits::Shape>::Kind, + typename EnableIf = void> +struct AssignmentWithDevice; + +// unless otherwise specified, use the default product implementation +template +struct AssignmentWithDevice, Functor, Device, Dense2Dense, Weak> { + using SrcXprType = Product; + using Base = Assignment; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, const Functor& func, + Device&) { + Base::run(dst, src, func); + } +}; + +// specialization for coeffcient-wise assignment +template +struct AssignmentWithDevice { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, const Functor& func, + Device& device) { +#ifndef EIGEN_NO_DEBUG + internal::check_for_aliasing(dst, src); +#endif + + call_dense_assignment_loop(dst, src, func, device); + } +}; + +// this allows us to use the default evaluation scheme if it is not specialized for the device +template +struct dense_assignment_loop_with_device { + using Base = dense_assignment_loop; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void run(Kernel& kernel, Device&) { Base::run(kernel); } +}; + +// entry point for a generic expression with device +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_assignment_no_alias(DeviceWrapper dst, + const Src& src, const Func& func) { + enum { + NeedToTranspose = ((int(Dst::RowsAtCompileTime) == 1 && int(Src::ColsAtCompileTime) == 1) || + (int(Dst::ColsAtCompileTime) == 1 && int(Src::RowsAtCompileTime) == 1)) && + int(Dst::SizeAtCompileTime) != 1 + }; + + using ActualDstTypeCleaned = std::conditional_t, Dst>; + using ActualDstType = std::conditional_t, Dst&>; + ActualDstType actualDst(dst.derived()); + + // TODO check whether this is the right place to perform these checks: + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(ActualDstTypeCleaned, Src) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func, typename ActualDstTypeCleaned::Scalar, typename Src::Scalar); + + // this provides a mechanism for specializing simple assignments, matrix products, etc + AssignmentWithDevice::run(actualDst, src, func, dst.device()); +} + +// copy and pasted from AssignEvaluator except forward device to kernel +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void call_dense_assignment_loop(DstXprType& dst, const SrcXprType& src, + const Functor& func, Device& device) { + using DstEvaluatorType = evaluator; + using SrcEvaluatorType = evaluator; + + SrcEvaluatorType srcEvaluator(src); + + // NOTE To properly handle A = (A*A.transpose())/s with A rectangular, + // we need to resize the destination after the source evaluator has been created. + resize_if_allowed(dst, src, func); + + DstEvaluatorType dstEvaluator(dst); + + using Kernel = generic_dense_assignment_kernel; + + Kernel kernel(dstEvaluator, srcEvaluator, func, dst.const_cast_derived()); + + dense_assignment_loop_with_device::run(kernel, device); +} + +} // namespace internal + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DeviceWrapper EigenBase::device(Device& device) { + return DeviceWrapper(derived(), device); +} + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DeviceWrapper EigenBase::device( + Device& device) const { + return DeviceWrapper(derived(), device); +} +} // namespace Eigen +#endif diff --git a/src/3rdparty/eigen/Eigen/src/Core/Diagonal.h b/src/3rdparty/eigen/Eigen/src/Core/Diagonal.h new file mode 100644 index 0000000..ff8611c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Diagonal.h @@ -0,0 +1,219 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2009 Benoit Jacob +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONAL_H +#define EIGEN_DIAGONAL_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class Diagonal + * \ingroup Core_Module + * + * \brief Expression of a diagonal/subdiagonal/superdiagonal in a matrix + * + * \tparam MatrixType the type of the object in which we are taking a sub/main/super diagonal + * \tparam DiagIndex the index of the sub/super diagonal. The default is 0 and it means the main diagonal. + * A positive value means a superdiagonal, a negative value means a subdiagonal. + * You can also use DynamicIndex so the index can be set at runtime. + * + * The matrix is not required to be square. + * + * This class represents an expression of the main diagonal, or any sub/super diagonal + * of a square matrix. It is the return type of MatrixBase::diagonal() and MatrixBase::diagonal(Index) and most of the + * time this is the only way it is used. + * + * \sa MatrixBase::diagonal(), MatrixBase::diagonal(Index) + */ + +namespace internal { +template +struct traits > : traits { + typedef typename ref_selector::type MatrixTypeNested; + typedef std::remove_reference_t MatrixTypeNested_; + typedef typename MatrixType::StorageKind StorageKind; + enum { + RowsAtCompileTime = (int(DiagIndex) == DynamicIndex || int(MatrixType::SizeAtCompileTime) == Dynamic) + ? Dynamic + : (plain_enum_min(MatrixType::RowsAtCompileTime - plain_enum_max(-DiagIndex, 0), + MatrixType::ColsAtCompileTime - plain_enum_max(DiagIndex, 0))), + ColsAtCompileTime = 1, + MaxRowsAtCompileTime = + int(MatrixType::MaxSizeAtCompileTime) == Dynamic ? Dynamic + : DiagIndex == DynamicIndex + ? min_size_prefer_fixed(MatrixType::MaxRowsAtCompileTime, MatrixType::MaxColsAtCompileTime) + : (plain_enum_min(MatrixType::MaxRowsAtCompileTime - plain_enum_max(-DiagIndex, 0), + MatrixType::MaxColsAtCompileTime - plain_enum_max(DiagIndex, 0))), + MaxColsAtCompileTime = 1, + MaskLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags = (unsigned int)MatrixTypeNested_::Flags & (RowMajorBit | MaskLvalueBit | DirectAccessBit) & + ~RowMajorBit, // FIXME DirectAccessBit should not be handled by expressions + MatrixTypeOuterStride = outer_stride_at_compile_time::ret, + InnerStrideAtCompileTime = MatrixTypeOuterStride == Dynamic ? Dynamic : MatrixTypeOuterStride + 1, + OuterStrideAtCompileTime = 0 + }; +}; +} // namespace internal + +template +class Diagonal : public internal::dense_xpr_base >::type { + public: + enum { DiagIndex = DiagIndex_ }; + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Diagonal) + + EIGEN_DEVICE_FUNC explicit inline Diagonal(MatrixType& matrix, Index a_index = DiagIndex) + : m_matrix(matrix), m_index(a_index) { + eigen_assert(a_index <= m_matrix.cols() && -a_index <= m_matrix.rows()); + } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Diagonal) + + EIGEN_DEVICE_FUNC inline Index rows() const { + return m_index.value() < 0 ? numext::mini(m_matrix.cols(), m_matrix.rows() + m_index.value()) + : numext::mini(m_matrix.rows(), m_matrix.cols() - m_index.value()); + } + + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return 1; } + + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return m_matrix.outerStride() + 1; } + + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return 0; } + + typedef std::conditional_t::value, Scalar, const Scalar> ScalarWithConstIfNotLvalue; + + EIGEN_DEVICE_FUNC inline ScalarWithConstIfNotLvalue* data() { return &(m_matrix.coeffRef(rowOffset(), colOffset())); } + EIGEN_DEVICE_FUNC inline const Scalar* data() const { return &(m_matrix.coeffRef(rowOffset(), colOffset())); } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index row, Index) { + EIGEN_STATIC_ASSERT_LVALUE(MatrixType) + return m_matrix.coeffRef(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index row, Index) const { + return m_matrix.coeffRef(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC inline CoeffReturnType coeff(Index row, Index) const { + return m_matrix.coeff(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index idx) { + EIGEN_STATIC_ASSERT_LVALUE(MatrixType) + return m_matrix.coeffRef(idx + rowOffset(), idx + colOffset()); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index idx) const { + return m_matrix.coeffRef(idx + rowOffset(), idx + colOffset()); + } + + EIGEN_DEVICE_FUNC inline CoeffReturnType coeff(Index idx) const { + return m_matrix.coeff(idx + rowOffset(), idx + colOffset()); + } + + EIGEN_DEVICE_FUNC inline const internal::remove_all_t& nestedExpression() const { + return m_matrix; + } + + EIGEN_DEVICE_FUNC inline Index index() const { return m_index.value(); } + + protected: + typename internal::ref_selector::non_const_type m_matrix; + const internal::variable_if_dynamicindex m_index; + + private: + // some compilers may fail to optimize std::max etc in case of compile-time constants... + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index absDiagIndex() const noexcept { + return m_index.value() > 0 ? m_index.value() : -m_index.value(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rowOffset() const noexcept { + return m_index.value() > 0 ? 0 : -m_index.value(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index colOffset() const noexcept { + return m_index.value() > 0 ? m_index.value() : 0; + } + // trigger a compile-time error if someone try to call packet + template + typename MatrixType::PacketReturnType packet(Index) const; + template + typename MatrixType::PacketReturnType packet(Index, Index) const; +}; + +/** \returns an expression of the main diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * Example: \include MatrixBase_diagonal.cpp + * Output: \verbinclude MatrixBase_diagonal.out + * + * \sa class Diagonal */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::DiagonalReturnType MatrixBase::diagonal() { + return DiagonalReturnType(derived()); +} + +/** This is the const version of diagonal(). */ +template +EIGEN_DEVICE_FUNC inline const typename MatrixBase::ConstDiagonalReturnType MatrixBase::diagonal() + const { + return ConstDiagonalReturnType(derived()); +} + +/** \returns an expression of the \a DiagIndex-th sub or super diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * The template parameter \a DiagIndex represent a super diagonal if \a DiagIndex > 0 + * and a sub diagonal otherwise. \a DiagIndex == 0 is equivalent to the main diagonal. + * + * Example: \include MatrixBase_diagonal_int.cpp + * Output: \verbinclude MatrixBase_diagonal_int.out + * + * \sa MatrixBase::diagonal(), class Diagonal */ +template +EIGEN_DEVICE_FUNC inline Diagonal MatrixBase::diagonal(Index index) { + return Diagonal(derived(), index); +} + +/** This is the const version of diagonal(Index). */ +template +EIGEN_DEVICE_FUNC inline const Diagonal MatrixBase::diagonal(Index index) const { + return Diagonal(derived(), index); +} + +/** \returns an expression of the \a DiagIndex-th sub or super diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * The template parameter \a DiagIndex represent a super diagonal if \a DiagIndex > 0 + * and a sub diagonal otherwise. \a DiagIndex == 0 is equivalent to the main diagonal. + * + * Example: \include MatrixBase_diagonal_template_int.cpp + * Output: \verbinclude MatrixBase_diagonal_template_int.out + * + * \sa MatrixBase::diagonal(), class Diagonal */ +template +template +EIGEN_DEVICE_FUNC inline Diagonal MatrixBase::diagonal() { + return Diagonal(derived()); +} + +/** This is the const version of diagonal(). */ +template +template +EIGEN_DEVICE_FUNC inline const Diagonal MatrixBase::diagonal() const { + return Diagonal(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_DIAGONAL_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DiagonalMatrix.h b/src/3rdparty/eigen/Eigen/src/Core/DiagonalMatrix.h new file mode 100644 index 0000000..52630d9 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DiagonalMatrix.h @@ -0,0 +1,420 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// Copyright (C) 2007-2009 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONALMATRIX_H +#define EIGEN_DIAGONALMATRIX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class DiagonalBase + * \ingroup Core_Module + * + * \brief Base class for diagonal matrices and expressions + * + * This is the base class that is inherited by diagonal matrix and related expression + * types, which internally use a vector for storing the diagonal entries. Diagonal + * types always represent square matrices. + * + * \tparam Derived is the derived type, a DiagonalMatrix or DiagonalWrapper. + * + * \sa class DiagonalMatrix, class DiagonalWrapper + */ +template +class DiagonalBase : public EigenBase { + public: + typedef typename internal::traits::DiagonalVectorType DiagonalVectorType; + typedef typename DiagonalVectorType::Scalar Scalar; + typedef typename DiagonalVectorType::RealScalar RealScalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + + enum { + RowsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + ColsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + MaxRowsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + IsVectorAtCompileTime = 0, + Flags = NoPreferredStorageOrderBit + }; + + typedef Matrix + DenseMatrixType; + typedef DenseMatrixType DenseType; + typedef DiagonalMatrix + PlainObject; + + /** \returns a reference to the derived object. */ + EIGEN_DEVICE_FUNC inline const Derived& derived() const { return *static_cast(this); } + /** \returns a const reference to the derived object. */ + EIGEN_DEVICE_FUNC inline Derived& derived() { return *static_cast(this); } + + /** + * Constructs a dense matrix from \c *this. Note, this directly returns a dense matrix type, + * not an expression. + * \returns A dense matrix, with its diagonal entries set from the the derived object. */ + EIGEN_DEVICE_FUNC DenseMatrixType toDenseMatrix() const { return derived(); } + + /** \returns a reference to the derived object's vector of diagonal coefficients. */ + EIGEN_DEVICE_FUNC inline const DiagonalVectorType& diagonal() const { return derived().diagonal(); } + /** \returns a const reference to the derived object's vector of diagonal coefficients. */ + EIGEN_DEVICE_FUNC inline DiagonalVectorType& diagonal() { return derived().diagonal(); } + + /** \returns the value of the coefficient as if \c *this was a dense matrix. */ + EIGEN_DEVICE_FUNC inline Scalar coeff(Index row, Index col) const { + eigen_assert(row >= 0 && col >= 0 && row < rows() && col <= cols()); + return row == col ? diagonal().coeff(row) : Scalar(0); + } + + /** \returns the number of rows. */ + EIGEN_DEVICE_FUNC constexpr Index rows() const { return diagonal().size(); } + /** \returns the number of columns. */ + EIGEN_DEVICE_FUNC constexpr Index cols() const { return diagonal().size(); } + + /** \returns the diagonal matrix product of \c *this by the dense matrix, \a matrix */ + template + EIGEN_DEVICE_FUNC const Product operator*( + const MatrixBase& matrix) const { + return Product(derived(), matrix.derived()); + } + + template + using DiagonalProductReturnType = DiagonalWrapper; + + /** \returns the diagonal matrix product of \c *this by the diagonal matrix \a other */ + template + EIGEN_DEVICE_FUNC const DiagonalProductReturnType operator*( + const DiagonalBase& other) const { + return diagonal().cwiseProduct(other.diagonal()).asDiagonal(); + } + + using DiagonalInverseReturnType = + DiagonalWrapper, const DiagonalVectorType>>; + + /** \returns the inverse \c *this. Computed as the coefficient-wise inverse of the diagonal. */ + EIGEN_DEVICE_FUNC inline const DiagonalInverseReturnType inverse() const { + return diagonal().cwiseInverse().asDiagonal(); + } + + using DiagonalScaleReturnType = + DiagonalWrapper; + + /** \returns the product of \c *this by the scalar \a scalar */ + EIGEN_DEVICE_FUNC inline const DiagonalScaleReturnType operator*(const Scalar& scalar) const { + return (diagonal() * scalar).asDiagonal(); + } + + using ScaleDiagonalReturnType = + DiagonalWrapper; + + /** \returns the product of a scalar and the diagonal matrix \a other */ + EIGEN_DEVICE_FUNC friend inline const ScaleDiagonalReturnType operator*(const Scalar& scalar, + const DiagonalBase& other) { + return (scalar * other.diagonal()).asDiagonal(); + } + + template + using DiagonalSumReturnType = DiagonalWrapper; + + /** \returns the sum of \c *this and the diagonal matrix \a other */ + template + EIGEN_DEVICE_FUNC inline const DiagonalSumReturnType operator+( + const DiagonalBase& other) const { + return (diagonal() + other.diagonal()).asDiagonal(); + } + + template + using DiagonalDifferenceReturnType = DiagonalWrapper; + + /** \returns the difference of \c *this and the diagonal matrix \a other */ + template + EIGEN_DEVICE_FUNC inline const DiagonalDifferenceReturnType operator-( + const DiagonalBase& other) const { + return (diagonal() - other.diagonal()).asDiagonal(); + } +}; + +/** \class DiagonalMatrix + * \ingroup Core_Module + * + * \brief Represents a diagonal matrix with its storage + * + * \tparam Scalar_ the type of coefficients + * \tparam SizeAtCompileTime the dimension of the matrix, or Dynamic + * \tparam MaxSizeAtCompileTime the dimension of the matrix, or Dynamic. This parameter is optional and defaults + * to SizeAtCompileTime. Most of the time, you do not need to specify it. + * + * \sa class DiagonalBase, class DiagonalWrapper + */ + +namespace internal { +template +struct traits> + : traits> { + typedef Matrix DiagonalVectorType; + typedef DiagonalShape StorageKind; + enum { Flags = LvalueBit | NoPreferredStorageOrderBit | NestByRefBit }; +}; +} // namespace internal +template +class DiagonalMatrix : public DiagonalBase> { + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename internal::traits::DiagonalVectorType DiagonalVectorType; + typedef const DiagonalMatrix& Nested; + typedef Scalar_ Scalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; +#endif + + protected: + DiagonalVectorType m_diagonal; + + public: + /** const version of diagonal(). */ + EIGEN_DEVICE_FUNC inline const DiagonalVectorType& diagonal() const { return m_diagonal; } + /** \returns a reference to the stored vector of diagonal coefficients. */ + EIGEN_DEVICE_FUNC inline DiagonalVectorType& diagonal() { return m_diagonal; } + + /** Default constructor without initialization */ + EIGEN_DEVICE_FUNC inline DiagonalMatrix() {} + + /** Constructs a diagonal matrix with given dimension */ + EIGEN_DEVICE_FUNC explicit inline DiagonalMatrix(Index dim) : m_diagonal(dim) {} + + /** 2D constructor. */ + EIGEN_DEVICE_FUNC inline DiagonalMatrix(const Scalar& x, const Scalar& y) : m_diagonal(x, y) {} + + /** 3D constructor. */ + EIGEN_DEVICE_FUNC inline DiagonalMatrix(const Scalar& x, const Scalar& y, const Scalar& z) : m_diagonal(x, y, z) {} + + /** \brief Construct a diagonal matrix with fixed size from an arbitrary number of coefficients. + * + * \warning To construct a diagonal matrix of fixed size, the number of values passed to this + * constructor must match the fixed dimension of \c *this. + * + * \sa DiagonalMatrix(const Scalar&, const Scalar&) + * \sa DiagonalMatrix(const Scalar&, const Scalar&, const Scalar&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DiagonalMatrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, + const ArgTypes&... args) + : m_diagonal(a0, a1, a2, args...) {} + + /** \brief Constructs a DiagonalMatrix and initializes it by elements given by an initializer list of initializer + * lists \cpp11 + */ + EIGEN_DEVICE_FUNC explicit EIGEN_STRONG_INLINE DiagonalMatrix( + const std::initializer_list>& list) + : m_diagonal(list) {} + + /** \brief Constructs a DiagonalMatrix from an r-value diagonal vector type */ + EIGEN_DEVICE_FUNC explicit inline DiagonalMatrix(DiagonalVectorType&& diag) : m_diagonal(std::move(diag)) {} + + /** Copy constructor. */ + template + EIGEN_DEVICE_FUNC inline DiagonalMatrix(const DiagonalBase& other) : m_diagonal(other.diagonal()) {} + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** copy constructor. prevent a default copy constructor from hiding the other templated constructor */ + inline DiagonalMatrix(const DiagonalMatrix& other) : m_diagonal(other.diagonal()) {} +#endif + + /** generic constructor from expression of the diagonal coefficients */ + template + EIGEN_DEVICE_FUNC explicit inline DiagonalMatrix(const MatrixBase& other) : m_diagonal(other) {} + + /** Copy operator. */ + template + EIGEN_DEVICE_FUNC DiagonalMatrix& operator=(const DiagonalBase& other) { + m_diagonal = other.diagonal(); + return *this; + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC DiagonalMatrix& operator=(const DiagonalMatrix& other) { + m_diagonal = other.diagonal(); + return *this; + } +#endif + + typedef DiagonalWrapper, DiagonalVectorType>> + InitializeReturnType; + + typedef DiagonalWrapper, DiagonalVectorType>> + ZeroInitializeReturnType; + + /** Initializes a diagonal matrix of size SizeAtCompileTime with coefficients set to zero */ + EIGEN_DEVICE_FUNC static const ZeroInitializeReturnType Zero() { return DiagonalVectorType::Zero().asDiagonal(); } + /** Initializes a diagonal matrix of size dim with coefficients set to zero */ + EIGEN_DEVICE_FUNC static const ZeroInitializeReturnType Zero(Index size) { + return DiagonalVectorType::Zero(size).asDiagonal(); + } + /** Initializes a identity matrix of size SizeAtCompileTime */ + EIGEN_DEVICE_FUNC static const InitializeReturnType Identity() { return DiagonalVectorType::Ones().asDiagonal(); } + /** Initializes a identity matrix of size dim */ + EIGEN_DEVICE_FUNC static const InitializeReturnType Identity(Index size) { + return DiagonalVectorType::Ones(size).asDiagonal(); + } + + /** Resizes to given size. */ + EIGEN_DEVICE_FUNC inline void resize(Index size) { m_diagonal.resize(size); } + /** Sets all coefficients to zero. */ + EIGEN_DEVICE_FUNC inline void setZero() { m_diagonal.setZero(); } + /** Resizes and sets all coefficients to zero. */ + EIGEN_DEVICE_FUNC inline void setZero(Index size) { m_diagonal.setZero(size); } + /** Sets this matrix to be the identity matrix of the current size. */ + EIGEN_DEVICE_FUNC inline void setIdentity() { m_diagonal.setOnes(); } + /** Sets this matrix to be the identity matrix of the given size. */ + EIGEN_DEVICE_FUNC inline void setIdentity(Index size) { m_diagonal.setOnes(size); } +}; + +/** \class DiagonalWrapper + * \ingroup Core_Module + * + * \brief Expression of a diagonal matrix + * + * \tparam DiagonalVectorType_ the type of the vector of diagonal coefficients + * + * This class is an expression of a diagonal matrix, but not storing its own vector of diagonal coefficients, + * instead wrapping an existing vector expression. It is the return type of MatrixBase::asDiagonal() + * and most of the time this is the only way that it is used. + * + * \sa class DiagonalMatrix, class DiagonalBase, MatrixBase::asDiagonal() + */ + +namespace internal { +template +struct traits> { + typedef DiagonalVectorType_ DiagonalVectorType; + typedef typename DiagonalVectorType::Scalar Scalar; + typedef typename DiagonalVectorType::StorageIndex StorageIndex; + typedef DiagonalShape StorageKind; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + ColsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + MaxRowsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + Flags = (traits::Flags & LvalueBit) | NoPreferredStorageOrderBit + }; +}; +} // namespace internal + +template +class DiagonalWrapper : public DiagonalBase>, internal::no_assignment_operator { + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef DiagonalVectorType_ DiagonalVectorType; + typedef DiagonalWrapper Nested; +#endif + + /** Constructor from expression of diagonal coefficients to wrap. */ + EIGEN_DEVICE_FUNC explicit inline DiagonalWrapper(DiagonalVectorType& a_diagonal) : m_diagonal(a_diagonal) {} + + /** \returns a const reference to the wrapped expression of diagonal coefficients. */ + EIGEN_DEVICE_FUNC const DiagonalVectorType& diagonal() const { return m_diagonal; } + + protected: + typename DiagonalVectorType::Nested m_diagonal; +}; + +/** \returns a pseudo-expression of a diagonal matrix with *this as vector of diagonal coefficients + * + * \only_for_vectors + * + * Example: \include MatrixBase_asDiagonal.cpp + * Output: \verbinclude MatrixBase_asDiagonal.out + * + * \sa class DiagonalWrapper, class DiagonalMatrix, diagonal(), isDiagonal() + **/ +template +EIGEN_DEVICE_FUNC inline const DiagonalWrapper MatrixBase::asDiagonal() const { + return DiagonalWrapper(derived()); +} + +/** \returns true if *this is approximately equal to a diagonal matrix, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isDiagonal.cpp + * Output: \verbinclude MatrixBase_isDiagonal.out + * + * \sa asDiagonal() + */ +template +bool MatrixBase::isDiagonal(const RealScalar& prec) const { + if (cols() != rows()) return false; + RealScalar maxAbsOnDiagonal = static_cast(-1); + for (Index j = 0; j < cols(); ++j) { + RealScalar absOnDiagonal = numext::abs(coeff(j, j)); + if (absOnDiagonal > maxAbsOnDiagonal) maxAbsOnDiagonal = absOnDiagonal; + } + for (Index j = 0; j < cols(); ++j) + for (Index i = 0; i < j; ++i) { + if (!internal::isMuchSmallerThan(coeff(i, j), maxAbsOnDiagonal, prec)) return false; + if (!internal::isMuchSmallerThan(coeff(j, i), maxAbsOnDiagonal, prec)) return false; + } + return true; +} + +namespace internal { + +template <> +struct storage_kind_to_shape { + typedef DiagonalShape Shape; +}; + +struct Diagonal2Dense {}; + +template <> +struct AssignmentKind { + typedef Diagonal2Dense Kind; +}; + +// Diagonal matrix to Dense assignment +template +struct Assignment { + static EIGEN_DEVICE_FUNC void run( + DstXprType& dst, const SrcXprType& src, + const internal::assign_op& /*func*/) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + + dst.setZero(); + dst.diagonal() = src.diagonal(); + } + + static EIGEN_DEVICE_FUNC void run( + DstXprType& dst, const SrcXprType& src, + const internal::add_assign_op& /*func*/) { + dst.diagonal() += src.diagonal(); + } + + static EIGEN_DEVICE_FUNC void run( + DstXprType& dst, const SrcXprType& src, + const internal::sub_assign_op& /*func*/) { + dst.diagonal() -= src.diagonal(); + } +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DIAGONALMATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DiagonalProduct.h b/src/3rdparty/eigen/Eigen/src/Core/DiagonalProduct.h new file mode 100644 index 0000000..bd0feea --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DiagonalProduct.h @@ -0,0 +1,30 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2007-2009 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONALPRODUCT_H +#define EIGEN_DIAGONALPRODUCT_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \returns the diagonal matrix product of \c *this by the diagonal matrix \a diagonal. + */ +template +template +EIGEN_DEVICE_FUNC inline const Product MatrixBase::operator*( + const DiagonalBase &a_diagonal) const { + return Product(derived(), a_diagonal.derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_DIAGONALPRODUCT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Dot.h b/src/3rdparty/eigen/Eigen/src/Core/Dot.h new file mode 100644 index 0000000..059527c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Dot.h @@ -0,0 +1,268 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008, 2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DOT_H +#define EIGEN_DOT_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template ::Scalar> +struct squared_norm_impl { + using Real = typename NumTraits::Real; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Real run(const Derived& a) { + Scalar result = a.unaryExpr(squared_norm_functor()).sum(); + return numext::real(result) + numext::imag(result); + } +}; + +template +struct squared_norm_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE bool run(const Derived& a) { return a.any(); } +}; + +} // end namespace internal + +/** \fn MatrixBase::dot + * \returns the dot product of *this with other. + * + * \only_for_vectors + * + * \note If the scalar type is complex numbers, then this function returns the hermitian + * (sesquilinear) dot product, conjugate-linear in the first variable and linear in the + * second variable. + * + * \sa squaredNorm(), norm() + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + typename ScalarBinaryOpTraits::Scalar, + typename internal::traits::Scalar>::ReturnType + MatrixBase::dot(const MatrixBase& other) const { + return internal::dot_impl::run(derived(), other.derived()); +} + +//---------- implementation of L2 norm and related functions ---------- + +/** \returns, for vectors, the squared \em l2 norm of \c *this, and for matrices the squared Frobenius norm. + * In both cases, it consists in the sum of the square of all the matrix entries. + * For vectors, this is also equals to the dot product of \c *this with itself. + * + * \sa dot(), norm(), lpNorm() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename NumTraits::Scalar>::Real +MatrixBase::squaredNorm() const { + return internal::squared_norm_impl::run(derived()); +} + +/** \returns, for vectors, the \em l2 norm of \c *this, and for matrices the Frobenius norm. + * In both cases, it consists in the square root of the sum of the square of all the matrix entries. + * For vectors, this is also equals to the square root of the dot product of \c *this with itself. + * + * \sa lpNorm(), dot(), squaredNorm() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename NumTraits::Scalar>::Real +MatrixBase::norm() const { + return numext::sqrt(squaredNorm()); +} + +/** \returns an expression of the quotient of \c *this by its own norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), + * then this function returns a copy of the input. + * + * \only_for_vectors + * + * \sa norm(), normalize() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::PlainObject MatrixBase::normalized() + const { + typedef typename internal::nested_eval::type Nested_; + Nested_ n(derived()); + RealScalar z = n.squaredNorm(); + // NOTE: after extensive benchmarking, this conditional does not impact performance, at least on recent x86 CPU + if (z > RealScalar(0)) + return n / numext::sqrt(z); + else + return n; +} + +/** Normalizes the vector, i.e. divides it by its own norm. + * + * \only_for_vectors + * + * \warning If the input vector is too small (i.e., this->norm()==0), then \c *this is left unchanged. + * + * \sa norm(), normalized() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void MatrixBase::normalize() { + RealScalar z = squaredNorm(); + // NOTE: after extensive benchmarking, this conditional does not impact performance, at least on recent x86 CPU + if (z > RealScalar(0)) derived() /= numext::sqrt(z); +} + +/** \returns an expression of the quotient of \c *this by its own norm while avoiding underflow and overflow. + * + * \only_for_vectors + * + * This method is analogue to the normalized() method, but it reduces the risk of + * underflow and overflow when computing the norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), + * then this function returns a copy of the input. + * + * \sa stableNorm(), stableNormalize(), normalized() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::PlainObject +MatrixBase::stableNormalized() const { + typedef typename internal::nested_eval::type Nested_; + Nested_ n(derived()); + RealScalar w = n.cwiseAbs().maxCoeff(); + RealScalar z = (n / w).squaredNorm(); + if (z > RealScalar(0)) + return n / (numext::sqrt(z) * w); + else + return n; +} + +/** Normalizes the vector while avoid underflow and overflow + * + * \only_for_vectors + * + * This method is analogue to the normalize() method, but it reduces the risk of + * underflow and overflow when computing the norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), then \c *this is left unchanged. + * + * \sa stableNorm(), stableNormalized(), normalize() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void MatrixBase::stableNormalize() { + RealScalar w = cwiseAbs().maxCoeff(); + RealScalar z = (derived() / w).squaredNorm(); + if (z > RealScalar(0)) derived() /= numext::sqrt(z) * w; +} + +//---------- implementation of other norms ---------- + +namespace internal { + +template +struct lpNorm_selector { + typedef typename NumTraits::Scalar>::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const MatrixBase& m) { + EIGEN_USING_STD(pow) + return pow(m.cwiseAbs().array().pow(p).sum(), RealScalar(1) / p); + } +}; + +template +struct lpNorm_selector { + EIGEN_DEVICE_FUNC static inline typename NumTraits::Scalar>::Real run( + const MatrixBase& m) { + return m.cwiseAbs().sum(); + } +}; + +template +struct lpNorm_selector { + EIGEN_DEVICE_FUNC static inline typename NumTraits::Scalar>::Real run( + const MatrixBase& m) { + return m.norm(); + } +}; + +template +struct lpNorm_selector { + typedef typename NumTraits::Scalar>::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const MatrixBase& m) { + if (Derived::SizeAtCompileTime == 0 || (Derived::SizeAtCompileTime == Dynamic && m.size() == 0)) + return RealScalar(0); + return m.cwiseAbs().maxCoeff(); + } +}; + +} // end namespace internal + +/** \returns the \b coefficient-wise \f$ \ell^p \f$ norm of \c *this, that is, returns the p-th root of the sum of the + * p-th powers of the absolute values of the coefficients of \c *this. If \a p is the special value \a Eigen::Infinity, + * this function returns the \f$ \ell^\infty \f$ norm, that is the maximum of the absolute values of the coefficients of + * \c *this. + * + * In all cases, if \c *this is empty, then the value 0 is returned. + * + * \note For matrices, this function does not compute the operator-norm. That is, if \c *this is a matrix, then its + * coefficients are interpreted as a 1D vector. Nonetheless, you can easily compute the 1-norm and \f$\infty\f$-norm + * matrix operator norms using \link TutorialReductionsVisitorsBroadcastingReductionsNorm partial reductions \endlink. + * + * \sa norm() + */ +template +template +#ifndef EIGEN_PARSED_BY_DOXYGEN +EIGEN_DEVICE_FUNC inline typename NumTraits::Scalar>::Real +#else +EIGEN_DEVICE_FUNC MatrixBase::RealScalar +#endif +MatrixBase::lpNorm() const { + return internal::lpNorm_selector::run(*this); +} + +//---------- implementation of isOrthogonal / isUnitary ---------- + +/** \returns true if *this is approximately orthogonal to \a other, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isOrthogonal.cpp + * Output: \verbinclude MatrixBase_isOrthogonal.out + */ +template +template +bool MatrixBase::isOrthogonal(const MatrixBase& other, const RealScalar& prec) const { + typename internal::nested_eval::type nested(derived()); + typename internal::nested_eval::type otherNested(other.derived()); + return numext::abs2(nested.dot(otherNested)) <= prec * prec * nested.squaredNorm() * otherNested.squaredNorm(); +} + +/** \returns true if *this is approximately an unitary matrix, + * within the precision given by \a prec. In the case where the \a Scalar + * type is real numbers, a unitary matrix is an orthogonal matrix, whence the name. + * + * \note This can be used to check whether a family of vectors forms an orthonormal basis. + * Indeed, \c m.isUnitary() returns true if and only if the columns (equivalently, the rows) of m form an + * orthonormal basis. + * + * Example: \include MatrixBase_isUnitary.cpp + * Output: \verbinclude MatrixBase_isUnitary.out + */ +template +bool MatrixBase::isUnitary(const RealScalar& prec) const { + typename internal::nested_eval::type self(derived()); + for (Index i = 0; i < cols(); ++i) { + if (!internal::isApprox(self.col(i).squaredNorm(), static_cast(1), prec)) return false; + for (Index j = 0; j < i; ++j) + if (!internal::isMuchSmallerThan(self.col(i).dot(self.col(j)), static_cast(1), prec)) return false; + } + return true; +} + +} // end namespace Eigen + +#endif // EIGEN_DOT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/EigenBase.h b/src/3rdparty/eigen/Eigen/src/Core/EigenBase.h new file mode 100644 index 0000000..c9a6e88 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/EigenBase.h @@ -0,0 +1,149 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_EIGENBASE_H +#define EIGEN_EIGENBASE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class EigenBase + * \ingroup Core_Module + * + * Common base class for all classes T such that MatrixBase has an operator=(T) and a constructor MatrixBase(T). + * + * In other words, an EigenBase object is an object that can be copied into a MatrixBase. + * + * Besides MatrixBase-derived classes, this also includes special matrix classes such as diagonal matrices, etc. + * + * Notice that this class is trivial, it is only used to disambiguate overloaded functions. + * + * \sa \blank \ref TopicClassHierarchy + */ +template +struct EigenBase { + // typedef typename internal::plain_matrix_type::type PlainObject; + + /** \brief The interface type of indices + * \details To change this, \c \#define the preprocessor symbol \c EIGEN_DEFAULT_DENSE_INDEX_TYPE. + * \sa StorageIndex, \ref TopicPreprocessorDirectives. + * DEPRECATED: Since Eigen 3.3, its usage is deprecated. Use Eigen::Index instead. + * Deprecation is not marked with a doxygen comment because there are too many existing usages to add the deprecation + * attribute. + */ + typedef Eigen::Index Index; + + // FIXME is it needed? + typedef typename internal::traits::StorageKind StorageKind; + + /** \returns a reference to the derived object */ + EIGEN_DEVICE_FUNC constexpr Derived& derived() { return *static_cast(this); } + /** \returns a const reference to the derived object */ + EIGEN_DEVICE_FUNC constexpr const Derived& derived() const { return *static_cast(this); } + + EIGEN_DEVICE_FUNC inline constexpr Derived& const_cast_derived() const { + return *static_cast(const_cast(this)); + } + EIGEN_DEVICE_FUNC inline const Derived& const_derived() const { return *static_cast(this); } + + /** \returns the number of rows. \sa cols(), RowsAtCompileTime */ + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return derived().rows(); } + /** \returns the number of columns. \sa rows(), ColsAtCompileTime*/ + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return derived().cols(); } + /** \returns the number of coefficients, which is rows()*cols(). + * \sa rows(), cols(), SizeAtCompileTime. */ + EIGEN_DEVICE_FUNC constexpr Index size() const noexcept { return rows() * cols(); } + + /** \internal Don't use it, but do the equivalent: \code dst = *this; \endcode */ + template + EIGEN_DEVICE_FUNC inline void evalTo(Dest& dst) const { + derived().evalTo(dst); + } + + /** \internal Don't use it, but do the equivalent: \code dst += *this; \endcode */ + template + EIGEN_DEVICE_FUNC inline void addTo(Dest& dst) const { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + typename Dest::PlainObject res(rows(), cols()); + evalTo(res); + dst += res; + } + + /** \internal Don't use it, but do the equivalent: \code dst -= *this; \endcode */ + template + EIGEN_DEVICE_FUNC inline void subTo(Dest& dst) const { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + typename Dest::PlainObject res(rows(), cols()); + evalTo(res); + dst -= res; + } + + /** \internal Don't use it, but do the equivalent: \code dst.applyOnTheRight(*this); \endcode */ + template + EIGEN_DEVICE_FUNC inline void applyThisOnTheRight(Dest& dst) const { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + dst = dst * this->derived(); + } + + /** \internal Don't use it, but do the equivalent: \code dst.applyOnTheLeft(*this); \endcode */ + template + EIGEN_DEVICE_FUNC inline void applyThisOnTheLeft(Dest& dst) const { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + dst = this->derived() * dst; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DeviceWrapper device(Device& device); + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE DeviceWrapper device(Device& device) const; +}; + +/*************************************************************************** + * Implementation of matrix base methods + ***************************************************************************/ + +/** \brief Copies the generic expression \a other into *this. + * + * \details The expression must provide a (templated) evalTo(Derived& dst) const + * function which does the actual job. In practice, this allows any user to write + * its own special matrix without having to modify MatrixBase + * + * \returns a reference to *this. + */ +template +template +EIGEN_DEVICE_FUNC Derived& DenseBase::operator=(const EigenBase& other) { + call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC Derived& DenseBase::operator+=(const EigenBase& other) { + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC Derived& DenseBase::operator-=(const EigenBase& other) { + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_EIGENBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Fill.h b/src/3rdparty/eigen/Eigen/src/Core/Fill.h new file mode 100644 index 0000000..779ef26 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Fill.h @@ -0,0 +1,138 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2024 Charles Schlosser +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_FILL_H +#define EIGEN_FILL_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct eigen_fill_helper : std::false_type {}; + +template +struct eigen_fill_helper> : std::true_type {}; + +template +struct eigen_fill_helper> : std::true_type {}; + +template +struct eigen_fill_helper> : eigen_fill_helper {}; + +template +struct eigen_fill_helper> + : std::integral_constant::value && + (Xpr::IsRowMajor ? (BlockRows == 1) : (BlockCols == 1))> {}; + +template +struct eigen_fill_helper>> : eigen_fill_helper {}; + +template +struct eigen_fill_helper>> + : std::integral_constant::value && + enum_eq_not_dynamic(OuterStride_, Xpr::InnerSizeAtCompileTime)> {}; + +template +struct eigen_fill_helper>> + : eigen_fill_helper>> {}; + +template +struct eigen_fill_helper>> + : eigen_fill_helper>> {}; + +template +struct eigen_fill_helper>> + : eigen_fill_helper>> {}; + +template +struct eigen_fill_impl { + using Scalar = typename Xpr::Scalar; + using Func = scalar_constant_op; + using PlainObject = typename Xpr::PlainObject; + using Constant = typename PlainObject::ConstantReturnType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void run(Xpr& dst, const Scalar& val) { + const Constant src(dst.rows(), dst.cols(), val); + run(dst, src); + } + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void run(Xpr& dst, const SrcXpr& src) { + call_dense_assignment_loop(dst, src, assign_op()); + } +}; + +#if EIGEN_COMP_MSVC || defined(EIGEN_GPU_COMPILE_PHASE) +template +struct eigen_fill_impl : eigen_fill_impl {}; +#else +template +struct eigen_fill_impl { + using Scalar = typename Xpr::Scalar; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Xpr& dst, const Scalar& val) { + const Scalar val_copy = val; + using std::fill_n; + fill_n(dst.data(), dst.size(), val_copy); + } + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Xpr& dst, const SrcXpr& src) { + resize_if_allowed(dst, src, assign_op()); + const Scalar& val = src.functor()(); + run(dst, val); + } +}; +#endif + +template +struct eigen_memset_helper { + static constexpr bool value = + std::is_trivially_copyable::value && eigen_fill_helper::value; +}; + +template +struct eigen_zero_impl { + using Scalar = typename Xpr::Scalar; + using PlainObject = typename Xpr::PlainObject; + using Zero = typename PlainObject::ZeroReturnType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void run(Xpr& dst) { + const Zero src(dst.rows(), dst.cols()); + run(dst, src); + } + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void run(Xpr& dst, const SrcXpr& src) { + call_dense_assignment_loop(dst, src, assign_op()); + } +}; + +template +struct eigen_zero_impl { + using Scalar = typename Xpr::Scalar; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Xpr& dst) { + const std::ptrdiff_t num_bytes = dst.size() * static_cast(sizeof(Scalar)); + if (num_bytes <= 0) return; + void* dst_ptr = static_cast(dst.data()); +#ifndef EIGEN_NO_DEBUG + eigen_assert((dst_ptr != nullptr) && "null pointer dereference error!"); +#endif + EIGEN_USING_STD(memset); + memset(dst_ptr, 0, static_cast(num_bytes)); + } + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Xpr& dst, const SrcXpr& src) { + resize_if_allowed(dst, src, assign_op()); + run(dst); + } +}; + +} // namespace internal +} // namespace Eigen + +#endif // EIGEN_FILL_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/FindCoeff.h b/src/3rdparty/eigen/Eigen/src/Core/FindCoeff.h new file mode 100644 index 0000000..0102e8a --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/FindCoeff.h @@ -0,0 +1,464 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2025 Charlie Schlosser +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_FIND_COEFF_H +#define EIGEN_FIND_COEFF_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template ::IsInteger> +struct max_coeff_functor { + EIGEN_DEVICE_FUNC inline bool compareCoeff(const Scalar& incumbent, const Scalar& candidate) const { + return candidate > incumbent; + } + template + EIGEN_DEVICE_FUNC inline Packet comparePacket(const Packet& incumbent, const Packet& candidate) const { + return pcmp_lt(incumbent, candidate); + } + template + EIGEN_DEVICE_FUNC inline Scalar predux(const Packet& a) const { + return predux_max(a); + } +}; + +template +struct max_coeff_functor { + EIGEN_DEVICE_FUNC inline Scalar compareCoeff(const Scalar& incumbent, const Scalar& candidate) { + return (candidate > incumbent) || ((candidate != candidate) && (incumbent == incumbent)); + } + template + EIGEN_DEVICE_FUNC inline Packet comparePacket(const Packet& incumbent, const Packet& candidate) { + return pandnot(pcmp_lt_or_nan(incumbent, candidate), pisnan(incumbent)); + } + template + EIGEN_DEVICE_FUNC inline Scalar predux(const Packet& a) const { + return predux_max(a); + } +}; + +template +struct max_coeff_functor { + EIGEN_DEVICE_FUNC inline bool compareCoeff(const Scalar& incumbent, const Scalar& candidate) const { + return (candidate > incumbent) || ((candidate == candidate) && (incumbent != incumbent)); + } + template + EIGEN_DEVICE_FUNC inline Packet comparePacket(const Packet& incumbent, const Packet& candidate) const { + return pandnot(pcmp_lt_or_nan(incumbent, candidate), pisnan(candidate)); + } + template + EIGEN_DEVICE_FUNC inline Scalar predux(const Packet& a) const { + return predux_max(a); + } +}; + +template ::IsInteger> +struct min_coeff_functor { + EIGEN_DEVICE_FUNC inline bool compareCoeff(const Scalar& incumbent, const Scalar& candidate) const { + return candidate < incumbent; + } + template + EIGEN_DEVICE_FUNC inline Packet comparePacket(const Packet& incumbent, const Packet& candidate) const { + return pcmp_lt(candidate, incumbent); + } + template + EIGEN_DEVICE_FUNC inline Scalar predux(const Packet& a) const { + return predux_min(a); + } +}; + +template +struct min_coeff_functor { + EIGEN_DEVICE_FUNC inline Scalar compareCoeff(const Scalar& incumbent, const Scalar& candidate) { + return (candidate < incumbent) || ((candidate != candidate) && (incumbent == incumbent)); + } + template + EIGEN_DEVICE_FUNC inline Packet comparePacket(const Packet& incumbent, const Packet& candidate) { + return pandnot(pcmp_lt_or_nan(candidate, incumbent), pisnan(incumbent)); + } + template + EIGEN_DEVICE_FUNC inline Scalar predux(const Packet& a) const { + return predux_min(a); + } +}; + +template +struct min_coeff_functor { + EIGEN_DEVICE_FUNC inline bool compareCoeff(const Scalar& incumbent, const Scalar& candidate) const { + return (candidate < incumbent) || ((candidate == candidate) && (incumbent != incumbent)); + } + template + EIGEN_DEVICE_FUNC inline Packet comparePacket(const Packet& incumbent, const Packet& candidate) const { + return pandnot(pcmp_lt_or_nan(candidate, incumbent), pisnan(candidate)); + } + template + EIGEN_DEVICE_FUNC inline Scalar predux(const Packet& a) const { + return predux_min(a); + } +}; + +template +struct min_max_traits { + static constexpr bool PacketAccess = packet_traits::Vectorizable; +}; +template +struct functor_traits> : min_max_traits {}; +template +struct functor_traits> : min_max_traits {}; + +template +struct find_coeff_loop; +template +struct find_coeff_loop { + using Scalar = typename Evaluator::Scalar; + static EIGEN_DEVICE_FUNC inline void run(const Evaluator& eval, Func& func, Scalar& res, Index& outer, Index& inner) { + Index outerSize = eval.outerSize(); + Index innerSize = eval.innerSize(); + + /* initialization performed in calling function */ + /* result = eval.coeff(0, 0); */ + /* outer = 0; */ + /* inner = 0; */ + + for (Index j = 0; j < outerSize; j++) { + for (Index i = 0; i < innerSize; i++) { + Scalar xprCoeff = eval.coeffByOuterInner(j, i); + bool newRes = func.compareCoeff(res, xprCoeff); + if (newRes) { + outer = j; + inner = i; + res = xprCoeff; + } + } + } + } +}; +template +struct find_coeff_loop { + using Scalar = typename Evaluator::Scalar; + static EIGEN_DEVICE_FUNC inline void run(const Evaluator& eval, Func& func, Scalar& res, Index& index) { + Index size = eval.size(); + + /* initialization performed in calling function */ + /* result = eval.coeff(0); */ + /* index = 0; */ + + for (Index k = 0; k < size; k++) { + Scalar xprCoeff = eval.coeff(k); + bool newRes = func.compareCoeff(res, xprCoeff); + if (newRes) { + index = k; + res = xprCoeff; + } + } + } +}; +template +struct find_coeff_loop { + using ScalarImpl = find_coeff_loop; + using Scalar = typename Evaluator::Scalar; + using Packet = typename Evaluator::Packet; + static constexpr int PacketSize = unpacket_traits::size; + static EIGEN_DEVICE_FUNC inline void run(const Evaluator& eval, Func& func, Scalar& result, Index& outer, + Index& inner) { + Index outerSize = eval.outerSize(); + Index innerSize = eval.innerSize(); + Index packetEnd = numext::round_down(innerSize, PacketSize); + + /* initialization performed in calling function */ + /* result = eval.coeff(0, 0); */ + /* outer = 0; */ + /* inner = 0; */ + + bool checkPacket = false; + + for (Index j = 0; j < outerSize; j++) { + Packet resultPacket = pset1(result); + for (Index i = 0; i < packetEnd; i += PacketSize) { + Packet xprPacket = eval.template packetByOuterInner(j, i); + if (predux_any(func.comparePacket(resultPacket, xprPacket))) { + outer = j; + inner = i; + result = func.predux(xprPacket); + resultPacket = pset1(result); + checkPacket = true; + } + } + + for (Index i = packetEnd; i < innerSize; i++) { + Scalar xprCoeff = eval.coeffByOuterInner(j, i); + if (func.compareCoeff(result, xprCoeff)) { + outer = j; + inner = i; + result = xprCoeff; + checkPacket = false; + } + } + } + + if (checkPacket) { + result = eval.coeffByOuterInner(outer, inner); + Index i_end = inner + PacketSize; + for (Index i = inner; i < i_end; i++) { + Scalar xprCoeff = eval.coeffByOuterInner(outer, i); + if (func.compareCoeff(result, xprCoeff)) { + inner = i; + result = xprCoeff; + } + } + } + } +}; +template +struct find_coeff_loop { + using ScalarImpl = find_coeff_loop; + using Scalar = typename Evaluator::Scalar; + using Packet = typename Evaluator::Packet; + static constexpr int PacketSize = unpacket_traits::size; + static constexpr int Alignment = Evaluator::Alignment; + + static EIGEN_DEVICE_FUNC inline void run(const Evaluator& eval, Func& func, Scalar& result, Index& index) { + Index size = eval.size(); + Index packetEnd = numext::round_down(size, PacketSize); + + /* initialization performed in calling function */ + /* result = eval.coeff(0); */ + /* index = 0; */ + + Packet resultPacket = pset1(result); + bool checkPacket = false; + + for (Index k = 0; k < packetEnd; k += PacketSize) { + Packet xprPacket = eval.template packet(k); + if (predux_any(func.comparePacket(resultPacket, xprPacket))) { + index = k; + result = func.predux(xprPacket); + resultPacket = pset1(result); + checkPacket = true; + } + } + + for (Index k = packetEnd; k < size; k++) { + Scalar xprCoeff = eval.coeff(k); + if (func.compareCoeff(result, xprCoeff)) { + index = k; + result = xprCoeff; + checkPacket = false; + } + } + + if (checkPacket) { + result = eval.coeff(index); + Index k_end = index + PacketSize; + for (Index k = index; k < k_end; k++) { + Scalar xprCoeff = eval.coeff(k); + if (func.compareCoeff(result, xprCoeff)) { + index = k; + result = xprCoeff; + } + } + } + } +}; + +template +struct find_coeff_evaluator : public evaluator { + using Base = evaluator; + using Scalar = typename Derived::Scalar; + using Packet = typename packet_traits::type; + static constexpr int Flags = Base::Flags; + static constexpr bool IsRowMajor = bool(Flags & RowMajorBit); + EIGEN_DEVICE_FUNC inline find_coeff_evaluator(const Derived& xpr) : Base(xpr), m_xpr(xpr) {} + + EIGEN_DEVICE_FUNC inline Scalar coeffByOuterInner(Index outer, Index inner) const { + Index row = IsRowMajor ? outer : inner; + Index col = IsRowMajor ? inner : outer; + return Base::coeff(row, col); + } + template + EIGEN_DEVICE_FUNC inline PacketType packetByOuterInner(Index outer, Index inner) const { + Index row = IsRowMajor ? outer : inner; + Index col = IsRowMajor ? inner : outer; + return Base::template packet(row, col); + } + + EIGEN_DEVICE_FUNC inline Index innerSize() const { return m_xpr.innerSize(); } + EIGEN_DEVICE_FUNC inline Index outerSize() const { return m_xpr.outerSize(); } + EIGEN_DEVICE_FUNC inline Index size() const { return m_xpr.size(); } + + const Derived& m_xpr; +}; + +template +struct find_coeff_impl { + using Evaluator = find_coeff_evaluator; + static constexpr int Flags = Evaluator::Flags; + static constexpr int Alignment = Evaluator::Alignment; + static constexpr bool IsRowMajor = Derived::IsRowMajor; + static constexpr int MaxInnerSizeAtCompileTime = + IsRowMajor ? Derived::MaxColsAtCompileTime : Derived::MaxRowsAtCompileTime; + static constexpr int MaxSizeAtCompileTime = Derived::MaxSizeAtCompileTime; + + using Scalar = typename Derived::Scalar; + using Packet = typename Evaluator::Packet; + + static constexpr int PacketSize = unpacket_traits::size; + static constexpr bool Linearize = bool(Flags & LinearAccessBit); + static constexpr bool DontVectorize = + enum_lt_not_dynamic(Linearize ? MaxSizeAtCompileTime : MaxInnerSizeAtCompileTime, PacketSize); + static constexpr bool Vectorize = + !DontVectorize && bool(Flags & PacketAccessBit) && functor_traits::PacketAccess; + + using Loop = find_coeff_loop; + + template = true> + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(const Derived& xpr, Func& func, Scalar& res, Index& outer, + Index& inner) { + Evaluator eval(xpr); + Loop::run(eval, func, res, outer, inner); + } + template = true> + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(const Derived& xpr, Func& func, Scalar& res, Index& outer, + Index& inner) { + // where possible, use the linear loop and back-calculate the outer and inner indices + Index index = 0; + run(xpr, func, res, index); + outer = index / xpr.innerSize(); + inner = index % xpr.innerSize(); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(const Derived& xpr, Func& func, Scalar& res, Index& index) { + Evaluator eval(xpr); + Loop::run(eval, func, res, index); + } +}; + +template +EIGEN_DEVICE_FUNC typename internal::traits::Scalar findCoeff(const DenseBase& mat, Func& func, + IndexType* rowPtr, IndexType* colPtr) { + eigen_assert(mat.rows() > 0 && mat.cols() > 0 && "you are using an empty matrix"); + using Scalar = typename DenseBase::Scalar; + using FindCoeffImpl = internal::find_coeff_impl; + Index outer = 0; + Index inner = 0; + Scalar res = mat.coeff(0, 0); + FindCoeffImpl::run(mat.derived(), func, res, outer, inner); + *rowPtr = internal::convert_index(Derived::IsRowMajor ? outer : inner); + if (colPtr) *colPtr = internal::convert_index(Derived::IsRowMajor ? inner : outer); + return res; +} + +template +EIGEN_DEVICE_FUNC typename internal::traits::Scalar findCoeff(const DenseBase& mat, Func& func, + IndexType* indexPtr) { + eigen_assert(mat.size() > 0 && "you are using an empty matrix"); + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + using Scalar = typename DenseBase::Scalar; + using FindCoeffImpl = internal::find_coeff_impl; + Index index = 0; + Scalar res = mat.coeff(0); + FindCoeffImpl::run(mat.derived(), func, res, index); + *indexPtr = internal::convert_index(index); + return res; +} + +} // namespace internal + +/** \fn DenseBase::minCoeff(IndexType* rowId, IndexType* colId) const + * \returns the minimum of all coefficients of *this and puts in *row and *col its location. + * + * If there are multiple coefficients with the same extreme value, the location of the first instance is returned. + * + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is maximum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + * + * \sa DenseBase::minCoeff(Index*), DenseBase::maxCoeff(Index*,Index*), DenseBase::visit(), DenseBase::minCoeff() + */ +template +template +EIGEN_DEVICE_FUNC typename internal::traits::Scalar DenseBase::minCoeff(IndexType* rowPtr, + IndexType* colPtr) const { + using Func = internal::min_coeff_functor; + Func func; + return internal::findCoeff(derived(), func, rowPtr, colPtr); +} + +/** \returns the minimum of all coefficients of *this and puts in *index its location. + * + * If there are multiple coefficients with the same extreme value, the location of the first instance is returned. + * + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is maximum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + * + * \sa DenseBase::minCoeff(IndexType*,IndexType*), DenseBase::maxCoeff(IndexType*,IndexType*), DenseBase::visit(), + * DenseBase::minCoeff() + */ +template +template +EIGEN_DEVICE_FUNC typename internal::traits::Scalar DenseBase::minCoeff(IndexType* indexPtr) const { + using Func = internal::min_coeff_functor; + Func func; + return internal::findCoeff(derived(), func, indexPtr); +} + +/** \fn DenseBase::maxCoeff(IndexType* rowId, IndexType* colId) const + * \returns the maximum of all coefficients of *this and puts in *row and *col its location. + * + * If there are multiple coefficients with the same extreme value, the location of the first instance is returned. + * + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is maximum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + * + * \sa DenseBase::minCoeff(IndexType*,IndexType*), DenseBase::visit(), DenseBase::maxCoeff() + */ +template +template +EIGEN_DEVICE_FUNC typename internal::traits::Scalar DenseBase::maxCoeff(IndexType* rowPtr, + IndexType* colPtr) const { + using Func = internal::max_coeff_functor; + Func func; + return internal::findCoeff(derived(), func, rowPtr, colPtr); +} + +/** \returns the maximum of all coefficients of *this and puts in *index its location. + * + * If there are multiple coefficients with the same extreme value, the location of the first instance is returned. + * + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is maximum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + * + * \sa DenseBase::maxCoeff(IndexType*,IndexType*), DenseBase::minCoeff(IndexType*,IndexType*), DenseBase::visitor(), + * DenseBase::maxCoeff() + */ +template +template +EIGEN_DEVICE_FUNC typename internal::traits::Scalar DenseBase::maxCoeff(IndexType* indexPtr) const { + using Func = internal::max_coeff_functor; + Func func; + return internal::findCoeff(derived(), func, indexPtr); +} + +} // namespace Eigen + +#endif // EIGEN_FIND_COEFF_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ForceAlignedAccess.h b/src/3rdparty/eigen/Eigen/src/Core/ForceAlignedAccess.h new file mode 100644 index 0000000..55beab3 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ForceAlignedAccess.h @@ -0,0 +1,127 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_FORCEALIGNEDACCESS_H +#define EIGEN_FORCEALIGNEDACCESS_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class ForceAlignedAccess + * \ingroup Core_Module + * + * \brief Enforce aligned packet loads and stores regardless of what is requested + * + * \param ExpressionType the type of the object of which we are forcing aligned packet access + * + * This class is the return type of MatrixBase::forceAlignedAccess() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::forceAlignedAccess() + */ + +namespace internal { +template +struct traits> : public traits {}; +} // namespace internal + +template +class ForceAlignedAccess : public internal::dense_xpr_base>::type { + public: + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ForceAlignedAccess) + + EIGEN_DEVICE_FUNC explicit inline ForceAlignedAccess(const ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_expression.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_expression.cols(); } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC inline const CoeffReturnType coeff(Index row, Index col) const { + return m_expression.coeff(row, col); + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index row, Index col) { + return m_expression.const_cast_derived().coeffRef(row, col); + } + + EIGEN_DEVICE_FUNC inline const CoeffReturnType coeff(Index index) const { return m_expression.coeff(index); } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index index) { return m_expression.const_cast_derived().coeffRef(index); } + + template + inline const PacketScalar packet(Index row, Index col) const { + return m_expression.template packet(row, col); + } + + template + inline void writePacket(Index row, Index col, const PacketScalar& x) { + m_expression.const_cast_derived().template writePacket(row, col, x); + } + + template + inline const PacketScalar packet(Index index) const { + return m_expression.template packet(index); + } + + template + inline void writePacket(Index index, const PacketScalar& x) { + m_expression.const_cast_derived().template writePacket(index, x); + } + + EIGEN_DEVICE_FUNC operator const ExpressionType&() const { return m_expression; } + + protected: + const ExpressionType& m_expression; + + private: + ForceAlignedAccess& operator=(const ForceAlignedAccess&); +}; + +/** \returns an expression of *this with forced aligned access + * \sa forceAlignedAccessIf(),class ForceAlignedAccess + */ +template +inline const ForceAlignedAccess MatrixBase::forceAlignedAccess() const { + return ForceAlignedAccess(derived()); +} + +/** \returns an expression of *this with forced aligned access + * \sa forceAlignedAccessIf(), class ForceAlignedAccess + */ +template +inline ForceAlignedAccess MatrixBase::forceAlignedAccess() { + return ForceAlignedAccess(derived()); +} + +/** \returns an expression of *this with forced aligned access if \a Enable is true. + * \sa forceAlignedAccess(), class ForceAlignedAccess + */ +template +template +inline add_const_on_value_type_t, Derived&>> +MatrixBase::forceAlignedAccessIf() const { + return derived(); // FIXME This should not work but apparently is never used +} + +/** \returns an expression of *this with forced aligned access if \a Enable is true. + * \sa forceAlignedAccess(), class ForceAlignedAccess + */ +template +template +inline std::conditional_t, Derived&> MatrixBase::forceAlignedAccessIf() { + return derived(); // FIXME This should not work but apparently is never used +} + +} // end namespace Eigen + +#endif // EIGEN_FORCEALIGNEDACCESS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h b/src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h new file mode 100644 index 0000000..ed6b4ff --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h @@ -0,0 +1,132 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_FUZZY_H +#define EIGEN_FUZZY_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template ::IsInteger> +struct isApprox_selector { + EIGEN_DEVICE_FUNC static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar& prec) { + typename internal::nested_eval::type nested(x); + typename internal::nested_eval::type otherNested(y); + return (nested.matrix() - otherNested.matrix()).cwiseAbs2().sum() <= + prec * prec * numext::mini(nested.cwiseAbs2().sum(), otherNested.cwiseAbs2().sum()); + } +}; + +template +struct isApprox_selector { + EIGEN_DEVICE_FUNC static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar&) { + return x.matrix() == y.matrix(); + } +}; + +template ::IsInteger> +struct isMuchSmallerThan_object_selector { + EIGEN_DEVICE_FUNC static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar& prec) { + return x.cwiseAbs2().sum() <= numext::abs2(prec) * y.cwiseAbs2().sum(); + } +}; + +template +struct isMuchSmallerThan_object_selector { + EIGEN_DEVICE_FUNC static bool run(const Derived& x, const OtherDerived&, const typename Derived::RealScalar&) { + return x.matrix() == Derived::Zero(x.rows(), x.cols()).matrix(); + } +}; + +template ::IsInteger> +struct isMuchSmallerThan_scalar_selector { + EIGEN_DEVICE_FUNC static bool run(const Derived& x, const typename Derived::RealScalar& y, + const typename Derived::RealScalar& prec) { + return x.cwiseAbs2().sum() <= numext::abs2(prec * y); + } +}; + +template +struct isMuchSmallerThan_scalar_selector { + EIGEN_DEVICE_FUNC static bool run(const Derived& x, const typename Derived::RealScalar&, + const typename Derived::RealScalar&) { + return x.matrix() == Derived::Zero(x.rows(), x.cols()).matrix(); + } +}; + +} // end namespace internal + +/** \returns \c true if \c *this is approximately equal to \a other, within the precision + * determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. Two vectors \f$ v \f$ and \f$ w \f$ + * are considered to be approximately equal within precision \f$ p \f$ if + * \f[ \Vert v - w \Vert \leqslant p\,\min(\Vert v\Vert, \Vert w\Vert). \f] + * For matrices, the comparison is done using the Hilbert-Schmidt norm (aka Frobenius norm + * L2 norm). + * + * \note Because of the multiplicativeness of this comparison, one can't use this function + * to check whether \c *this is approximately equal to the zero matrix or vector. + * Indeed, \c isApprox(zero) returns false unless \c *this itself is exactly the zero matrix + * or vector. If you want to test whether \c *this is zero, use internal::isMuchSmallerThan(const + * RealScalar&, RealScalar) instead. + * + * \sa internal::isMuchSmallerThan(const RealScalar&, RealScalar) const + */ +template +template +EIGEN_DEVICE_FUNC bool DenseBase::isApprox(const DenseBase& other, + const RealScalar& prec) const { + return internal::isApprox_selector::run(derived(), other.derived(), prec); +} + +/** \returns \c true if the norm of \c *this is much smaller than \a other, + * within the precision determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. A vector \f$ v \f$ is + * considered to be much smaller than \f$ x \f$ within precision \f$ p \f$ if + * \f[ \Vert v \Vert \leqslant p\,\vert x\vert. \f] + * + * For matrices, the comparison is done using the Hilbert-Schmidt norm. For this reason, + * the value of the reference scalar \a other should come from the Hilbert-Schmidt norm + * of a reference matrix of same dimensions. + * + * \sa isApprox(), isMuchSmallerThan(const DenseBase&, RealScalar) const + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isMuchSmallerThan(const typename NumTraits::Real& other, + const RealScalar& prec) const { + return internal::isMuchSmallerThan_scalar_selector::run(derived(), other, prec); +} + +/** \returns \c true if the norm of \c *this is much smaller than the norm of \a other, + * within the precision determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. A vector \f$ v \f$ is + * considered to be much smaller than a vector \f$ w \f$ within precision \f$ p \f$ if + * \f[ \Vert v \Vert \leqslant p\,\Vert w\Vert. \f] + * For matrices, the comparison is done using the Hilbert-Schmidt norm. + * + * \sa isApprox(), isMuchSmallerThan(const RealScalar&, RealScalar) const + */ +template +template +EIGEN_DEVICE_FUNC bool DenseBase::isMuchSmallerThan(const DenseBase& other, + const RealScalar& prec) const { + return internal::isMuchSmallerThan_object_selector::run(derived(), other.derived(), prec); +} + +} // end namespace Eigen + +#endif // EIGEN_FUZZY_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/GeneralProduct.h b/src/3rdparty/eigen/Eigen/src/Core/GeneralProduct.h new file mode 100644 index 0000000..e4c51d2 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/GeneralProduct.h @@ -0,0 +1,519 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008-2011 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GENERAL_PRODUCT_H +#define EIGEN_GENERAL_PRODUCT_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +enum { Large = 2, Small = 3 }; + +// Define the threshold value to fallback from the generic matrix-matrix product +// implementation (heavy) to the lightweight coeff-based product one. +// See generic_product_impl +// in products/GeneralMatrixMatrix.h for more details. +// TODO This threshold should also be used in the compile-time selector below. +#ifndef EIGEN_GEMM_TO_COEFFBASED_THRESHOLD +// This default value has been obtained on a Haswell architecture. +#define EIGEN_GEMM_TO_COEFFBASED_THRESHOLD 20 +#endif + +namespace internal { + +template +struct product_type_selector; + +template +struct product_size_category { + enum { +#ifndef EIGEN_GPU_COMPILE_PHASE + is_large = MaxSize == Dynamic || Size >= EIGEN_CACHEFRIENDLY_PRODUCT_THRESHOLD || + (Size == Dynamic && MaxSize >= EIGEN_CACHEFRIENDLY_PRODUCT_THRESHOLD), +#else + is_large = 0, +#endif + value = is_large ? Large + : Size == 1 ? 1 + : Small + }; +}; + +template +struct product_type { + typedef remove_all_t Lhs_; + typedef remove_all_t Rhs_; + enum { + MaxRows = traits::MaxRowsAtCompileTime, + Rows = traits::RowsAtCompileTime, + MaxCols = traits::MaxColsAtCompileTime, + Cols = traits::ColsAtCompileTime, + MaxDepth = min_size_prefer_fixed(traits::MaxColsAtCompileTime, traits::MaxRowsAtCompileTime), + Depth = min_size_prefer_fixed(traits::ColsAtCompileTime, traits::RowsAtCompileTime) + }; + + // the splitting into different lines of code here, introducing the _select enums and the typedef below, + // is to work around an internal compiler error with gcc 4.1 and 4.2. + private: + enum { + rows_select = product_size_category::value, + cols_select = product_size_category::value, + depth_select = product_size_category::value + }; + typedef product_type_selector selector; + + public: + enum { value = selector::ret, ret = selector::ret }; +#ifdef EIGEN_DEBUG_PRODUCT + static void debug() { + EIGEN_DEBUG_VAR(Rows); + EIGEN_DEBUG_VAR(Cols); + EIGEN_DEBUG_VAR(Depth); + EIGEN_DEBUG_VAR(rows_select); + EIGEN_DEBUG_VAR(cols_select); + EIGEN_DEBUG_VAR(depth_select); + EIGEN_DEBUG_VAR(value); + } +#endif +}; + +/* The following allows to select the kind of product at compile time + * based on the three dimensions of the product. + * This is a compile time mapping from {1,Small,Large}^3 -> {product types} */ +// FIXME I'm not sure the current mapping is the ideal one. +template +struct product_type_selector { + enum { ret = OuterProduct }; +}; +template +struct product_type_selector { + enum { ret = LazyCoeffBasedProductMode }; +}; +template +struct product_type_selector<1, N, 1> { + enum { ret = LazyCoeffBasedProductMode }; +}; +template +struct product_type_selector<1, 1, Depth> { + enum { ret = InnerProduct }; +}; +template <> +struct product_type_selector<1, 1, 1> { + enum { ret = InnerProduct }; +}; +template <> +struct product_type_selector { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector<1, Small, Small> { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = LazyCoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = LazyCoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = LazyCoeffBasedProductMode }; +}; +template <> +struct product_type_selector<1, Large, Small> { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector<1, Large, Large> { + enum { ret = GemvProduct }; +}; +template <> +struct product_type_selector<1, Small, Large> { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = GemvProduct }; +}; +template <> +struct product_type_selector { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = GemmProduct }; +}; +template <> +struct product_type_selector { + enum { ret = GemmProduct }; +}; +template <> +struct product_type_selector { + enum { ret = GemmProduct }; +}; +template <> +struct product_type_selector { + enum { ret = GemmProduct }; +}; +template <> +struct product_type_selector { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = CoeffBasedProductMode }; +}; +template <> +struct product_type_selector { + enum { ret = GemmProduct }; +}; + +} // end namespace internal + +/*********************************************************************** + * Implementation of Inner Vector Vector Product + ***********************************************************************/ + +// FIXME : maybe the "inner product" could return a Scalar +// instead of a 1x1 matrix ?? +// Pro: more natural for the user +// Cons: this could be a problem if in a meta unrolled algorithm a matrix-matrix +// product ends up to a row-vector times col-vector product... To tackle this use +// case, we could have a specialization for Block with: operator=(Scalar x); + +/*********************************************************************** + * Implementation of Outer Vector Vector Product + ***********************************************************************/ + +/*********************************************************************** + * Implementation of General Matrix Vector Product + ***********************************************************************/ + +/* According to the shape/flags of the matrix we have to distinghish 3 different cases: + * 1 - the matrix is col-major, BLAS compatible and M is large => call fast BLAS-like colmajor routine + * 2 - the matrix is row-major, BLAS compatible and N is large => call fast BLAS-like rowmajor routine + * 3 - all other cases are handled using a simple loop along the outer-storage direction. + * Therefore we need a lower level meta selector. + * Furthermore, if the matrix is the rhs, then the product has to be transposed. + */ +namespace internal { + +template +struct gemv_dense_selector; + +} // end namespace internal + +namespace internal { + +template +struct gemv_static_vector_if; + +template +struct gemv_static_vector_if { + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC constexpr Scalar* data() { + eigen_internal_assert(false && "should never be called"); + return 0; + } +}; + +template +struct gemv_static_vector_if { + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC constexpr Scalar* data() { return 0; } +}; + +template +struct gemv_static_vector_if { +#if EIGEN_MAX_STATIC_ALIGN_BYTES != 0 + internal::plain_array m_data; + EIGEN_STRONG_INLINE constexpr Scalar* data() { return m_data.array; } +#else + // Some architectures cannot align on the stack, + // => let's manually enforce alignment by allocating more data and return the address of the first aligned element. + internal::plain_array m_data; + EIGEN_STRONG_INLINE constexpr Scalar* data() { + return reinterpret_cast((std::uintptr_t(m_data.array) & ~(std::size_t(EIGEN_MAX_ALIGN_BYTES - 1))) + + EIGEN_MAX_ALIGN_BYTES); + } +#endif +}; + +// The vector is on the left => transposition +template +struct gemv_dense_selector { + template + static void run(const Lhs& lhs, const Rhs& rhs, Dest& dest, const typename Dest::Scalar& alpha) { + Transpose destT(dest); + enum { OtherStorageOrder = StorageOrder == RowMajor ? ColMajor : RowMajor }; + gemv_dense_selector::run(rhs.transpose(), lhs.transpose(), destT, + alpha); + } +}; + +template <> +struct gemv_dense_selector { + template + static inline void run(const Lhs& lhs, const Rhs& rhs, Dest& dest, const typename Dest::Scalar& alpha) { + typedef typename Lhs::Scalar LhsScalar; + typedef typename Rhs::Scalar RhsScalar; + typedef typename Dest::Scalar ResScalar; + + typedef internal::blas_traits LhsBlasTraits; + typedef typename LhsBlasTraits::DirectLinearAccessType ActualLhsType; + typedef internal::blas_traits RhsBlasTraits; + typedef typename RhsBlasTraits::DirectLinearAccessType ActualRhsType; + + typedef Map, plain_enum_min(AlignedMax, internal::packet_traits::size)> + MappedDest; + + ActualLhsType actualLhs = LhsBlasTraits::extract(lhs); + ActualRhsType actualRhs = RhsBlasTraits::extract(rhs); + + ResScalar actualAlpha = combine_scalar_factors(alpha, lhs, rhs); + + // make sure Dest is a compile-time vector type (bug 1166) + typedef std::conditional_t ActualDest; + + enum { + // FIXME find a way to allow an inner stride on the result if packet_traits::size==1 + // on, the other hand it is good for the cache to pack the vector anyways... + EvalToDestAtCompileTime = (ActualDest::InnerStrideAtCompileTime == 1), + ComplexByReal = (NumTraits::IsComplex) && (!NumTraits::IsComplex), + MightCannotUseDest = ((!EvalToDestAtCompileTime) || ComplexByReal) && (ActualDest::MaxSizeAtCompileTime != 0) + }; + + typedef const_blas_data_mapper LhsMapper; + typedef const_blas_data_mapper RhsMapper; + RhsScalar compatibleAlpha = get_factor::run(actualAlpha); + + if (!MightCannotUseDest) { + // shortcut if we are sure to be able to use dest directly, + // this ease the compiler to generate cleaner and more optimzized code for most common cases + general_matrix_vector_product::run(actualLhs.rows(), actualLhs.cols(), + LhsMapper(actualLhs.data(), + actualLhs.outerStride()), + RhsMapper(actualRhs.data(), + actualRhs.innerStride()), + dest.data(), 1, compatibleAlpha); + } else { + gemv_static_vector_if + static_dest; + + const bool alphaIsCompatible = (!ComplexByReal) || (numext::is_exactly_zero(numext::imag(actualAlpha))); + const bool evalToDest = EvalToDestAtCompileTime && alphaIsCompatible; + + ei_declare_aligned_stack_constructed_variable(ResScalar, actualDestPtr, dest.size(), + evalToDest ? dest.data() : static_dest.data()); + + if (!evalToDest) { +#ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + constexpr int Size = Dest::SizeAtCompileTime; + Index size = dest.size(); + EIGEN_DENSE_STORAGE_CTOR_PLUGIN +#endif + if (!alphaIsCompatible) { + MappedDest(actualDestPtr, dest.size()).setZero(); + compatibleAlpha = RhsScalar(1); + } else + MappedDest(actualDestPtr, dest.size()) = dest; + } + + general_matrix_vector_product::run(actualLhs.rows(), actualLhs.cols(), + LhsMapper(actualLhs.data(), + actualLhs.outerStride()), + RhsMapper(actualRhs.data(), + actualRhs.innerStride()), + actualDestPtr, 1, compatibleAlpha); + + if (!evalToDest) { + if (!alphaIsCompatible) + dest.matrix() += actualAlpha * MappedDest(actualDestPtr, dest.size()); + else + dest = MappedDest(actualDestPtr, dest.size()); + } + } + } +}; + +template <> +struct gemv_dense_selector { + template + static void run(const Lhs& lhs, const Rhs& rhs, Dest& dest, const typename Dest::Scalar& alpha) { + typedef typename Lhs::Scalar LhsScalar; + typedef typename Rhs::Scalar RhsScalar; + typedef typename Dest::Scalar ResScalar; + + typedef internal::blas_traits LhsBlasTraits; + typedef typename LhsBlasTraits::DirectLinearAccessType ActualLhsType; + typedef internal::blas_traits RhsBlasTraits; + typedef typename RhsBlasTraits::DirectLinearAccessType ActualRhsType; + typedef internal::remove_all_t ActualRhsTypeCleaned; + + std::add_const_t actualLhs = LhsBlasTraits::extract(lhs); + std::add_const_t actualRhs = RhsBlasTraits::extract(rhs); + + ResScalar actualAlpha = combine_scalar_factors(alpha, lhs, rhs); + + enum { + // FIXME find a way to allow an inner stride on the result if packet_traits::size==1 + // on, the other hand it is good for the cache to pack the vector anyways... + DirectlyUseRhs = + ActualRhsTypeCleaned::InnerStrideAtCompileTime == 1 || ActualRhsTypeCleaned::MaxSizeAtCompileTime == 0 + }; + + gemv_static_vector_if + static_rhs; + + ei_declare_aligned_stack_constructed_variable( + RhsScalar, actualRhsPtr, actualRhs.size(), + DirectlyUseRhs ? const_cast(actualRhs.data()) : static_rhs.data()); + + if (!DirectlyUseRhs) { +#ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + constexpr int Size = ActualRhsTypeCleaned::SizeAtCompileTime; + Index size = actualRhs.size(); + EIGEN_DENSE_STORAGE_CTOR_PLUGIN +#endif + Map(actualRhsPtr, actualRhs.size()) = actualRhs; + } + + typedef const_blas_data_mapper LhsMapper; + typedef const_blas_data_mapper RhsMapper; + general_matrix_vector_product:: + run(actualLhs.rows(), actualLhs.cols(), LhsMapper(actualLhs.data(), actualLhs.outerStride()), + RhsMapper(actualRhsPtr, 1), dest.data(), + dest.col(0).innerStride(), // NOTE if dest is not a vector at compile-time, then dest.innerStride() might + // be wrong. (bug 1166) + actualAlpha); + } +}; + +template <> +struct gemv_dense_selector { + template + static void run(const Lhs& lhs, const Rhs& rhs, Dest& dest, const typename Dest::Scalar& alpha) { + EIGEN_STATIC_ASSERT((!nested_eval::Evaluate), + EIGEN_INTERNAL_COMPILATION_ERROR_OR_YOU_MADE_A_PROGRAMMING_MISTAKE); + // TODO if rhs is large enough it might be beneficial to make sure that dest is sequentially stored in memory, + // otherwise use a temp + typename nested_eval::type actual_rhs(rhs); + const Index size = rhs.rows(); + for (Index k = 0; k < size; ++k) dest += (alpha * actual_rhs.coeff(k)) * lhs.col(k); + } +}; + +template <> +struct gemv_dense_selector { + template + static void run(const Lhs& lhs, const Rhs& rhs, Dest& dest, const typename Dest::Scalar& alpha) { + EIGEN_STATIC_ASSERT((!nested_eval::Evaluate), + EIGEN_INTERNAL_COMPILATION_ERROR_OR_YOU_MADE_A_PROGRAMMING_MISTAKE); + typename nested_eval::type actual_rhs(rhs); + const Index rows = dest.rows(); + for (Index i = 0; i < rows; ++i) + dest.coeffRef(i) += alpha * (lhs.row(i).cwiseProduct(actual_rhs.transpose())).sum(); + } +}; + +} // end namespace internal + +/*************************************************************************** + * Implementation of matrix base methods + ***************************************************************************/ + +/** \returns the matrix product of \c *this and \a other. + * + * \note If instead of the matrix product you want the coefficient-wise product, see Cwise::operator*(). + * + * \sa lazyProduct(), operator*=(const MatrixBase&), Cwise::operator*() + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Product MatrixBase::operator*( + const MatrixBase& other) const { + // A note regarding the function declaration: In MSVC, this function will sometimes + // not be inlined since DenseStorage is an unwindable object for dynamic + // matrices and product types are holding a member to store the result. + // Thus it does not help tagging this function with EIGEN_STRONG_INLINE. + enum { + ProductIsValid = Derived::ColsAtCompileTime == Dynamic || OtherDerived::RowsAtCompileTime == Dynamic || + int(Derived::ColsAtCompileTime) == int(OtherDerived::RowsAtCompileTime), + AreVectors = Derived::IsVectorAtCompileTime && OtherDerived::IsVectorAtCompileTime, + SameSizes = EIGEN_PREDICATE_SAME_MATRIX_SIZE(Derived, OtherDerived) + }; + // note to the lost user: + // * for a dot product use: v1.dot(v2) + // * for a coeff-wise product use: v1.cwiseProduct(v2) + EIGEN_STATIC_ASSERT( + ProductIsValid || !(AreVectors && SameSizes), + INVALID_VECTOR_VECTOR_PRODUCT__IF_YOU_WANTED_A_DOT_OR_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTIONS) + EIGEN_STATIC_ASSERT(ProductIsValid || !(SameSizes && !AreVectors), + INVALID_MATRIX_PRODUCT__IF_YOU_WANTED_A_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTION) + EIGEN_STATIC_ASSERT(ProductIsValid || SameSizes, INVALID_MATRIX_PRODUCT) +#ifdef EIGEN_DEBUG_PRODUCT + internal::product_type::debug(); +#endif + + return Product(derived(), other.derived()); +} + +/** \returns an expression of the matrix product of \c *this and \a other without implicit evaluation. + * + * The returned product will behave like any other expressions: the coefficients of the product will be + * computed once at a time as requested. This might be useful in some extremely rare cases when only + * a small and no coherent fraction of the result's coefficients have to be computed. + * + * \warning This version of the matrix product can be much much slower. So use it only if you know + * what you are doing and that you measured a true speed improvement. + * + * \sa operator*(const MatrixBase&) + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Product +MatrixBase::lazyProduct(const MatrixBase& other) const { + enum { + ProductIsValid = Derived::ColsAtCompileTime == Dynamic || OtherDerived::RowsAtCompileTime == Dynamic || + int(Derived::ColsAtCompileTime) == int(OtherDerived::RowsAtCompileTime), + AreVectors = Derived::IsVectorAtCompileTime && OtherDerived::IsVectorAtCompileTime, + SameSizes = EIGEN_PREDICATE_SAME_MATRIX_SIZE(Derived, OtherDerived) + }; + // note to the lost user: + // * for a dot product use: v1.dot(v2) + // * for a coeff-wise product use: v1.cwiseProduct(v2) + EIGEN_STATIC_ASSERT( + ProductIsValid || !(AreVectors && SameSizes), + INVALID_VECTOR_VECTOR_PRODUCT__IF_YOU_WANTED_A_DOT_OR_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTIONS) + EIGEN_STATIC_ASSERT(ProductIsValid || !(SameSizes && !AreVectors), + INVALID_MATRIX_PRODUCT__IF_YOU_WANTED_A_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTION) + EIGEN_STATIC_ASSERT(ProductIsValid || SameSizes, INVALID_MATRIX_PRODUCT) + + return Product(derived(), other.derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/GenericPacketMath.h b/src/3rdparty/eigen/Eigen/src/Core/GenericPacketMath.h new file mode 100644 index 0000000..64e1123 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/GenericPacketMath.h @@ -0,0 +1,1702 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GENERIC_PACKET_MATH_H +#define EIGEN_GENERIC_PACKET_MATH_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +/** \internal + * \file GenericPacketMath.h + * + * Default implementation for types not supported by the vectorization. + * In practice these functions are provided to make easier the writing + * of generic vectorized code. + */ + +#ifndef EIGEN_DEBUG_ALIGNED_LOAD +#define EIGEN_DEBUG_ALIGNED_LOAD +#endif + +#ifndef EIGEN_DEBUG_UNALIGNED_LOAD +#define EIGEN_DEBUG_UNALIGNED_LOAD +#endif + +#ifndef EIGEN_DEBUG_ALIGNED_STORE +#define EIGEN_DEBUG_ALIGNED_STORE +#endif + +#ifndef EIGEN_DEBUG_UNALIGNED_STORE +#define EIGEN_DEBUG_UNALIGNED_STORE +#endif + +struct default_packet_traits { + enum { + // Ops that are implemented for most types. + HasAdd = 1, + HasSub = 1, + HasShift = 1, + HasMul = 1, + HasNegate = 1, + HasAbs = 1, + HasAbs2 = 1, + HasMin = 1, + HasMax = 1, + HasConj = 1, + HasSetLinear = 1, + HasSign = 1, + // By default, the nearest integer functions (rint, round, floor, ceil, trunc) are enabled for all scalar and packet + // types + HasRound = 1, + + HasArg = 0, + HasAbsDiff = 0, + HasBlend = 0, + // This flag is used to indicate whether packet comparison is supported. + // pcmp_eq and pcmp_lt should be defined for it to be true. + HasCmp = 0, + + HasDiv = 0, + HasReciprocal = 0, + HasSqrt = 0, + HasRsqrt = 0, + HasCbrt = 0, + HasExp = 0, + HasExpm1 = 0, + HasLog = 0, + HasLog1p = 0, + HasLog10 = 0, + HasPow = 0, + HasSin = 0, + HasCos = 0, + HasTan = 0, + HasASin = 0, + HasACos = 0, + HasATan = 0, + HasATanh = 0, + HasSinh = 0, + HasCosh = 0, + HasTanh = 0, + HasLGamma = 0, + HasDiGamma = 0, + HasZeta = 0, + HasPolygamma = 0, + HasErf = 0, + HasErfc = 0, + HasNdtri = 0, + HasBessel = 0, + HasIGamma = 0, + HasIGammaDerA = 0, + HasGammaSampleDerAlpha = 0, + HasIGammac = 0, + HasBetaInc = 0 + }; +}; + +template +struct packet_traits : default_packet_traits { + typedef T type; + typedef T half; + enum { + Vectorizable = 0, + size = 1, + AlignedOnScalar = 0, + }; + enum { + HasAdd = 0, + HasSub = 0, + HasMul = 0, + HasNegate = 0, + HasAbs = 0, + HasAbs2 = 0, + HasMin = 0, + HasMax = 0, + HasConj = 0, + HasSetLinear = 0 + }; +}; + +template +struct packet_traits : packet_traits {}; + +template +struct unpacket_traits { + typedef T type; + typedef T half; + typedef typename numext::get_integer_by_size::signed_type integer_packet; + enum { + size = 1, + alignment = alignof(T), + vectorizable = false, + masked_load_available = false, + masked_store_available = false + }; +}; + +template +struct unpacket_traits : unpacket_traits {}; + +/** \internal A convenience utility for determining if the type is a scalar. + * This is used to enable some generic packet implementations. + */ +template +struct is_scalar { + using Scalar = typename unpacket_traits::type; + enum { value = internal::is_same::value }; +}; + +// automatically and succinctly define combinations of pcast when +// 1) the packets are the same type, or +// 2) the packets differ only in sign. +// In both of these cases, preinterpret (bit_cast) is equivalent to pcast (static_cast) +template ::value && is_scalar::value> +struct is_degenerate_helper : is_same {}; +template <> +struct is_degenerate_helper : std::true_type {}; +template <> +struct is_degenerate_helper : std::true_type {}; +template <> +struct is_degenerate_helper : std::true_type {}; +template <> +struct is_degenerate_helper : std::true_type {}; + +template +struct is_degenerate_helper { + using SrcScalar = typename unpacket_traits::type; + static constexpr int SrcSize = unpacket_traits::size; + using TgtScalar = typename unpacket_traits::type; + static constexpr int TgtSize = unpacket_traits::size; + static constexpr bool value = is_degenerate_helper::value && (SrcSize == TgtSize); +}; + +// is_degenerate::value == is_degenerate::value +template +struct is_degenerate { + static constexpr bool value = + is_degenerate_helper::value || is_degenerate_helper::value; +}; + +template +struct is_half { + using Scalar = typename unpacket_traits::type; + static constexpr int Size = unpacket_traits::size; + using DefaultPacket = typename packet_traits::type; + static constexpr int DefaultSize = unpacket_traits::size; + static constexpr bool value = Size != 1 && Size < DefaultSize; +}; + +template +struct type_casting_traits { + enum { + VectorizedCast = + is_degenerate::value && packet_traits::Vectorizable && packet_traits::Vectorizable, + SrcCoeffRatio = 1, + TgtCoeffRatio = 1 + }; +}; + +// provides a succinct template to define vectorized casting traits with respect to the largest accessible packet types +template +struct vectorized_type_casting_traits { + enum : int { + DefaultSrcPacketSize = packet_traits::size, + DefaultTgtPacketSize = packet_traits::size, + VectorizedCast = 1, + SrcCoeffRatio = plain_enum_max(DefaultTgtPacketSize / DefaultSrcPacketSize, 1), + TgtCoeffRatio = plain_enum_max(DefaultSrcPacketSize / DefaultTgtPacketSize, 1) + }; +}; + +/** \internal Wrapper to ensure that multiple packet types can map to the same + same underlying vector type. */ +template +struct eigen_packet_wrapper { + EIGEN_ALWAYS_INLINE operator T&() { return m_val; } + EIGEN_ALWAYS_INLINE operator const T&() const { return m_val; } + EIGEN_ALWAYS_INLINE eigen_packet_wrapper() = default; + EIGEN_ALWAYS_INLINE eigen_packet_wrapper(const T& v) : m_val(v) {} + EIGEN_ALWAYS_INLINE eigen_packet_wrapper& operator=(const T& v) { + m_val = v; + return *this; + } + + T m_val; +}; + +template ::value> +struct preinterpret_generic; + +template +struct preinterpret_generic { + // the packets are not the same, attempt scalar bit_cast + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Target run(const Packet& a) { + return numext::bit_cast(a); + } +}; + +template +struct preinterpret_generic { + // the packets are the same type: do nothing + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet run(const Packet& a) { return a; } +}; + +template +struct preinterpret_generic::as_real, ComplexPacket, false> { + using RealPacket = typename unpacket_traits::as_real; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE RealPacket run(const ComplexPacket& a) { return a.v; } +}; + +/** \internal \returns reinterpret_cast(a) */ +template +EIGEN_DEVICE_FUNC inline Target preinterpret(const Packet& a) { + return preinterpret_generic::run(a); +} + +template ::value, + bool TgtIsHalf = is_half::value> +struct pcast_generic; + +template +struct pcast_generic { + // the packets are not degenerate: attempt scalar static_cast + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TgtPacket run(const SrcPacket& a) { + return cast_impl::run(a); + } +}; + +template +struct pcast_generic { + // the packets are the same: do nothing + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet run(const Packet& a) { return a; } +}; + +template +struct pcast_generic { + // the packets are degenerate: preinterpret is equivalent to pcast + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TgtPacket run(const SrcPacket& a) { return preinterpret(a); } +}; + +/** \internal \returns static_cast(a) (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline TgtPacket pcast(const SrcPacket& a) { + return pcast_generic::run(a); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket pcast(const SrcPacket& a, const SrcPacket& b) { + return pcast_generic::run(a, b); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket pcast(const SrcPacket& a, const SrcPacket& b, const SrcPacket& c, + const SrcPacket& d) { + return pcast_generic::run(a, b, c, d); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket pcast(const SrcPacket& a, const SrcPacket& b, const SrcPacket& c, const SrcPacket& d, + const SrcPacket& e, const SrcPacket& f, const SrcPacket& g, + const SrcPacket& h) { + return pcast_generic::run(a, b, c, d, e, f, g, h); +} + +template +struct pcast_generic { + // TgtPacket is a half packet of some other type + // perform cast and truncate result + using DefaultTgtPacket = typename is_half::DefaultPacket; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TgtPacket run(const SrcPacket& a) { + return preinterpret(pcast(a)); + } +}; + +/** \internal \returns a + b (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet padd(const Packet& a, const Packet& b) { + return a + b; +} +// Avoid compiler warning for boolean algebra. +template <> +EIGEN_DEVICE_FUNC inline bool padd(const bool& a, const bool& b) { + return a || b; +} + +/** \internal \returns a packet version of \a *from, (un-aligned masked add) + * There is no generic implementation. We only have implementations for specialized + * cases. Generic case should not be called. + */ +template +EIGEN_DEVICE_FUNC inline std::enable_if_t::masked_fpops_available, Packet> padd( + const Packet& a, const Packet& b, typename unpacket_traits::mask_t umask); + +/** \internal \returns a - b (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet psub(const Packet& a, const Packet& b) { + return a - b; +} + +/** \internal \returns -a (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pnegate(const Packet& a) { + EIGEN_STATIC_ASSERT((!is_same::type, bool>::value), + NEGATE IS NOT DEFINED FOR BOOLEAN TYPES) + return numext::negate(a); +} + +/** \internal \returns conj(a) (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pconj(const Packet& a) { + return numext::conj(a); +} + +/** \internal \returns a * b (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pmul(const Packet& a, const Packet& b) { + return a * b; +} +// Avoid compiler warning for boolean algebra. +template <> +EIGEN_DEVICE_FUNC inline bool pmul(const bool& a, const bool& b) { + return a && b; +} + +/** \internal \returns a / b (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pdiv(const Packet& a, const Packet& b) { + return a / b; +} +// Avoid compiler warning for boolean algebra. +template <> +EIGEN_DEVICE_FUNC inline bool pdiv(const bool& a, const bool& b) { + return a && b; +} + +// In the generic packet case, memset to all one bits. +template +struct ptrue_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& /*a*/) { + Packet b; + memset(static_cast(&b), 0xff, sizeof(Packet)); + return b; + } +}; + +// Use a value of one for scalars. +template +struct ptrue_impl::value>> { + static EIGEN_DEVICE_FUNC inline Scalar run(const Scalar&) { return Scalar(1); } +}; + +// For booleans, we can only directly set a valid `bool` value to avoid UB. +template <> +struct ptrue_impl { + static EIGEN_DEVICE_FUNC inline bool run(const bool&) { return true; } +}; + +/** \internal \returns one bits. */ +template +EIGEN_DEVICE_FUNC inline Packet ptrue(const Packet& a) { + return ptrue_impl::run(a); +} + +// In the general packet case, memset to zero. +template +struct pzero_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& /*a*/) { + Packet b; + memset(static_cast(&b), 0x00, sizeof(Packet)); + return b; + } +}; + +// For scalars, explicitly set to Scalar(0), since the underlying representation +// for zero may not consist of all-zero bits. +template +struct pzero_impl::value>> { + static EIGEN_DEVICE_FUNC inline T run(const T& /*a*/) { return T(0); } +}; + +/** \internal \returns packet of zeros */ +template +EIGEN_DEVICE_FUNC inline Packet pzero(const Packet& a) { + return pzero_impl::run(a); +} + +template +struct bit_and { + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { return a & b; } +}; + +template +struct bit_or { + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { return a | b; } +}; + +template +struct bit_xor { + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { return a ^ b; } +}; + +template +struct bit_not { + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE T operator()(const T& a) const { return ~a; } +}; + +template <> +struct bit_and { + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE bool operator()(const bool& a, const bool& b) const { return a && b; } +}; + +template <> +struct bit_or { + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE bool operator()(const bool& a, const bool& b) const { return a || b; } +}; + +template <> +struct bit_xor { + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE bool operator()(const bool& a, const bool& b) const { return a != b; } +}; + +template <> +struct bit_not { + EIGEN_DEVICE_FUNC constexpr EIGEN_ALWAYS_INLINE bool operator()(const bool& a) const { return !a; } +}; + +// Use operators &, |, ^, ~. +template +struct operator_bitwise_helper { + EIGEN_DEVICE_FUNC static inline T bitwise_and(const T& a, const T& b) { return bit_and()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_or(const T& a, const T& b) { return bit_or()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_xor(const T& a, const T& b) { return bit_xor()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_not(const T& a) { return bit_not()(a); } +}; + +// Apply binary operations byte-by-byte +template +struct bytewise_bitwise_helper { + EIGEN_DEVICE_FUNC static inline T bitwise_and(const T& a, const T& b) { + return binary(a, b, bit_and()); + } + EIGEN_DEVICE_FUNC static inline T bitwise_or(const T& a, const T& b) { return binary(a, b, bit_or()); } + EIGEN_DEVICE_FUNC static inline T bitwise_xor(const T& a, const T& b) { + return binary(a, b, bit_xor()); + } + EIGEN_DEVICE_FUNC static inline T bitwise_not(const T& a) { return unary(a, bit_not()); } + + private: + template + EIGEN_DEVICE_FUNC static inline T unary(const T& a, Op op) { + const unsigned char* a_ptr = reinterpret_cast(&a); + T c; + unsigned char* c_ptr = reinterpret_cast(&c); + for (size_t i = 0; i < sizeof(T); ++i) { + *c_ptr++ = op(*a_ptr++); + } + return c; + } + + template + EIGEN_DEVICE_FUNC static inline T binary(const T& a, const T& b, Op op) { + const unsigned char* a_ptr = reinterpret_cast(&a); + const unsigned char* b_ptr = reinterpret_cast(&b); + T c; + unsigned char* c_ptr = reinterpret_cast(&c); + for (size_t i = 0; i < sizeof(T); ++i) { + *c_ptr++ = op(*a_ptr++, *b_ptr++); + } + return c; + } +}; + +// In the general case, use byte-by-byte manipulation. +template +struct bitwise_helper : public bytewise_bitwise_helper {}; + +// For integers or non-trivial scalars, use binary operators. +template +struct bitwise_helper::value && + (NumTraits::IsInteger || NumTraits::RequireInitialization)>> + : public operator_bitwise_helper {}; + +/** \internal \returns the bitwise and of \a a and \a b */ +template +EIGEN_DEVICE_FUNC inline Packet pand(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_and(a, b); +} + +/** \internal \returns the bitwise or of \a a and \a b */ +template +EIGEN_DEVICE_FUNC inline Packet por(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_or(a, b); +} + +/** \internal \returns the bitwise xor of \a a and \a b */ +template +EIGEN_DEVICE_FUNC inline Packet pxor(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_xor(a, b); +} + +/** \internal \returns the bitwise not of \a a */ +template +EIGEN_DEVICE_FUNC inline Packet pnot(const Packet& a) { + return bitwise_helper::bitwise_not(a); +} + +/** \internal \returns the bitwise and of \a a and not \a b */ +template +EIGEN_DEVICE_FUNC inline Packet pandnot(const Packet& a, const Packet& b) { + return pand(a, pnot(b)); +} + +/** \internal \returns a < b as a bit mask */ +template +EIGEN_DEVICE_FUNC inline Packet pcmp_lt(const Packet& a, const Packet& b) { + return a < b ? ptrue(a) : pzero(a); +} + +/** \internal \returns a == b as a bit mask */ +template +EIGEN_DEVICE_FUNC inline Packet pcmp_eq(const Packet& a, const Packet& b) { + return a == b ? ptrue(a) : pzero(a); +} + +/** \internal \returns a <= b as a bit mask */ +template +EIGEN_DEVICE_FUNC inline Packet pcmp_le(const Packet& a, const Packet& b) { + return por(pcmp_eq(a, b), pcmp_lt(a, b)); +} + +/** \internal \returns a < b or a==NaN or b==NaN as a bit mask */ +template +EIGEN_DEVICE_FUNC inline Packet pcmp_lt_or_nan(const Packet& a, const Packet& b) { + return a >= b ? pzero(a) : ptrue(a); +} + +// In the general case, use bitwise select. +template ::value> +struct pselect_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& mask, const Packet& a, const Packet& b) { + return por(pand(a, mask), pandnot(b, mask)); + } +}; + +// For scalars, use ternary select. +template +struct pselect_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& mask, const Packet& a, const Packet& b) { + return numext::select(mask, a, b); + } +}; + +/** \internal \returns \a or \b for each field in packet according to \mask */ +template +EIGEN_DEVICE_FUNC inline Packet pselect(const Packet& mask, const Packet& a, const Packet& b) { + return pselect_impl::run(mask, a, b); +} + +template <> +EIGEN_DEVICE_FUNC inline bool pselect(const bool& cond, const bool& a, const bool& b) { + return cond ? a : b; +} + +/** \internal \returns the min or of \a a and \a b (coeff-wise) + If either \a a or \a b are NaN, the result is implementation defined. */ +template +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + return op(a, b); + } +}; + +/** \internal \returns the min or max of \a a and \a b (coeff-wise) + If either \a a or \a b are NaN, NaN is returned. */ +template <> +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + Packet not_nan_mask_a = pcmp_eq(a, a); + Packet not_nan_mask_b = pcmp_eq(b, b); + return pselect(not_nan_mask_a, pselect(not_nan_mask_b, op(a, b), b), a); + } +}; + +/** \internal \returns the min or max of \a a and \a b (coeff-wise) + If both \a a and \a b are NaN, NaN is returned. + Equivalent to std::fmin(a, b). */ +template <> +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + Packet not_nan_mask_a = pcmp_eq(a, a); + Packet not_nan_mask_b = pcmp_eq(b, b); + return pselect(not_nan_mask_a, pselect(not_nan_mask_b, op(a, b), a), b); + } +}; + +#define EIGEN_BINARY_OP_NAN_PROPAGATION(Type, Func) [](const Type& aa, const Type& bb) { return Func(aa, bb); } + +/** \internal \returns the min of \a a and \a b (coeff-wise). + If \a a or \b b is NaN, the return value is implementation defined. */ +template +EIGEN_DEVICE_FUNC inline Packet pmin(const Packet& a, const Packet& b) { + return numext::mini(a, b); +} + +/** \internal \returns the min of \a a and \a b (coeff-wise). + NaNPropagation determines the NaN propagation semantics. */ +template +EIGEN_DEVICE_FUNC inline Packet pmin(const Packet& a, const Packet& b) { + constexpr bool IsInteger = NumTraits::type>::IsInteger; + return pminmax_impl::run(a, b, EIGEN_BINARY_OP_NAN_PROPAGATION(Packet, (pmin))); +} + +/** \internal \returns the max of \a a and \a b (coeff-wise) + If \a a or \b b is NaN, the return value is implementation defined. */ +template +EIGEN_DEVICE_FUNC inline Packet pmax(const Packet& a, const Packet& b) { + return numext::maxi(a, b); +} + +/** \internal \returns the max of \a a and \a b (coeff-wise). + NaNPropagation determines the NaN propagation semantics. */ +template +EIGEN_DEVICE_FUNC inline Packet pmax(const Packet& a, const Packet& b) { + constexpr bool IsInteger = NumTraits::type>::IsInteger; + return pminmax_impl::run(a, b, EIGEN_BINARY_OP_NAN_PROPAGATION(Packet, (pmax))); +} + +/** \internal \returns the absolute value of \a a */ +template +EIGEN_DEVICE_FUNC inline Packet pabs(const Packet& a) { + return numext::abs(a); +} +template <> +EIGEN_DEVICE_FUNC inline unsigned int pabs(const unsigned int& a) { + return a; +} +template <> +EIGEN_DEVICE_FUNC inline unsigned long pabs(const unsigned long& a) { + return a; +} +template <> +EIGEN_DEVICE_FUNC inline unsigned long long pabs(const unsigned long long& a) { + return a; +} + +/** \internal \returns the addsub value of \a a,b */ +template +EIGEN_DEVICE_FUNC inline Packet paddsub(const Packet& a, const Packet& b) { + return pselect(peven_mask(a), padd(a, b), psub(a, b)); +} + +/** \internal \returns the phase angle of \a a */ +template +EIGEN_DEVICE_FUNC inline Packet parg(const Packet& a) { + using numext::arg; + return arg(a); +} + +/** \internal \returns \a a arithmetically shifted by N bits to the right */ +template +EIGEN_DEVICE_FUNC inline T parithmetic_shift_right(const T& a) { + return numext::arithmetic_shift_right(a, N); +} + +/** \internal \returns \a a logically shifted by N bits to the right */ +template +EIGEN_DEVICE_FUNC inline T plogical_shift_right(const T& a) { + return numext::logical_shift_right(a, N); +} + +/** \internal \returns \a a shifted by N bits to the left */ +template +EIGEN_DEVICE_FUNC inline T plogical_shift_left(const T& a) { + return numext::logical_shift_left(a, N); +} + +/** \internal \returns the significant and exponent of the underlying floating point numbers + * See https://en.cppreference.com/w/cpp/numeric/math/frexp + */ +template +EIGEN_DEVICE_FUNC inline Packet pfrexp(const Packet& a, Packet& exponent) { + int exp; + EIGEN_USING_STD(frexp); + Packet result = static_cast(frexp(a, &exp)); + exponent = static_cast(exp); + return result; +} + +/** \internal \returns a * 2^((int)exponent) + * See https://en.cppreference.com/w/cpp/numeric/math/ldexp + */ +template +EIGEN_DEVICE_FUNC inline Packet pldexp(const Packet& a, const Packet& exponent) { + EIGEN_USING_STD(ldexp) + return static_cast(ldexp(a, static_cast(exponent))); +} + +/** \internal \returns the min of \a a and \a b (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pabsdiff(const Packet& a, const Packet& b) { + return pselect(pcmp_lt(a, b), psub(b, a), psub(a, b)); +} + +/** \internal \returns a packet version of \a *from, from must be properly aligned */ +template +EIGEN_DEVICE_FUNC inline Packet pload(const typename unpacket_traits::type* from) { + return *from; +} + +/** \internal \returns n elements of a packet version of \a *from, from must be properly aligned + * offset indicates the starting element in which to load and + * offset + n <= unpacket_traits::size + * All elements before offset and after the last element loaded will initialized with zero */ +template +EIGEN_DEVICE_FUNC inline Packet pload_partial(const typename unpacket_traits::type* from, const Index n, + const Index offset = 0) { + const Index packet_size = unpacket_traits::size; + eigen_assert(n + offset <= packet_size && "number of elements plus offset will read past end of packet"); + typedef typename unpacket_traits::type Scalar; + EIGEN_ALIGN_MAX Scalar elements[packet_size] = {Scalar(0)}; + for (Index i = offset; i < numext::mini(n + offset, packet_size); i++) { + elements[i] = from[i - offset]; + } + return pload(elements); +} + +/** \internal \returns a packet version of \a *from, (un-aligned load) */ +template +EIGEN_DEVICE_FUNC inline Packet ploadu(const typename unpacket_traits::type* from) { + return *from; +} + +/** \internal \returns n elements of a packet version of \a *from, (un-aligned load) + * All elements after the last element loaded will initialized with zero */ +template +EIGEN_DEVICE_FUNC inline Packet ploadu_partial(const typename unpacket_traits::type* from, const Index n, + const Index offset = 0) { + const Index packet_size = unpacket_traits::size; + eigen_assert(n + offset <= packet_size && "number of elements plus offset will read past end of packet"); + typedef typename unpacket_traits::type Scalar; + EIGEN_ALIGN_MAX Scalar elements[packet_size] = {Scalar(0)}; + for (Index i = offset; i < numext::mini(n + offset, packet_size); i++) { + elements[i] = from[i - offset]; + } + return pload(elements); +} + +/** \internal \returns a packet version of \a *from, (un-aligned masked load) + * There is no generic implementation. We only have implementations for specialized + * cases. Generic case should not be called. + */ +template +EIGEN_DEVICE_FUNC inline std::enable_if_t::masked_load_available, Packet> ploadu( + const typename unpacket_traits::type* from, typename unpacket_traits::mask_t umask); + +/** \internal \returns a packet with constant coefficients \a a, e.g.: (a,a,a,a) */ +template +EIGEN_DEVICE_FUNC inline Packet pset1(const typename unpacket_traits::type& a) { + return a; +} + +/** \internal \returns a packet with constant coefficients set from bits */ +template +EIGEN_DEVICE_FUNC inline Packet pset1frombits(BitsType a); + +/** \internal \returns a packet with constant coefficients \a a[0], e.g.: (a[0],a[0],a[0],a[0]) */ +template +EIGEN_DEVICE_FUNC inline Packet pload1(const typename unpacket_traits::type* a) { + return pset1(*a); +} + +/** \internal \returns a packet with elements of \a *from duplicated. + * For instance, for a packet of 8 elements, 4 scalars will be read from \a *from and + * duplicated to form: {from[0],from[0],from[1],from[1],from[2],from[2],from[3],from[3]} + * Currently, this function is only used for scalar * complex products. + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet ploaddup(const typename unpacket_traits::type* from) { + return *from; +} + +/** \internal \returns a packet with elements of \a *from quadrupled. + * For instance, for a packet of 8 elements, 2 scalars will be read from \a *from and + * replicated to form: {from[0],from[0],from[0],from[0],from[1],from[1],from[1],from[1]} + * Currently, this function is only used in matrix products. + * For packet-size smaller or equal to 4, this function is equivalent to pload1 + */ +template +EIGEN_DEVICE_FUNC inline Packet ploadquad(const typename unpacket_traits::type* from) { + return pload1(from); +} + +/** \internal equivalent to + * \code + * a0 = pload1(a+0); + * a1 = pload1(a+1); + * a2 = pload1(a+2); + * a3 = pload1(a+3); + * \endcode + * \sa pset1, pload1, ploaddup, pbroadcast2 + */ +template +EIGEN_DEVICE_FUNC inline void pbroadcast4(const typename unpacket_traits::type* a, Packet& a0, Packet& a1, + Packet& a2, Packet& a3) { + a0 = pload1(a + 0); + a1 = pload1(a + 1); + a2 = pload1(a + 2); + a3 = pload1(a + 3); +} + +/** \internal equivalent to + * \code + * a0 = pload1(a+0); + * a1 = pload1(a+1); + * \endcode + * \sa pset1, pload1, ploaddup, pbroadcast4 + */ +template +EIGEN_DEVICE_FUNC inline void pbroadcast2(const typename unpacket_traits::type* a, Packet& a0, Packet& a1) { + a0 = pload1(a + 0); + a1 = pload1(a + 1); +} + +/** \internal \brief Returns a packet with coefficients (a,a+1,...,a+packet_size-1). */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet plset(const typename unpacket_traits::type& a) { + return a; +} + +template +struct peven_mask_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet run(const Packet&) { + typedef typename unpacket_traits::type Scalar; + const size_t n = unpacket_traits::size; + EIGEN_ALIGN_TO_BOUNDARY(sizeof(Packet)) Scalar elements[n]; + for (size_t i = 0; i < n; ++i) { + memset(elements + i, ((i & 1) == 0 ? 0xff : 0), sizeof(Scalar)); + } + return ploadu(elements); + } +}; + +template +struct peven_mask_impl::value>> { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run(const Scalar&) { return Scalar(1); } +}; + +/** \internal \returns a packet with constant coefficients \a a, e.g.: (x, 0, x, 0), + where x is the value of all 1-bits. */ +template +EIGEN_DEVICE_FUNC inline Packet peven_mask(const Packet& a) { + return peven_mask_impl::run(a); +} + +/** \internal copy the packet \a from to \a *to, \a to must be properly aligned */ +template +EIGEN_DEVICE_FUNC inline void pstore(Scalar* to, const Packet& from) { + (*to) = from; +} + +/** \internal copy n elements of the packet \a from to \a *to, \a to must be properly aligned + * offset indicates the starting element in which to store and + * offset + n <= unpacket_traits::size */ +template +EIGEN_DEVICE_FUNC inline void pstore_partial(Scalar* to, const Packet& from, const Index n, const Index offset = 0) { + const Index packet_size = unpacket_traits::size; + eigen_assert(n + offset <= packet_size && "number of elements plus offset will write past end of packet"); + EIGEN_ALIGN_MAX Scalar elements[packet_size]; + pstore(elements, from); + for (Index i = 0; i < numext::mini(n, packet_size - offset); i++) { + to[i] = elements[i + offset]; + } +} + +/** \internal copy the packet \a from to \a *to, (un-aligned store) */ +template +EIGEN_DEVICE_FUNC inline void pstoreu(Scalar* to, const Packet& from) { + (*to) = from; +} + +/** \internal copy n elements of the packet \a from to \a *to, (un-aligned store) */ +template +EIGEN_DEVICE_FUNC inline void pstoreu_partial(Scalar* to, const Packet& from, const Index n, const Index offset = 0) { + const Index packet_size = unpacket_traits::size; + eigen_assert(n + offset <= packet_size && "number of elements plus offset will write past end of packet"); + EIGEN_ALIGN_MAX Scalar elements[packet_size]; + pstore(elements, from); + for (Index i = 0; i < numext::mini(n, packet_size - offset); i++) { + to[i] = elements[i + offset]; + } +} + +/** \internal copy the packet \a from to \a *to, (un-aligned store with a mask) + * There is no generic implementation. We only have implementations for specialized + * cases. Generic case should not be called. + */ +template +EIGEN_DEVICE_FUNC inline std::enable_if_t::masked_store_available, void> pstoreu( + Scalar* to, const Packet& from, typename unpacket_traits::mask_t umask); + +template +EIGEN_DEVICE_FUNC inline Packet pgather(const Scalar* from, Index /*stride*/) { + return ploadu(from); +} + +template +EIGEN_DEVICE_FUNC inline Packet pgather_partial(const Scalar* from, Index stride, const Index n) { + const Index packet_size = unpacket_traits::size; + EIGEN_ALIGN_MAX Scalar elements[packet_size] = {Scalar(0)}; + for (Index i = 0; i < numext::mini(n, packet_size); i++) { + elements[i] = from[i * stride]; + } + return pload(elements); +} + +template +EIGEN_DEVICE_FUNC inline void pscatter(Scalar* to, const Packet& from, Index /*stride*/) { + pstore(to, from); +} + +template +EIGEN_DEVICE_FUNC inline void pscatter_partial(Scalar* to, const Packet& from, Index stride, const Index n) { + const Index packet_size = unpacket_traits::size; + EIGEN_ALIGN_MAX Scalar elements[packet_size]; + pstore(elements, from); + for (Index i = 0; i < numext::mini(n, packet_size); i++) { + to[i * stride] = elements[i]; + } +} + +/** \internal tries to do cache prefetching of \a addr */ +template +EIGEN_DEVICE_FUNC inline void prefetch(const Scalar* addr) { +#if defined(EIGEN_HIP_DEVICE_COMPILE) + // do nothing +#elif defined(EIGEN_CUDA_ARCH) +#if defined(__LP64__) || EIGEN_OS_WIN64 + // 64-bit pointer operand constraint for inlined asm + asm(" prefetch.L1 [ %1 ];" : "=l"(addr) : "l"(addr)); +#else + // 32-bit pointer operand constraint for inlined asm + asm(" prefetch.L1 [ %1 ];" : "=r"(addr) : "r"(addr)); +#endif +#elif (!EIGEN_COMP_MSVC) && (EIGEN_COMP_GNUC || EIGEN_COMP_CLANG || EIGEN_COMP_ICC) + __builtin_prefetch(addr); +#endif +} + +/** \internal \returns the reversed elements of \a a*/ +template +EIGEN_DEVICE_FUNC inline Packet preverse(const Packet& a) { + return a; +} + +/** \internal \returns \a a with real and imaginary part flipped (for complex type only) */ +template +EIGEN_DEVICE_FUNC inline Packet pcplxflip(const Packet& a) { + return Packet(numext::imag(a), numext::real(a)); +} + +/************************** + * Special math functions + ***************************/ + +/** \internal \returns isnan(a) */ +template +EIGEN_DEVICE_FUNC inline Packet pisnan(const Packet& a) { + return pandnot(ptrue(a), pcmp_eq(a, a)); +} + +/** \internal \returns isinf(a) */ +template +EIGEN_DEVICE_FUNC inline Packet pisinf(const Packet& a) { + using Scalar = typename unpacket_traits::type; + constexpr Scalar inf = NumTraits::infinity(); + return pcmp_eq(pabs(a), pset1(inf)); +} + +/** \internal \returns the sine of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet psin(const Packet& a) { + EIGEN_USING_STD(sin); + return sin(a); +} + +/** \internal \returns the cosine of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet pcos(const Packet& a) { + EIGEN_USING_STD(cos); + return cos(a); +} + +/** \internal \returns the tan of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet ptan(const Packet& a) { + EIGEN_USING_STD(tan); + return tan(a); +} + +/** \internal \returns the arc sine of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet pasin(const Packet& a) { + EIGEN_USING_STD(asin); + return asin(a); +} + +/** \internal \returns the arc cosine of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet pacos(const Packet& a) { + EIGEN_USING_STD(acos); + return acos(a); +} + +/** \internal \returns the hyperbolic sine of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet psinh(const Packet& a) { + EIGEN_USING_STD(sinh); + return sinh(a); +} + +/** \internal \returns the hyperbolic cosine of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet pcosh(const Packet& a) { + EIGEN_USING_STD(cosh); + return cosh(a); +} + +/** \internal \returns the arc tangent of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet patan(const Packet& a) { + EIGEN_USING_STD(atan); + return atan(a); +} + +/** \internal \returns the hyperbolic tan of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet ptanh(const Packet& a) { + EIGEN_USING_STD(tanh); + return tanh(a); +} + +/** \internal \returns the arc tangent of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet patanh(const Packet& a) { + EIGEN_USING_STD(atanh); + return atanh(a); +} + +/** \internal \returns the exp of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet pexp(const Packet& a) { + return numext::exp(a); +} + +/** \internal \returns the exp2 of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet pexp2(const Packet& a) { + return numext::exp2(a); +} + +/** \internal \returns the expm1 of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet pexpm1(const Packet& a) { + return numext::expm1(a); +} + +/** \internal \returns the log of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet plog(const Packet& a) { + EIGEN_USING_STD(log); + return log(a); +} + +/** \internal \returns the log1p of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet plog1p(const Packet& a) { + return numext::log1p(a); +} + +/** \internal \returns the log10 of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet plog10(const Packet& a) { + EIGEN_USING_STD(log10); + return log10(a); +} + +/** \internal \returns the log2 of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet plog2(const Packet& a) { + using Scalar = typename internal::unpacket_traits::type; + using RealScalar = typename NumTraits::Real; + return pmul(pset1(Scalar(RealScalar(EIGEN_LOG2E))), plog(a)); +} + +/** \internal \returns the square-root of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet psqrt(const Packet& a) { + return numext::sqrt(a); +} + +/** \internal \returns the cube-root of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet pcbrt(const Packet& a) { + return numext::cbrt(a); +} + +template ::value, + bool IsInteger = NumTraits::type>::IsInteger> +struct nearest_integer_packetop_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet run_floor(const Packet& x) { return numext::floor(x); } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet run_ceil(const Packet& x) { return numext::ceil(x); } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet run_rint(const Packet& x) { return numext::rint(x); } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet run_round(const Packet& x) { return numext::round(x); } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet run_trunc(const Packet& x) { return numext::trunc(x); } +}; + +/** \internal \returns the rounded value of \a a (coeff-wise) */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet pround(const Packet& a) { + return nearest_integer_packetop_impl::run_round(a); +} + +/** \internal \returns the floor of \a a (coeff-wise) */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet pfloor(const Packet& a) { + return nearest_integer_packetop_impl::run_floor(a); +} + +/** \internal \returns the rounded value of \a a (coeff-wise) with current + * rounding mode */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet print(const Packet& a) { + return nearest_integer_packetop_impl::run_rint(a); +} + +/** \internal \returns the ceil of \a a (coeff-wise) */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet pceil(const Packet& a) { + return nearest_integer_packetop_impl::run_ceil(a); +} + +/** \internal \returns the truncation of \a a (coeff-wise) */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet ptrunc(const Packet& a) { + return nearest_integer_packetop_impl::run_trunc(a); +} + +template +struct psign_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a) { return numext::sign(a); } +}; + +/** \internal \returns the sign of \a a (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet psign(const Packet& a) { + return psign_impl::run(a); +} + +template <> +EIGEN_DEVICE_FUNC inline bool psign(const bool& a) { + return a; +} + +/** \internal \returns the first element of a packet */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type pfirst(const Packet& a) { + return a; +} + +/** \internal \returns the sum of the elements of upper and lower half of \a a if \a a is larger than 4. + * For a packet {a0, a1, a2, a3, a4, a5, a6, a7}, it returns a half packet {a0+a4, a1+a5, a2+a6, a3+a7} + * For packet-size smaller or equal to 4, this boils down to a noop. + */ +template +EIGEN_DEVICE_FUNC inline std::conditional_t<(unpacket_traits::size % 8) == 0, + typename unpacket_traits::half, Packet> +predux_half_dowto4(const Packet& a) { + return a; +} + +// Slow generic implementation of Packet reduction. +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_helper(const Packet& a, Op op) { + typedef typename unpacket_traits::type Scalar; + const size_t n = unpacket_traits::size; + EIGEN_ALIGN_TO_BOUNDARY(sizeof(Packet)) Scalar elements[n]; + pstoreu(elements, a); + for (size_t k = n / 2; k > 0; k /= 2) { + for (size_t i = 0; i < k; ++i) { + elements[i] = op(elements[i], elements[i + k]); + } + } + return elements[0]; +} + +/** \internal \returns the sum of the elements of \a a*/ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux(const Packet& a) { + return a; +} + +/** \internal \returns the product of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_mul(const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmul))); +} + +/** \internal \returns the min of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_min(const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmin))); +} + +/** \internal \returns the max of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_max(const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmax))); +} + +template +struct predux_min_max_helper_impl { + using Scalar = typename unpacket_traits::type; + static constexpr bool UsePredux_ = NaNPropagation == PropagateFast || NumTraits::IsInteger; + template = true> + static EIGEN_DEVICE_FUNC inline Scalar run_min(const Packet& a) { + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmin))); + } + template = true> + static EIGEN_DEVICE_FUNC inline Scalar run_max(const Packet& a) { + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmax))); + } + template = true> + static EIGEN_DEVICE_FUNC inline Scalar run_min(const Packet& a) { + return predux_min(a); + } + template = true> + static EIGEN_DEVICE_FUNC inline Scalar run_max(const Packet& a) { + return predux_max(a); + } +}; + +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_min(const Packet& a) { + return predux_min_max_helper_impl::run_min(a); +} + +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_max(const Packet& a) { + return predux_min_max_helper_impl::run_max(a); +} + +#undef EIGEN_BINARY_OP_NAN_PROPAGATION + +/** \internal \returns true if all coeffs of \a a means "true" + * It is supposed to be called on values returned by pcmp_*. + */ +// not needed yet +// template EIGEN_DEVICE_FUNC inline bool predux_all(const Packet& a) +// { return bool(a); } + +/** \internal \returns true if any coeffs of \a a means "true" + * It is supposed to be called on values returned by pcmp_*. + */ +template +EIGEN_DEVICE_FUNC inline bool predux_any(const Packet& a) { + // Dirty but generic implementation where "true" is assumed to be non 0 and all the sames. + // It is expected that "true" is either: + // - Scalar(1) + // - bits full of ones (NaN for floats), + // - or first bit equals to 1 (1 for ints, smallest denormal for floats). + // For all these cases, taking the sum is just fine, and this boils down to a no-op for scalars. + typedef typename unpacket_traits::type Scalar; + return numext::not_equal_strict(predux(a), Scalar(0)); +} + +/*************************************************************************** + * The following functions might not have to be overwritten for vectorized types + ***************************************************************************/ + +template +struct pmadd_impl { + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet pmadd(const Packet& a, const Packet& b, const Packet& c) { + return padd(pmul(a, b), c); + } + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet pmsub(const Packet& a, const Packet& b, const Packet& c) { + return psub(pmul(a, b), c); + } + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet pnmadd(const Packet& a, const Packet& b, const Packet& c) { + return psub(c, pmul(a, b)); + } + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet pnmsub(const Packet& a, const Packet& b, const Packet& c) { + return pnegate(pmadd(a, b, c)); + } +}; + +template +struct pmadd_impl::value && NumTraits::IsSigned>> { + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Scalar pmadd(const Scalar& a, const Scalar& b, const Scalar& c) { + return numext::madd(a, b, c); + } + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Scalar pmsub(const Scalar& a, const Scalar& b, const Scalar& c) { + return numext::madd(a, b, Scalar(-c)); + } + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Scalar pnmadd(const Scalar& a, const Scalar& b, const Scalar& c) { + return numext::madd(Scalar(-a), b, c); + } + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Scalar pnmsub(const Scalar& a, const Scalar& b, const Scalar& c) { + return -Scalar(numext::madd(a, b, c)); + } +}; + +// Multiply-add instructions. +/** \internal \returns a * b + c (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pmadd(const Packet& a, const Packet& b, const Packet& c) { + return pmadd_impl::pmadd(a, b, c); +} + +/** \internal \returns a * b - c (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pmsub(const Packet& a, const Packet& b, const Packet& c) { + return pmadd_impl::pmsub(a, b, c); +} + +/** \internal \returns -(a * b) + c (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pnmadd(const Packet& a, const Packet& b, const Packet& c) { + return pmadd_impl::pnmadd(a, b, c); +} + +/** \internal \returns -((a * b + c) (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet pnmsub(const Packet& a, const Packet& b, const Packet& c) { + return pmadd_impl::pnmsub(a, b, c); +} + +/** \internal copy a packet with constant coefficient \a a (e.g., [a,a,a,a]) to \a *to. \a to must be 16 bytes aligned + */ +// NOTE: this function must really be templated on the packet type (think about different packet types for the same +// scalar type) +template +inline void pstore1(typename unpacket_traits::type* to, const typename unpacket_traits::type& a) { + pstore(to, pset1(a)); +} + +/** \internal \returns a packet version of \a *from. + * The pointer \a from must be aligned on a \a Alignment bytes boundary. */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet ploadt(const typename unpacket_traits::type* from) { + if (Alignment >= unpacket_traits::alignment) + return pload(from); + else + return ploadu(from); +} + +/** \internal \returns n elements of a packet version of \a *from. + * The pointer \a from must be aligned on a \a Alignment bytes boundary. */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet ploadt_partial(const typename unpacket_traits::type* from, + const Index n, const Index offset = 0) { + if (Alignment >= unpacket_traits::alignment) + return pload_partial(from, n, offset); + else + return ploadu_partial(from, n, offset); +} + +/** \internal copy the packet \a from to \a *to. + * The pointer \a from must be aligned on a \a Alignment bytes boundary. */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE void pstoret(Scalar* to, const Packet& from) { + if (Alignment >= unpacket_traits::alignment) + pstore(to, from); + else + pstoreu(to, from); +} + +/** \internal copy n elements of the packet \a from to \a *to. + * The pointer \a from must be aligned on a \a Alignment bytes boundary. */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE void pstoret_partial(Scalar* to, const Packet& from, const Index n, + const Index offset = 0) { + if (Alignment >= unpacket_traits::alignment) + pstore_partial(to, from, n, offset); + else + pstoreu_partial(to, from, n, offset); +} + +/** \internal \returns a packet version of \a *from. + * Unlike ploadt, ploadt_ro takes advantage of the read-only memory path on the + * hardware if available to speedup the loading of data that won't be modified + * by the current computation. + */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet ploadt_ro(const typename unpacket_traits::type* from) { + return ploadt(from); +} + +/*************************************************************************** + * Fast complex products (GCC generates a function call which is very slow) + ***************************************************************************/ + +// Eigen+CUDA does not support complexes. +#if !defined(EIGEN_GPUCC) + +template <> +inline std::complex pmul(const std::complex& a, const std::complex& b) { + return std::complex(a.real() * b.real() - a.imag() * b.imag(), a.imag() * b.real() + a.real() * b.imag()); +} + +template <> +inline std::complex pmul(const std::complex& a, const std::complex& b) { + return std::complex(a.real() * b.real() - a.imag() * b.imag(), a.imag() * b.real() + a.real() * b.imag()); +} + +#endif + +/*************************************************************************** + * PacketBlock, that is a collection of N packets where the number of words + * in the packet is a multiple of N. + ***************************************************************************/ +template ::size> +struct PacketBlock { + Packet packet[N]; +}; + +template +EIGEN_DEVICE_FUNC inline void ptranspose(PacketBlock& /*kernel*/) { + // Nothing to do in the scalar case, i.e. a 1x1 matrix. +} + +/*************************************************************************** + * Selector, i.e. vector of N boolean values used to select (i.e. blend) + * words from 2 packets. + ***************************************************************************/ +template +struct Selector { + bool select[N]; +}; + +template +EIGEN_DEVICE_FUNC inline Packet pblend(const Selector::size>& ifPacket, + const Packet& thenPacket, const Packet& elsePacket) { + return ifPacket.select[0] ? thenPacket : elsePacket; +} + +/** \internal \returns 1 / a (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline Packet preciprocal(const Packet& a) { + using Scalar = typename unpacket_traits::type; + return pdiv(pset1(Scalar(1)), a); +} + +/** \internal \returns the reciprocal square-root of \a a (coeff-wise) */ +template +EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS Packet prsqrt(const Packet& a) { + return preciprocal(psqrt(a)); +} + +template ::value, + bool IsInteger = NumTraits::type>::IsInteger> +struct psignbit_impl; +template +struct psignbit_impl { + EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE static constexpr Packet run(const Packet& a) { return numext::signbit(a); } +}; +template +struct psignbit_impl { + // generic implementation if not specialized in PacketMath.h + // slower than arithmetic shift + typedef typename unpacket_traits::type Scalar; + EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE static Packet run(const Packet& a) { + const Packet cst_pos_one = pset1(Scalar(1)); + const Packet cst_neg_one = pset1(Scalar(-1)); + return pcmp_eq(por(pand(a, cst_neg_one), cst_pos_one), cst_neg_one); + } +}; +template +struct psignbit_impl { + // generic implementation for integer packets + EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE static constexpr Packet run(const Packet& a) { return pcmp_lt(a, pzero(a)); } +}; +/** \internal \returns the sign bit of \a a as a bitmask*/ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE constexpr Packet psignbit(const Packet& a) { + return psignbit_impl::run(a); +} + +/** \internal \returns the 2-argument arc tangent of \a y and \a x (coeff-wise) */ +template ::value, int> = 0> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet patan2(const Packet& y, const Packet& x) { + return numext::atan2(y, x); +} + +/** \internal \returns the 2-argument arc tangent of \a y and \a x (coeff-wise) */ +template ::value, int> = 0> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet patan2(const Packet& y, const Packet& x) { + typedef typename internal::unpacket_traits::type Scalar; + + // See https://en.cppreference.com/w/cpp/numeric/math/atan2 + // for how corner cases are supposed to be handled according to the + // IEEE floating-point standard (IEC 60559). + const Packet kSignMask = pset1(-Scalar(0)); + const Packet kZero = pzero(x); + const Packet kOne = pset1(Scalar(1)); + const Packet kPi = pset1(Scalar(EIGEN_PI)); + + const Packet x_has_signbit = psignbit(x); + const Packet y_signmask = pand(y, kSignMask); + const Packet x_signmask = pand(x, kSignMask); + const Packet result_signmask = pxor(y_signmask, x_signmask); + const Packet shift = por(pand(x_has_signbit, kPi), y_signmask); + + const Packet x_and_y_are_same = pcmp_eq(pabs(x), pabs(y)); + const Packet x_and_y_are_zero = pcmp_eq(por(x, y), kZero); + + Packet arg = pdiv(y, x); + arg = pselect(x_and_y_are_same, por(kOne, result_signmask), arg); + arg = pselect(x_and_y_are_zero, result_signmask, arg); + + Packet result = patan(arg); + result = padd(result, shift); + return result; +} + +/** \internal \returns the argument of \a a as a complex number */ +template ::value, int> = 0> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet pcarg(const Packet& a) { + return Packet(numext::arg(a)); +} + +/** \internal \returns the argument of \a a as a complex number */ +template ::value, int> = 0> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet pcarg(const Packet& a) { + EIGEN_STATIC_ASSERT(NumTraits::type>::IsComplex, + THIS METHOD IS FOR COMPLEX TYPES ONLY) + using RealPacket = typename unpacket_traits::as_real; + // a // r i r i ... + RealPacket aflip = pcplxflip(a).v; // i r i r ... + RealPacket result = patan2(aflip, a.v); // atan2 crap atan2 crap ... + return (Packet)pand(result, peven_mask(result)); // atan2 0 atan2 0 ... +} + +/** \internal \returns a packet populated with values in the range [begin, begin + count). Elements + * outside this range are not defined. \a *from does not need to be aligned, and can be null if \a count is zero.*/ +template +EIGEN_DEVICE_FUNC inline Packet ploaduSegment(const typename unpacket_traits::type* from, Index begin, + Index count) { + using Scalar = typename unpacket_traits::type; + constexpr Index PacketSize = unpacket_traits::size; + eigen_assert((begin >= 0 && count >= 0 && begin + count <= PacketSize) && "invalid range"); + Scalar aux[PacketSize] = {}; + for (Index k = begin; k < begin + count; k++) { + aux[k] = from[k]; + } + return ploadu(aux); +} + +/** \internal \returns a packet populated with values in the range [begin, begin + count). Elements + * outside this range are not defined. \a *from must be aligned, and cannot be null.*/ +template +EIGEN_DEVICE_FUNC inline Packet ploadSegment(const typename unpacket_traits::type* from, Index begin, + Index count) { + return ploaduSegment(from, begin, count); +} + +/** \internal copy the packet \a from in the range [begin, begin + count) to \a *to. +Elements outside of the range [begin, begin + count) are not defined. \a *to does not need to be aligned, and can be +null if \a count is zero.*/ +template +EIGEN_DEVICE_FUNC inline void pstoreuSegment(Scalar* to, const Packet& from, Index begin, Index count) { + constexpr Index PacketSize = unpacket_traits::size; + eigen_assert((begin >= 0 && count >= 0 && begin + count <= PacketSize) && "invalid range"); + Scalar aux[PacketSize]; + pstoreu(aux, from); + for (Index k = begin; k < begin + count; k++) { + to[k] = aux[k]; + } +} + +/** \internal copy the packet \a from in the range [begin, begin + count) to \a *to. +Elements outside of the range [begin, begin + count) are not defined. \a *to must be aligned, and cannot be +null.*/ +template +EIGEN_DEVICE_FUNC inline void pstoreSegment(Scalar* to, const Packet& from, Index begin, Index count) { + return pstoreuSegment(to, from, begin, count); +} + +/** \internal \returns a packet populated with values in the range [begin, begin + count). Elements + * outside this range are not defined.*/ +template +EIGEN_DEVICE_FUNC inline Packet ploadtSegment(const typename unpacket_traits::type* from, Index begin, + Index count) { + constexpr int RequiredAlignment = unpacket_traits::alignment; + if (Alignment >= RequiredAlignment) { + return ploadSegment(from, begin, count); + } else { + return ploaduSegment(from, begin, count); + } +} + +/** \internal copy the packet \a from in the range [begin, begin + count) to \a *to. +Elements outside of the range [begin, begin + count) are not defined.*/ +template +EIGEN_DEVICE_FUNC inline void pstoretSegment(Scalar* to, const Packet& from, Index begin, Index count) { + constexpr int RequiredAlignment = unpacket_traits::alignment; + if (Alignment >= RequiredAlignment) { + pstoreSegment(to, from, begin, count); + } else { + pstoreuSegment(to, from, begin, count); + } +} + +#ifndef EIGEN_NO_IO + +template +class StreamablePacket { + public: + using Scalar = typename unpacket_traits::type; + StreamablePacket(const Packet& packet) { pstoreu(v_, packet); } + + friend std::ostream& operator<<(std::ostream& os, const StreamablePacket& packet) { + os << "{" << packet.v_[0]; + for (int i = 1; i < unpacket_traits::size; ++i) { + os << "," << packet.v_[i]; + } + os << "}"; + return os; + } + + private: + Scalar v_[unpacket_traits::size]; +}; + +/** + * \internal \returns an intermediary that can be used to ostream packets, e.g. for debugging. + */ +template +StreamablePacket postream(const Packet& packet) { + return StreamablePacket(packet); +} + +#endif // EIGEN_NO_IO + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_GENERIC_PACKET_MATH_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/GlobalFunctions.h b/src/3rdparty/eigen/Eigen/src/Core/GlobalFunctions.h new file mode 100644 index 0000000..df1098e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/GlobalFunctions.h @@ -0,0 +1,230 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2010-2016 Gael Guennebaud +// Copyright (C) 2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GLOBAL_FUNCTIONS_H +#define EIGEN_GLOBAL_FUNCTIONS_H + +#ifdef EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(NAME, FUNCTOR, DOC_OP, DOC_DETAILS) \ + /** \returns an expression of the coefficient-wise DOC_OP of \a x \ + \ \ + DOC_DETAILS \ + \ \ + \sa Math functions, class CwiseUnaryOp \ + */ \ + template \ + inline const Eigen::CwiseUnaryOp, const Derived> NAME( \ + const Eigen::ArrayBase& x); + +#else + +#define EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(NAME, FUNCTOR, DOC_OP, DOC_DETAILS) \ + template \ + inline const Eigen::CwiseUnaryOp, const Derived>(NAME)( \ + const Eigen::ArrayBase& x) { \ + return Eigen::CwiseUnaryOp, const Derived>(x.derived()); \ + } + +#endif // EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(NAME, FUNCTOR) \ + \ + template \ + struct NAME##_retval > { \ + typedef const Eigen::CwiseUnaryOp, const Derived> type; \ + }; \ + template \ + struct NAME##_impl > { \ + static inline typename NAME##_retval >::type run(const Eigen::ArrayBase& x) { \ + return typename NAME##_retval >::type(x.derived()); \ + } \ + }; + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(real, scalar_real_op, real part,\sa ArrayBase::real) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(imag, scalar_imag_op, imaginary part,\sa ArrayBase::imag) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(conj, scalar_conjugate_op, complex conjugate,\sa ArrayBase::conjugate) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(inverse, scalar_inverse_op, inverse,\sa ArrayBase::inverse) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sin, scalar_sin_op, sine,\sa ArrayBase::sin) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cos, scalar_cos_op, cosine,\sa ArrayBase::cos) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(tan, scalar_tan_op, tangent,\sa ArrayBase::tan) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(atan, scalar_atan_op, arc - tangent,\sa ArrayBase::atan) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(asin, scalar_asin_op, arc - sine,\sa ArrayBase::asin) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(acos, scalar_acos_op, arc - consine,\sa ArrayBase::acos) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sinh, scalar_sinh_op, hyperbolic sine,\sa ArrayBase::sinh) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cosh, scalar_cosh_op, hyperbolic cosine,\sa ArrayBase::cosh) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(tanh, scalar_tanh_op, hyperbolic tangent,\sa ArrayBase::tanh) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(asinh, scalar_asinh_op, inverse hyperbolic sine,\sa ArrayBase::asinh) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(acosh, scalar_acosh_op, inverse hyperbolic cosine,\sa ArrayBase::acosh) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(atanh, scalar_atanh_op, inverse hyperbolic tangent,\sa ArrayBase::atanh) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(logistic, scalar_logistic_op, logistic function,\sa ArrayBase::logistic) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(lgamma, scalar_lgamma_op, + natural logarithm of the gamma function,\sa ArrayBase::lgamma) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(digamma, scalar_digamma_op, derivative of lgamma,\sa ArrayBase::digamma) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(erf, scalar_erf_op, error function,\sa ArrayBase::erf) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(erfc, scalar_erfc_op, complement error function,\sa ArrayBase::erfc) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(ndtri, scalar_ndtri_op, inverse normal distribution function,\sa ArrayBase::ndtri) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(exp, scalar_exp_op, exponential,\sa ArrayBase::exp) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(exp2, scalar_exp2_op, exponential,\sa ArrayBase::exp2) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(expm1, scalar_expm1_op, exponential of a value minus 1,\sa ArrayBase::expm1) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log, scalar_log_op, natural logarithm,\sa Eigen::log10 DOXCOMMA ArrayBase::log) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log1p, scalar_log1p_op, natural logarithm of 1 plus the value,\sa ArrayBase::log1p) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log10, scalar_log10_op, base 10 logarithm,\sa Eigen::log DOXCOMMA ArrayBase::log10) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log2, scalar_log2_op, base 2 logarithm,\sa Eigen::log DOXCOMMA ArrayBase::log2) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(abs, scalar_abs_op, absolute value,\sa ArrayBase::abs DOXCOMMA MatrixBase::cwiseAbs) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(abs2, scalar_abs2_op, + squared absolute value,\sa ArrayBase::abs2 DOXCOMMA MatrixBase::cwiseAbs2) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(arg, scalar_arg_op, complex argument,\sa ArrayBase::arg DOXCOMMA MatrixBase::cwiseArg) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(carg, scalar_carg_op, + complex argument, \sa ArrayBase::carg DOXCOMMA MatrixBase::cwiseCArg) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sqrt, scalar_sqrt_op, square root,\sa ArrayBase::sqrt DOXCOMMA MatrixBase::cwiseSqrt) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cbrt, scalar_cbrt_op, cube root,\sa ArrayBase::cbrt DOXCOMMA MatrixBase::cwiseCbrt) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(rsqrt, scalar_rsqrt_op, reciprocal square root,\sa ArrayBase::rsqrt) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(square, scalar_square_op, + square(power 2),\sa Eigen::abs2 DOXCOMMA Eigen::pow DOXCOMMA ArrayBase::square) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cube, scalar_cube_op, cube(power 3),\sa Eigen::pow DOXCOMMA ArrayBase::cube) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(rint, scalar_rint_op, + nearest integer,\sa Eigen::floor DOXCOMMA Eigen::ceil DOXCOMMA ArrayBase::round) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(round, scalar_round_op, + nearest integer,\sa Eigen::floor DOXCOMMA Eigen::ceil DOXCOMMA ArrayBase::round) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY( + floor, scalar_floor_op, nearest integer not greater than the given value,\sa Eigen::ceil DOXCOMMA ArrayBase::floor) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY( + ceil, scalar_ceil_op, nearest integer not less than the given value,\sa Eigen::floor DOXCOMMA ArrayBase::ceil) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(trunc, scalar_trunc_op, + nearest integer not greater in magnitude than the given value,\sa Eigen::trunc DOXCOMMA + ArrayBase::trunc) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY( + isnan, scalar_isnan_op, not -a - number test,\sa Eigen::isinf DOXCOMMA Eigen::isfinite DOXCOMMA ArrayBase::isnan) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY( + isinf, scalar_isinf_op, infinite value test,\sa Eigen::isnan DOXCOMMA Eigen::isfinite DOXCOMMA ArrayBase::isinf) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(isfinite, scalar_isfinite_op, + finite value test,\sa Eigen::isinf DOXCOMMA Eigen::isnan DOXCOMMA ArrayBase::isfinite) +EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sign, scalar_sign_op, sign(or 0),\sa ArrayBase::sign) + +template +using GlobalUnaryPowReturnType = std::enable_if_t< + !internal::is_arithmetic::Real>::value && + internal::is_arithmetic::Real>::value, + CwiseUnaryOp, const Derived> >; + +/** \returns an expression of the coefficient-wise power of \a x to the given constant \a exponent. + * + * \tparam ScalarExponent is the scalar type of \a exponent. It must be compatible with the scalar type of the given + * expression (\c Derived::Scalar). + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ +#ifdef EIGEN_PARSED_BY_DOXYGEN +template +EIGEN_DEVICE_FUNC inline const GlobalUnaryPowReturnType pow(const Eigen::ArrayBase& x, + const ScalarExponent& exponent); +#else +template +EIGEN_DEVICE_FUNC inline const GlobalUnaryPowReturnType pow(const Eigen::ArrayBase& x, + const ScalarExponent& exponent) { + return GlobalUnaryPowReturnType( + x.derived(), internal::scalar_unary_pow_op(exponent)); +} +#endif + +/** \returns an expression of the coefficient-wise power of \a x to the given array of \a exponents. + * + * This function computes the coefficient-wise power. + * + * Example: \include Cwise_array_power_array.cpp + * Output: \verbinclude Cwise_array_power_array.out + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ +template +inline const Eigen::CwiseBinaryOp< + Eigen::internal::scalar_pow_op, const Derived, + const ExponentDerived> +pow(const Eigen::ArrayBase& x, const Eigen::ArrayBase& exponents) { + return Eigen::CwiseBinaryOp< + Eigen::internal::scalar_pow_op, const Derived, + const ExponentDerived>(x.derived(), exponents.derived()); +} + +/** \returns an expression of the coefficient-wise power of the scalar \a x to the given array of \a exponents. + * + * This function computes the coefficient-wise power between a scalar and an array of exponents. + * + * \tparam Scalar is the scalar type of \a x. It must be compatible with the scalar type of the given array expression + * (\c Derived::Scalar). + * + * Example: \include Cwise_scalar_power_array.cpp + * Output: \verbinclude Cwise_scalar_power_array.out + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ +#ifdef EIGEN_PARSED_BY_DOXYGEN +template +inline const CwiseBinaryOp, Constant, Derived> pow( + const Scalar& x, const Eigen::ArrayBase& x); +#else +template +EIGEN_DEVICE_FUNC inline const EIGEN_SCALAR_BINARYOP_EXPR_RETURN_TYPE( + typename internal::promote_scalar_arg::type, + Derived, pow) pow(const Scalar& x, const Eigen::ArrayBase& exponents) { + typedef + typename internal::promote_scalar_arg::type + PromotedScalar; + return EIGEN_SCALAR_BINARYOP_EXPR_RETURN_TYPE(PromotedScalar, Derived, pow)( + typename internal::plain_constant_type::type( + exponents.derived().rows(), exponents.derived().cols(), internal::scalar_constant_op(x)), + exponents.derived()); +} +#endif + +/** \returns an expression of the coefficient-wise atan2(\a x, \a y). \a x and \a y must be of the same type. + * + * This function computes the coefficient-wise atan2(). + * + * \sa ArrayBase::atan2() + * + * \relates ArrayBase + */ +template +inline const std::enable_if_t< + std::is_same::value, + Eigen::CwiseBinaryOp, + const LhsDerived, const RhsDerived> > +atan2(const Eigen::ArrayBase& x, const Eigen::ArrayBase& exponents) { + return Eigen::CwiseBinaryOp< + Eigen::internal::scalar_atan2_op, const LhsDerived, + const RhsDerived>(x.derived(), exponents.derived()); +} + +namespace internal { +EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(real, scalar_real_op) +EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(imag, scalar_imag_op) +EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(abs2, scalar_abs2_op) +} // namespace internal +} // namespace Eigen + +// TODO: cleanly disable those functions that are not supported on Array (numext::real_ref, internal::random, +// internal::isApprox...) + +#endif // EIGEN_GLOBAL_FUNCTIONS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/IO.h b/src/3rdparty/eigen/Eigen/src/Core/IO.h new file mode 100644 index 0000000..0a1b583 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/IO.h @@ -0,0 +1,233 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_IO_H +#define EIGEN_IO_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +enum { DontAlignCols = 1 }; +enum { StreamPrecision = -1, FullPrecision = -2 }; + +namespace internal { +template +std::ostream& print_matrix(std::ostream& s, const Derived& _m, const IOFormat& fmt); +} + +/** \class IOFormat + * \ingroup Core_Module + * + * \brief Stores a set of parameters controlling the way matrices are printed + * + * List of available parameters: + * - \b precision number of digits for floating point values, or one of the special constants \c StreamPrecision and \c + * FullPrecision. The default is the special value \c StreamPrecision which means to use the stream's own precision + * setting, as set for instance using \c cout.precision(3). The other special value \c FullPrecision means that the + * number of digits will be computed to match the full precision of each floating-point type. + * - \b flags an OR-ed combination of flags, the default value is 0, the only currently available flag is \c + * DontAlignCols which allows to disable the alignment of columns, resulting in faster code. + * - \b coeffSeparator string printed between two coefficients of the same row + * - \b rowSeparator string printed between two rows + * - \b rowPrefix string printed at the beginning of each row + * - \b rowSuffix string printed at the end of each row + * - \b matPrefix string printed at the beginning of the matrix + * - \b matSuffix string printed at the end of the matrix + * - \b fill character printed to fill the empty space in aligned columns + * + * Example: \include IOFormat.cpp + * Output: \verbinclude IOFormat.out + * + * \sa DenseBase::format(), class WithFormat + */ +struct IOFormat { + /** Default constructor, see class IOFormat for the meaning of the parameters */ + IOFormat(int _precision = StreamPrecision, int _flags = 0, const std::string& _coeffSeparator = " ", + const std::string& _rowSeparator = "\n", const std::string& _rowPrefix = "", + const std::string& _rowSuffix = "", const std::string& _matPrefix = "", const std::string& _matSuffix = "", + const char _fill = ' ') + : matPrefix(_matPrefix), + matSuffix(_matSuffix), + rowPrefix(_rowPrefix), + rowSuffix(_rowSuffix), + rowSeparator(_rowSeparator), + rowSpacer(""), + coeffSeparator(_coeffSeparator), + fill(_fill), + precision(_precision), + flags(_flags) { + // TODO check if rowPrefix, rowSuffix or rowSeparator contains a newline + // don't add rowSpacer if columns are not to be aligned + if ((flags & DontAlignCols)) return; + int i = int(matPrefix.length()) - 1; + while (i >= 0 && matPrefix[i] != '\n') { + rowSpacer += ' '; + i--; + } + } + std::string matPrefix, matSuffix; + std::string rowPrefix, rowSuffix, rowSeparator, rowSpacer; + std::string coeffSeparator; + char fill; + int precision; + int flags; +}; + +/** \class WithFormat + * \ingroup Core_Module + * + * \brief Pseudo expression providing matrix output with given format + * + * \tparam ExpressionType the type of the object on which IO stream operations are performed + * + * This class represents an expression with stream operators controlled by a given IOFormat. + * It is the return type of DenseBase::format() + * and most of the time this is the only way it is used. + * + * See class IOFormat for some examples. + * + * \sa DenseBase::format(), class IOFormat + */ +template +class WithFormat { + public: + WithFormat(const ExpressionType& matrix, const IOFormat& format) : m_matrix(matrix), m_format(format) {} + + friend std::ostream& operator<<(std::ostream& s, const WithFormat& wf) { + return internal::print_matrix(s, wf.m_matrix.eval(), wf.m_format); + } + + protected: + typename ExpressionType::Nested m_matrix; + IOFormat m_format; +}; + +namespace internal { + +// NOTE: This helper is kept for backward compatibility with previous code specializing +// this internal::significant_decimals_impl structure. In the future we should directly +// call max_digits10(). +template +struct significant_decimals_impl { + static inline int run() { return NumTraits::max_digits10(); } +}; + +/** \internal + * print the matrix \a _m to the output stream \a s using the output format \a fmt */ +template +std::ostream& print_matrix(std::ostream& s, const Derived& _m, const IOFormat& fmt) { + using internal::is_same; + + if (_m.size() == 0) { + s << fmt.matPrefix << fmt.matSuffix; + return s; + } + + typename Derived::Nested m = _m; + typedef typename Derived::Scalar Scalar; + typedef std::conditional_t::value || is_same::value || + is_same::value || is_same::value, + int, + std::conditional_t >::value || + is_same >::value || + is_same >::value || + is_same >::value, + std::complex, const Scalar&> > + PrintType; + + Index width = 0; + + std::streamsize explicit_precision; + if (fmt.precision == StreamPrecision) { + explicit_precision = 0; + } else if (fmt.precision == FullPrecision) { + if (NumTraits::IsInteger) { + explicit_precision = 0; + } else { + explicit_precision = significant_decimals_impl::run(); + } + } else { + explicit_precision = fmt.precision; + } + + std::streamsize old_precision = 0; + if (explicit_precision) old_precision = s.precision(explicit_precision); + + bool align_cols = !(fmt.flags & DontAlignCols); + if (align_cols) { + // compute the largest width + for (Index j = 0; j < m.cols(); ++j) + for (Index i = 0; i < m.rows(); ++i) { + std::stringstream sstr; + sstr.copyfmt(s); + sstr << static_cast(m.coeff(i, j)); + width = std::max(width, Index(sstr.str().length())); + } + } + std::streamsize old_width = s.width(); + char old_fill_character = s.fill(); + s << fmt.matPrefix; + for (Index i = 0; i < m.rows(); ++i) { + if (i) s << fmt.rowSpacer; + s << fmt.rowPrefix; + if (width) { + s.fill(fmt.fill); + s.width(width); + } + s << static_cast(m.coeff(i, 0)); + for (Index j = 1; j < m.cols(); ++j) { + s << fmt.coeffSeparator; + if (width) { + s.fill(fmt.fill); + s.width(width); + } + s << static_cast(m.coeff(i, j)); + } + s << fmt.rowSuffix; + if (i < m.rows() - 1) s << fmt.rowSeparator; + } + s << fmt.matSuffix; + if (explicit_precision) s.precision(old_precision); + if (width) { + s.fill(old_fill_character); + s.width(old_width); + } + return s; +} + +} // end namespace internal + +/** \relates DenseBase + * + * Outputs the matrix, to the given stream. + * + * If you wish to print the matrix with a format different than the default, use DenseBase::format(). + * + * It is also possible to change the default format by defining EIGEN_DEFAULT_IO_FORMAT before including Eigen headers. + * If not defined, this will automatically be defined to Eigen::IOFormat(), that is the Eigen::IOFormat with default + * parameters. + * + * \sa DenseBase::format() + */ +template +std::ostream& operator<<(std::ostream& s, const DenseBase& m) { + return internal::print_matrix(s, m.eval(), EIGEN_DEFAULT_IO_FORMAT); +} + +template +std::ostream& operator<<(std::ostream& s, const DiagonalBase& m) { + return internal::print_matrix(s, m.derived(), EIGEN_DEFAULT_IO_FORMAT); +} + +} // end namespace Eigen + +#endif // EIGEN_IO_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/IndexedView.h b/src/3rdparty/eigen/Eigen/src/Core/IndexedView.h new file mode 100644 index 0000000..10562c1 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/IndexedView.h @@ -0,0 +1,321 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2017 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_INDEXED_VIEW_H +#define EIGEN_INDEXED_VIEW_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct traits> : traits { + enum { + RowsAtCompileTime = int(IndexedViewHelper::SizeAtCompileTime), + ColsAtCompileTime = int(IndexedViewHelper::SizeAtCompileTime), + MaxRowsAtCompileTime = RowsAtCompileTime, + MaxColsAtCompileTime = ColsAtCompileTime, + + XprTypeIsRowMajor = (int(traits::Flags) & RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime == 1 && MaxColsAtCompileTime != 1) ? 1 + : (MaxColsAtCompileTime == 1 && MaxRowsAtCompileTime != 1) ? 0 + : XprTypeIsRowMajor, + + RowIncr = int(IndexedViewHelper::IncrAtCompileTime), + ColIncr = int(IndexedViewHelper::IncrAtCompileTime), + InnerIncr = IsRowMajor ? ColIncr : RowIncr, + OuterIncr = IsRowMajor ? RowIncr : ColIncr, + + HasSameStorageOrderAsXprType = (IsRowMajor == XprTypeIsRowMajor), + XprInnerStride = HasSameStorageOrderAsXprType ? int(inner_stride_at_compile_time::ret) + : int(outer_stride_at_compile_time::ret), + XprOuterstride = HasSameStorageOrderAsXprType ? int(outer_stride_at_compile_time::ret) + : int(inner_stride_at_compile_time::ret), + + InnerSize = XprTypeIsRowMajor ? ColsAtCompileTime : RowsAtCompileTime, + IsBlockAlike = InnerIncr == 1 && OuterIncr == 1, + IsInnerPannel = HasSameStorageOrderAsXprType && + is_same, std::conditional_t>::value, + + InnerStrideAtCompileTime = + InnerIncr < 0 || InnerIncr == DynamicIndex || XprInnerStride == Dynamic || InnerIncr == Undefined + ? Dynamic + : XprInnerStride * InnerIncr, + OuterStrideAtCompileTime = + OuterIncr < 0 || OuterIncr == DynamicIndex || XprOuterstride == Dynamic || OuterIncr == Undefined + ? Dynamic + : XprOuterstride * OuterIncr, + + ReturnAsScalar = is_single_range::value && is_single_range::value, + ReturnAsBlock = (!ReturnAsScalar) && IsBlockAlike, + ReturnAsIndexedView = (!ReturnAsScalar) && (!ReturnAsBlock), + + // FIXME we deal with compile-time strides if and only if we have DirectAccessBit flag, + // but this is too strict regarding negative strides... + DirectAccessMask = (int(InnerIncr) != Undefined && int(OuterIncr) != Undefined && InnerIncr >= 0 && OuterIncr >= 0) + ? DirectAccessBit + : 0, + FlagsRowMajorBit = IsRowMajor ? RowMajorBit : 0, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1) ? LinearAccessBit : 0, + Flags = (traits::Flags & (HereditaryBits | DirectAccessMask)) | FlagsLvalueBit | FlagsRowMajorBit | + FlagsLinearAccessBit + }; + + typedef Block BlockType; +}; + +template +class IndexedViewImpl; + +} // namespace internal + +/** \class IndexedView + * \ingroup Core_Module + * + * \brief Expression of a non-sequential sub-matrix defined by arbitrary sequences of row and column indices + * + * \tparam XprType the type of the expression in which we are taking the intersections of sub-rows and sub-columns + * \tparam RowIndices the type of the object defining the sequence of row indices + * \tparam ColIndices the type of the object defining the sequence of column indices + * + * This class represents an expression of a sub-matrix (or sub-vector) defined as the intersection + * of sub-sets of rows and columns, that are themself defined by generic sequences of row indices \f$ + * \{r_0,r_1,..r_{m-1}\} \f$ and column indices \f$ \{c_0,c_1,..c_{n-1} \}\f$. Let \f$ A \f$ be the nested matrix, then + * the resulting matrix \f$ B \f$ has \c m rows and \c n columns, and its entries are given by: \f$ B(i,j) = A(r_i,c_j) + * \f$. + * + * The \c RowIndices and \c ColIndices types must be compatible with the following API: + * \code + * operator[](Index) const; + * Index size() const; + * \endcode + * + * Typical supported types thus include: + * - std::vector + * - std::valarray + * - std::array + * - Eigen::ArrayXi + * - decltype(ArrayXi::LinSpaced(...)) + * - Any view/expressions of the previous types + * - Eigen::ArithmeticSequence + * - Eigen::internal::AllRange (helper for Eigen::placeholders::all) + * - Eigen::internal::SingleRange (helper for single index) + * - etc. + * + * In typical usages of %Eigen, this class should never be used directly. It is the return type of + * DenseBase::operator()(const RowIndices&, const ColIndices&). + * + * \sa class Block + */ +template +class IndexedView + : public internal::IndexedViewImpl::StorageKind, + (internal::traits>::Flags & + DirectAccessBit) != 0> { + public: + typedef typename internal::IndexedViewImpl< + XprType, RowIndices, ColIndices, typename internal::traits::StorageKind, + (internal::traits>::Flags & DirectAccessBit) != 0> + Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(IndexedView) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(IndexedView) + + template + IndexedView(XprType& xpr, const T0& rowIndices, const T1& colIndices) : Base(xpr, rowIndices, colIndices) {} +}; + +namespace internal { + +// Generic API dispatcher +template +class IndexedViewImpl : public internal::generic_xpr_base>::type { + public: + typedef typename internal::generic_xpr_base>::type Base; + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef internal::remove_all_t NestedExpression; + typedef typename XprType::Scalar Scalar; + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(IndexedViewImpl) + + template + IndexedViewImpl(XprType& xpr, const T0& rowIndices, const T1& colIndices) + : m_xpr(xpr), m_rowIndices(rowIndices), m_colIndices(colIndices) {} + + /** \returns number of rows */ + Index rows() const { return IndexedViewHelper::size(m_rowIndices); } + + /** \returns number of columns */ + Index cols() const { return IndexedViewHelper::size(m_colIndices); } + + /** \returns the nested expression */ + const internal::remove_all_t& nestedExpression() const { return m_xpr; } + + /** \returns the nested expression */ + std::remove_reference_t& nestedExpression() { return m_xpr; } + + /** \returns a const reference to the object storing/generating the row indices */ + const RowIndices& rowIndices() const { return m_rowIndices; } + + /** \returns a const reference to the object storing/generating the column indices */ + const ColIndices& colIndices() const { return m_colIndices; } + + constexpr Scalar& coeffRef(Index rowId, Index colId) { + return nestedExpression().coeffRef(m_rowIndices[rowId], m_colIndices[colId]); + } + + constexpr const Scalar& coeffRef(Index rowId, Index colId) const { + return nestedExpression().coeffRef(m_rowIndices[rowId], m_colIndices[colId]); + } + + protected: + MatrixTypeNested m_xpr; + RowIndices m_rowIndices; + ColIndices m_colIndices; +}; + +template +class IndexedViewImpl + : public IndexedViewImpl { + public: + using Base = internal::IndexedViewImpl::StorageKind, false>; + using Derived = IndexedView; + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(IndexedViewImpl) + + template + IndexedViewImpl(XprType& xpr, const T0& rowIndices, const T1& colIndices) : Base(xpr, rowIndices, colIndices) {} + + Index rowIncrement() const { + if (traits::RowIncr != DynamicIndex && traits::RowIncr != Undefined) { + return traits::RowIncr; + } + return IndexedViewHelper::incr(this->rowIndices()); + } + Index colIncrement() const { + if (traits::ColIncr != DynamicIndex && traits::ColIncr != Undefined) { + return traits::ColIncr; + } + return IndexedViewHelper::incr(this->colIndices()); + } + + Index innerIncrement() const { return traits::IsRowMajor ? colIncrement() : rowIncrement(); } + + Index outerIncrement() const { return traits::IsRowMajor ? rowIncrement() : colIncrement(); } + + std::decay_t* data() { + Index row_offset = this->rowIndices()[0] * this->nestedExpression().rowStride(); + Index col_offset = this->colIndices()[0] * this->nestedExpression().colStride(); + return this->nestedExpression().data() + row_offset + col_offset; + } + + const std::decay_t* data() const { + Index row_offset = this->rowIndices()[0] * this->nestedExpression().rowStride(); + Index col_offset = this->colIndices()[0] * this->nestedExpression().colStride(); + return this->nestedExpression().data() + row_offset + col_offset; + } + + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { + if (traits::InnerStrideAtCompileTime != Dynamic) { + return traits::InnerStrideAtCompileTime; + } + return innerIncrement() * this->nestedExpression().innerStride(); + } + + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { + if (traits::OuterStrideAtCompileTime != Dynamic) { + return traits::OuterStrideAtCompileTime; + } + return outerIncrement() * this->nestedExpression().outerStride(); + } +}; + +template +struct unary_evaluator, IndexBased> + : evaluator_base> { + typedef IndexedView XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost /* TODO + cost of row/col index */, + + FlagsLinearAccessBit = + (traits::RowsAtCompileTime == 1 || traits::ColsAtCompileTime == 1) ? LinearAccessBit : 0, + + FlagsRowMajorBit = traits::FlagsRowMajorBit, + + Flags = (evaluator::Flags & (HereditaryBits & ~RowMajorBit /*| LinearAccessBit | DirectAccessBit*/)) | + FlagsLinearAccessBit | FlagsRowMajorBit, + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC explicit unary_evaluator(const XprType& xpr) : m_argImpl(xpr.nestedExpression()), m_xpr(xpr) { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const { + eigen_assert(m_xpr.rowIndices()[row] >= 0 && m_xpr.rowIndices()[row] < m_xpr.nestedExpression().rows() && + m_xpr.colIndices()[col] >= 0 && m_xpr.colIndices()[col] < m_xpr.nestedExpression().cols()); + return m_argImpl.coeff(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { + eigen_assert(m_xpr.rowIndices()[row] >= 0 && m_xpr.rowIndices()[row] < m_xpr.nestedExpression().rows() && + m_xpr.colIndices()[col] >= 0 && m_xpr.colIndices()[col] < m_xpr.nestedExpression().cols()); + return m_argImpl.coeffRef(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + eigen_assert(m_xpr.rowIndices()[row] >= 0 && m_xpr.rowIndices()[row] < m_xpr.nestedExpression().rows() && + m_xpr.colIndices()[col] >= 0 && m_xpr.colIndices()[col] < m_xpr.nestedExpression().cols()); + return m_argImpl.coeffRef(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar& coeffRef(Index index) const { + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + eigen_assert(m_xpr.rowIndices()[row] >= 0 && m_xpr.rowIndices()[row] < m_xpr.nestedExpression().rows() && + m_xpr.colIndices()[col] >= 0 && m_xpr.colIndices()[col] < m_xpr.nestedExpression().cols()); + return m_argImpl.coeffRef(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index index) const { + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + eigen_assert(m_xpr.rowIndices()[row] >= 0 && m_xpr.rowIndices()[row] < m_xpr.nestedExpression().rows() && + m_xpr.colIndices()[col] >= 0 && m_xpr.colIndices()[col] < m_xpr.nestedExpression().cols()); + return m_argImpl.coeff(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + protected: + evaluator m_argImpl; + const XprType& m_xpr; +}; + +// Catch assignments to an IndexedView. +template +struct evaluator_assume_aliasing> { + static const bool value = true; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_INDEXED_VIEW_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/InnerProduct.h b/src/3rdparty/eigen/Eigen/src/Core/InnerProduct.h new file mode 100644 index 0000000..686ad13 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/InnerProduct.h @@ -0,0 +1,260 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2024 Charlie Schlosser +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_INNER_PRODUCT_EVAL_H +#define EIGEN_INNER_PRODUCT_EVAL_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +// recursively searches for the largest simd type that does not exceed Size, or the smallest if no such type exists +template ::type, + bool Stop = + (unpacket_traits::size <= Size) || is_same::half>::value> +struct find_inner_product_packet_helper; + +template +struct find_inner_product_packet_helper { + using type = typename find_inner_product_packet_helper::half>::type; +}; + +template +struct find_inner_product_packet_helper { + using type = Packet; +}; + +template +struct find_inner_product_packet : find_inner_product_packet_helper {}; + +template +struct find_inner_product_packet { + using type = typename packet_traits::type; +}; + +template +struct inner_product_assert { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Lhs) + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Rhs) + EIGEN_STATIC_ASSERT_SAME_VECTOR_SIZE(Lhs, Rhs) +#ifndef EIGEN_NO_DEBUG + static EIGEN_DEVICE_FUNC void run(const Lhs& lhs, const Rhs& rhs) { + eigen_assert((lhs.size() == rhs.size()) && "Inner product: lhs and rhs vectors must have same size"); + } +#else + static EIGEN_DEVICE_FUNC void run(const Lhs&, const Rhs&) {} +#endif +}; + +template +struct inner_product_evaluator { + static constexpr int LhsFlags = evaluator::Flags; + static constexpr int RhsFlags = evaluator::Flags; + static constexpr int SizeAtCompileTime = size_prefer_fixed(Lhs::SizeAtCompileTime, Rhs::SizeAtCompileTime); + static constexpr int MaxSizeAtCompileTime = + min_size_prefer_fixed(Lhs::MaxSizeAtCompileTime, Rhs::MaxSizeAtCompileTime); + static constexpr int LhsAlignment = evaluator::Alignment; + static constexpr int RhsAlignment = evaluator::Alignment; + + using Scalar = typename Func::result_type; + using Packet = typename find_inner_product_packet::type; + + static constexpr bool Vectorize = + bool(LhsFlags & RhsFlags & PacketAccessBit) && Func::PacketAccess && + ((MaxSizeAtCompileTime == Dynamic) || (unpacket_traits::size <= MaxSizeAtCompileTime)); + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit inner_product_evaluator(const Lhs& lhs, const Rhs& rhs, + Func func = Func()) + : m_func(func), m_lhs(lhs), m_rhs(rhs), m_size(lhs.size()) { + inner_product_assert::run(lhs, rhs); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index size() const { return m_size.value(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index index) const { + return m_func.coeff(m_lhs.coeff(index), m_rhs.coeff(index)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(const Scalar& value, Index index) const { + return m_func.coeff(value, m_lhs.coeff(index), m_rhs.coeff(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + return m_func.packet(m_lhs.template packet(index), + m_rhs.template packet(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(const PacketType& value, Index index) const { + return m_func.packet(value, m_lhs.template packet(index), + m_rhs.template packet(index)); + } + + const Func m_func; + const evaluator m_lhs; + const evaluator m_rhs; + const variable_if_dynamic m_size; +}; + +template +struct inner_product_impl; + +// scalar loop +template +struct inner_product_impl { + using Scalar = typename Evaluator::Scalar; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval) { + const Index size = eval.size(); + if (size == 0) return Scalar(0); + + Scalar result = eval.coeff(0); + for (Index k = 1; k < size; k++) { + result = eval.coeff(result, k); + } + + return result; + } +}; + +// vector loop +template +struct inner_product_impl { + using UnsignedIndex = std::make_unsigned_t; + using Scalar = typename Evaluator::Scalar; + using Packet = typename Evaluator::Packet; + static constexpr int PacketSize = unpacket_traits::size; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval) { + const UnsignedIndex size = static_cast(eval.size()); + if (size < PacketSize) return inner_product_impl::run(eval); + + const UnsignedIndex packetEnd = numext::round_down(size, PacketSize); + const UnsignedIndex quadEnd = numext::round_down(size, 4 * PacketSize); + const UnsignedIndex numPackets = size / PacketSize; + const UnsignedIndex numRemPackets = (packetEnd - quadEnd) / PacketSize; + + Packet presult0, presult1, presult2, presult3; + + presult0 = eval.template packet(0 * PacketSize); + if (numPackets >= 2) presult1 = eval.template packet(1 * PacketSize); + if (numPackets >= 3) presult2 = eval.template packet(2 * PacketSize); + if (numPackets >= 4) { + presult3 = eval.template packet(3 * PacketSize); + + for (UnsignedIndex k = 4 * PacketSize; k < quadEnd; k += 4 * PacketSize) { + presult0 = eval.packet(presult0, k + 0 * PacketSize); + presult1 = eval.packet(presult1, k + 1 * PacketSize); + presult2 = eval.packet(presult2, k + 2 * PacketSize); + presult3 = eval.packet(presult3, k + 3 * PacketSize); + } + + if (numRemPackets >= 1) presult0 = eval.packet(presult0, quadEnd + 0 * PacketSize); + if (numRemPackets >= 2) presult1 = eval.packet(presult1, quadEnd + 1 * PacketSize); + if (numRemPackets == 3) presult2 = eval.packet(presult2, quadEnd + 2 * PacketSize); + + presult2 = padd(presult2, presult3); + } + + if (numPackets >= 3) presult1 = padd(presult1, presult2); + if (numPackets >= 2) presult0 = padd(presult0, presult1); + + Scalar result = predux(presult0); + for (UnsignedIndex k = packetEnd; k < size; k++) { + result = eval.coeff(result, k); + } + + return result; + } +}; + +template +struct conditional_conj; + +template +struct conditional_conj { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(const Scalar& a) { return numext::conj(a); } + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet packet(const Packet& a) { + return pconj(a); + } +}; + +template +struct conditional_conj { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(const Scalar& a) { return a; } + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet packet(const Packet& a) { + return a; + } +}; + +template +struct scalar_inner_product_op { + using result_type = typename ScalarBinaryOpTraits::ReturnType; + using conj_helper = conditional_conj; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE result_type coeff(const LhsScalar& a, const RhsScalar& b) const { + return (conj_helper::coeff(a) * b); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE result_type coeff(const result_type& accum, const LhsScalar& a, + const RhsScalar& b) const { + return (conj_helper::coeff(a) * b) + accum; + } + static constexpr bool PacketAccess = false; +}; + +// Partial specialization for packet access if and only if +// LhsScalar == RhsScalar == ScalarBinaryOpTraits::ReturnType. +template +struct scalar_inner_product_op< + Scalar, + typename std::enable_if::ReturnType, Scalar>::value, + Scalar>::type, + Conj> { + using result_type = Scalar; + using conj_helper = conditional_conj; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(const Scalar& a, const Scalar& b) const { + return pmul(conj_helper::coeff(a), b); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(const Scalar& accum, const Scalar& a, const Scalar& b) const { + return pmadd(conj_helper::coeff(a), b, accum); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet packet(const Packet& a, const Packet& b) const { + return pmul(conj_helper::packet(a), b); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet packet(const Packet& accum, const Packet& a, const Packet& b) const { + return pmadd(conj_helper::packet(a), b, accum); + } + static constexpr bool PacketAccess = packet_traits::HasMul && packet_traits::HasAdd; +}; + +template +struct default_inner_product_impl { + using LhsScalar = typename traits::Scalar; + using RhsScalar = typename traits::Scalar; + using Op = scalar_inner_product_op; + using Evaluator = inner_product_evaluator; + using result_type = typename Evaluator::Scalar; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE result_type run(const MatrixBase& a, const MatrixBase& b) { + Evaluator eval(a.derived(), b.derived(), Op()); + return inner_product_impl::run(eval); + } +}; + +template +struct dot_impl : default_inner_product_impl {}; + +} // namespace internal +} // namespace Eigen + +#endif // EIGEN_INNER_PRODUCT_EVAL_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/InternalHeaderCheck.h b/src/3rdparty/eigen/Eigen/src/Core/InternalHeaderCheck.h new file mode 100644 index 0000000..1cea572 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/InternalHeaderCheck.h @@ -0,0 +1,3 @@ +#ifndef EIGEN_CORE_MODULE_H +#error "Please include Eigen/Core instead of including headers inside the src directory directly." +#endif diff --git a/src/3rdparty/eigen/Eigen/src/Core/Inverse.h b/src/3rdparty/eigen/Eigen/src/Core/Inverse.h new file mode 100644 index 0000000..79fc3ab --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Inverse.h @@ -0,0 +1,108 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2014-2019 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_INVERSE_H +#define EIGEN_INVERSE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +template +class InverseImpl; + +namespace internal { + +template +struct traits > : traits { + typedef typename XprType::PlainObject PlainObject; + typedef traits BaseTraits; + enum { Flags = BaseTraits::Flags & RowMajorBit }; +}; + +} // end namespace internal + +/** \class Inverse + * + * \brief Expression of the inverse of another expression + * + * \tparam XprType the type of the expression we are taking the inverse + * + * This class represents an abstract expression of A.inverse() + * and most of the time this is the only way it is used. + * + */ +template +class Inverse : public InverseImpl::StorageKind> { + public: + typedef typename XprType::StorageIndex StorageIndex; + typedef typename XprType::Scalar Scalar; + typedef typename internal::ref_selector::type XprTypeNested; + typedef internal::remove_all_t XprTypeNestedCleaned; + typedef typename internal::ref_selector::type Nested; + typedef internal::remove_all_t NestedExpression; + + explicit EIGEN_DEVICE_FUNC Inverse(const XprType& xpr) : m_xpr(xpr) {} + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_xpr.cols(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_xpr.rows(); } + + EIGEN_DEVICE_FUNC const XprTypeNestedCleaned& nestedExpression() const { return m_xpr; } + + protected: + XprTypeNested m_xpr; +}; + +// Generic API dispatcher +template +class InverseImpl : public internal::generic_xpr_base >::type { + public: + typedef typename internal::generic_xpr_base >::type Base; + typedef typename XprType::Scalar Scalar; + + private: + Scalar coeff(Index row, Index col) const; + Scalar coeff(Index i) const; +}; + +namespace internal { + +/** \internal + * \brief Default evaluator for Inverse expression. + * + * This default evaluator for Inverse expression simply evaluate the inverse into a temporary + * by a call to internal::call_assignment_no_alias. + * Therefore, inverse implementers only have to specialize Assignment, ...> for + * there own nested expression. + * + * \sa class Inverse + */ +template +struct unary_evaluator > : public evaluator::PlainObject> { + typedef Inverse InverseType; + typedef typename InverseType::PlainObject PlainObject; + typedef evaluator Base; + + enum { Flags = Base::Flags | EvalBeforeNestingBit }; + + EIGEN_DEVICE_FUNC unary_evaluator(const InverseType& inv_xpr) : m_result(inv_xpr.rows(), inv_xpr.cols()) { + internal::construct_at(this, m_result); + internal::call_assignment_no_alias(m_result, inv_xpr); + } + + protected: + PlainObject m_result; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_INVERSE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Map.h b/src/3rdparty/eigen/Eigen/src/Core/Map.h new file mode 100644 index 0000000..c740da7 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Map.h @@ -0,0 +1,153 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MAP_H +#define EIGEN_MAP_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > : public traits { + typedef traits TraitsBase; + enum { + PlainObjectTypeInnerSize = ((traits::Flags & RowMajorBit) == RowMajorBit) + ? PlainObjectType::ColsAtCompileTime + : PlainObjectType::RowsAtCompileTime, + + InnerStrideAtCompileTime = StrideType::InnerStrideAtCompileTime == 0 + ? int(PlainObjectType::InnerStrideAtCompileTime) + : int(StrideType::InnerStrideAtCompileTime), + OuterStrideAtCompileTime = StrideType::OuterStrideAtCompileTime == 0 + ? (InnerStrideAtCompileTime == Dynamic || PlainObjectTypeInnerSize == Dynamic + ? Dynamic + : int(InnerStrideAtCompileTime) * int(PlainObjectTypeInnerSize)) + : int(StrideType::OuterStrideAtCompileTime), + Alignment = int(MapOptions) & int(AlignedMask), + Flags0 = TraitsBase::Flags & (~NestByRefBit), + Flags = is_lvalue::value ? int(Flags0) : (int(Flags0) & ~LvalueBit) + }; + + private: + enum { Options }; // Expressions don't have Options +}; +} // namespace internal + +/** \class Map + * \ingroup Core_Module + * + * \brief A matrix or vector expression mapping an existing array of data. + * + * \tparam PlainObjectType the equivalent matrix type of the mapped data + * \tparam MapOptions specifies the pointer alignment in bytes. It can be: \c #Aligned128, \c #Aligned64, \c #Aligned32, + * \c #Aligned16, \c #Aligned8 or \c #Unaligned. The default is \c #Unaligned. \tparam StrideType optionally specifies + * strides. By default, Map assumes the memory layout of an ordinary, contiguous array. This can be overridden by + * specifying strides. The type passed here must be a specialization of the Stride template, see examples below. + * + * This class represents a matrix or vector expression mapping an existing array of data. + * It can be used to let Eigen interface without any overhead with non-Eigen data structures, + * such as plain C arrays or structures from other libraries. By default, it assumes that the + * data is laid out contiguously in memory. You can however override this by explicitly specifying + * inner and outer strides. + * + * Here's an example of simply mapping a contiguous array as a \ref TopicStorageOrders "column-major" matrix: + * \include Map_simple.cpp + * Output: \verbinclude Map_simple.out + * + * If you need to map non-contiguous arrays, you can do so by specifying strides: + * + * Here's an example of mapping an array as a vector, specifying an inner stride, that is, the pointer + * increment between two consecutive coefficients. Here, we're specifying the inner stride as a compile-time + * fixed value. + * \include Map_inner_stride.cpp + * Output: \verbinclude Map_inner_stride.out + * + * Here's an example of mapping an array while specifying an outer stride. Here, since we're mapping + * as a column-major matrix, 'outer stride' means the pointer increment between two consecutive columns. + * Here, we're specifying the outer stride as a runtime parameter. Note that here \c OuterStride<> is + * a short version of \c OuterStride because the default template parameter of OuterStride + * is \c Dynamic + * \include Map_outer_stride.cpp + * Output: \verbinclude Map_outer_stride.out + * + * For more details and for an example of specifying both an inner and an outer stride, see class Stride. + * + * \b Tip: to change the array of data mapped by a Map object, you can use the C++ + * placement new syntax: + * + * Example: \include Map_placement_new.cpp + * Output: \verbinclude Map_placement_new.out + * + * This class is the return type of PlainObjectBase::Map() but can also be used directly. + * + * \sa PlainObjectBase::Map(), \ref TopicStorageOrders + */ +template +class Map : public MapBase > { + public: + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Map) + + typedef typename Base::PointerType PointerType; + typedef PointerType PointerArgType; + EIGEN_DEVICE_FUNC inline PointerType cast_to_pointer_type(PointerArgType ptr) { return ptr; } + + EIGEN_DEVICE_FUNC constexpr Index innerStride() const { + return StrideType::InnerStrideAtCompileTime != 0 ? m_stride.inner() : 1; + } + + EIGEN_DEVICE_FUNC constexpr Index outerStride() const { + return StrideType::OuterStrideAtCompileTime != 0 ? m_stride.outer() + : internal::traits::OuterStrideAtCompileTime != Dynamic + ? Index(internal::traits::OuterStrideAtCompileTime) + : IsVectorAtCompileTime ? (this->size() * innerStride()) + : int(Flags) & RowMajorBit ? (this->cols() * innerStride()) + : (this->rows() * innerStride()); + } + + /** Constructor in the fixed-size case. + * + * \param dataPtr pointer to the array to map + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC explicit inline Map(PointerArgType dataPtr, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr)), m_stride(stride) {} + + /** Constructor in the dynamic-size vector case. + * + * \param dataPtr pointer to the array to map + * \param size the size of the vector expression + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC inline Map(PointerArgType dataPtr, Index size, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr), size), m_stride(stride) {} + + /** Constructor in the dynamic-size matrix case. + * + * \param dataPtr pointer to the array to map + * \param rows the number of rows of the matrix expression + * \param cols the number of columns of the matrix expression + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC inline Map(PointerArgType dataPtr, Index rows, Index cols, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr), rows, cols), m_stride(stride) {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Map) + + protected: + StrideType m_stride; +}; + +} // end namespace Eigen + +#endif // EIGEN_MAP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/MapBase.h b/src/3rdparty/eigen/Eigen/src/Core/MapBase.h new file mode 100644 index 0000000..5e3d746 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/MapBase.h @@ -0,0 +1,283 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MAPBASE_H +#define EIGEN_MAPBASE_H + +#define EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) \ + EIGEN_STATIC_ASSERT((int(internal::evaluator::Flags) & LinearAccessBit) || Derived::IsVectorAtCompileTime, \ + YOU_ARE_TRYING_TO_USE_AN_INDEX_BASED_ACCESSOR_ON_AN_EXPRESSION_THAT_DOES_NOT_SUPPORT_THAT) + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \ingroup Core_Module + * + * \brief Base class for dense Map and Block expression with direct access + * + * This base class provides the const low-level accessors (e.g. coeff, coeffRef) of dense + * Map and Block objects with direct access. + * Typical users do not have to directly deal with this class. + * + * This class can be extended by through the macro plugin \c EIGEN_MAPBASE_PLUGIN. + * See \link TopicCustomizing_Plugins customizing Eigen \endlink for details. + * + * The \c Derived class has to provide the following two methods describing the memory layout: + * \code Index innerStride() const; \endcode + * \code Index outerStride() const; \endcode + * + * \sa class Map, class Block + */ +template +class MapBase : public internal::dense_xpr_base::type { + public: + typedef typename internal::dense_xpr_base::type Base; + enum { + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + InnerStrideAtCompileTime = internal::traits::InnerStrideAtCompileTime, + SizeAtCompileTime = Base::SizeAtCompileTime + }; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + typedef std::conditional_t::value), Scalar*, const Scalar*> PointerType; + + using Base::derived; + // using Base::RowsAtCompileTime; + // using Base::ColsAtCompileTime; + // using Base::SizeAtCompileTime; + using Base::Flags; + using Base::IsRowMajor; + using Base::IsVectorAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxSizeAtCompileTime; + + using Base::coeff; + using Base::coeffRef; + using Base::cols; + using Base::eval; + using Base::lazyAssign; + using Base::rows; + using Base::size; + + using Base::colStride; + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + + // bug 217 - compile error on ICC 11.1 + using Base::operator=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + + /** \copydoc DenseBase::rows() */ + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_rows.value(); } + /** \copydoc DenseBase::cols() */ + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_cols.value(); } + + /** Returns a pointer to the first coefficient of the matrix or vector. + * + * \note When addressing this data, make sure to honor the strides returned by innerStride() and outerStride(). + * + * \sa innerStride(), outerStride() + */ + EIGEN_DEVICE_FUNC constexpr const Scalar* data() const { return m_data; } + + /** \copydoc PlainObjectBase::coeff(Index,Index) const */ + EIGEN_DEVICE_FUNC inline const Scalar& coeff(Index rowId, Index colId) const { + return m_data[colId * colStride() + rowId * rowStride()]; + } + + /** \copydoc PlainObjectBase::coeff(Index) const */ + EIGEN_DEVICE_FUNC inline const Scalar& coeff(Index index) const { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return m_data[index * innerStride()]; + } + + /** \copydoc PlainObjectBase::coeffRef(Index,Index) const */ + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index rowId, Index colId) const { + return this->m_data[colId * colStride() + rowId * rowStride()]; + } + + /** \copydoc PlainObjectBase::coeffRef(Index) const */ + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index index) const { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return this->m_data[index * innerStride()]; + } + + /** \internal */ + template + inline PacketScalar packet(Index rowId, Index colId) const { + return internal::ploadt(m_data + (colId * colStride() + rowId * rowStride())); + } + + /** \internal */ + template + inline PacketScalar packet(Index index) const { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return internal::ploadt(m_data + index * innerStride()); + } + + /** \internal Constructor for fixed size matrices or vectors */ + EIGEN_DEVICE_FUNC explicit inline MapBase(PointerType dataPtr) + : m_data(dataPtr), m_rows(RowsAtCompileTime), m_cols(ColsAtCompileTime) { + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + checkSanity(); + } + + /** \internal Constructor for dynamically sized vectors */ + EIGEN_DEVICE_FUNC inline MapBase(PointerType dataPtr, Index vecSize) + : m_data(dataPtr), + m_rows(RowsAtCompileTime == Dynamic ? vecSize : Index(RowsAtCompileTime)), + m_cols(ColsAtCompileTime == Dynamic ? vecSize : Index(ColsAtCompileTime)) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + eigen_assert(vecSize >= 0); + eigen_assert(dataPtr == 0 || SizeAtCompileTime == Dynamic || SizeAtCompileTime == vecSize); + checkSanity(); + } + + /** \internal Constructor for dynamically sized matrices */ + EIGEN_DEVICE_FUNC inline MapBase(PointerType dataPtr, Index rows, Index cols) + : m_data(dataPtr), m_rows(rows), m_cols(cols) { + eigen_assert((dataPtr == 0) || (rows >= 0 && (RowsAtCompileTime == Dynamic || RowsAtCompileTime == rows) && + cols >= 0 && (ColsAtCompileTime == Dynamic || ColsAtCompileTime == cols))); + checkSanity(); + } + +#ifdef EIGEN_MAPBASE_PLUGIN +#include EIGEN_MAPBASE_PLUGIN +#endif + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MapBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MapBase) + + template + EIGEN_DEVICE_FUNC void checkSanity(std::enable_if_t<(internal::traits::Alignment > 0), void*> = 0) const { +// Temporary macro to allow scalars to not be properly aligned. This is while we sort out failures +// in TensorFlow Lite that are currently relying on this UB. +#ifndef EIGEN_ALLOW_UNALIGNED_SCALARS + // Pointer must be aligned to the Scalar type, otherwise we get UB. + eigen_assert((std::uintptr_t(m_data) % alignof(Scalar) == 0) && "data is not scalar-aligned"); +#endif +#if EIGEN_MAX_ALIGN_BYTES > 0 + // innerStride() is not set yet when this function is called, so we optimistically assume the lowest plausible + // value: + const Index minInnerStride = InnerStrideAtCompileTime == Dynamic ? 1 : Index(InnerStrideAtCompileTime); + EIGEN_ONLY_USED_FOR_DEBUG(minInnerStride); + eigen_assert((((std::uintptr_t(m_data) % internal::traits::Alignment) == 0) || + (cols() * rows() * minInnerStride * sizeof(Scalar)) < internal::traits::Alignment) && + "data is not aligned"); +#endif + } + + template + EIGEN_DEVICE_FUNC void checkSanity(std::enable_if_t::Alignment == 0, void*> = 0) const { +#ifndef EIGEN_ALLOW_UNALIGNED_SCALARS + // Pointer must be aligned to the Scalar type, otherwise we get UB. + eigen_assert((std::uintptr_t(m_data) % alignof(Scalar) == 0) && "data is not scalar-aligned"); +#endif + } + + PointerType m_data; + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; +}; + +/** \ingroup Core_Module + * + * \brief Base class for non-const dense Map and Block expression with direct access + * + * This base class provides the non-const low-level accessors (e.g. coeff and coeffRef) of + * dense Map and Block objects with direct access. + * It inherits MapBase which defines the const variant for reading specific entries. + * + * \sa class Map, class Block + */ +template +class MapBase : public MapBase { + typedef MapBase ReadOnlyMapBase; + + public: + typedef MapBase Base; + + typedef typename Base::Scalar Scalar; + typedef typename Base::PacketScalar PacketScalar; + typedef typename Base::StorageIndex StorageIndex; + typedef typename Base::PointerType PointerType; + + using Base::coeff; + using Base::coeffRef; + using Base::cols; + using Base::derived; + using Base::rows; + using Base::size; + + using Base::colStride; + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + + typedef std::conditional_t::value, Scalar, const Scalar> ScalarWithConstIfNotLvalue; + + EIGEN_DEVICE_FUNC constexpr const Scalar* data() const { return this->m_data; } + EIGEN_DEVICE_FUNC constexpr ScalarWithConstIfNotLvalue* data() { + return this->m_data; + } // no const-cast here so non-const-correct code will give a compile error + + EIGEN_DEVICE_FUNC inline ScalarWithConstIfNotLvalue& coeffRef(Index row, Index col) { + return this->m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC inline ScalarWithConstIfNotLvalue& coeffRef(Index index) { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return this->m_data[index * innerStride()]; + } + + template + inline void writePacket(Index row, Index col, const PacketScalar& val) { + internal::pstoret(this->m_data + (col * colStride() + row * rowStride()), val); + } + + template + inline void writePacket(Index index, const PacketScalar& val) { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + internal::pstoret(this->m_data + index * innerStride(), val); + } + + EIGEN_DEVICE_FUNC explicit inline MapBase(PointerType dataPtr) : Base(dataPtr) {} + EIGEN_DEVICE_FUNC inline MapBase(PointerType dataPtr, Index vecSize) : Base(dataPtr, vecSize) {} + EIGEN_DEVICE_FUNC inline MapBase(PointerType dataPtr, Index rows, Index cols) : Base(dataPtr, rows, cols) {} + + EIGEN_DEVICE_FUNC Derived& operator=(const MapBase& other) { + ReadOnlyMapBase::Base::operator=(other); + return derived(); + } + + // In theory we could simply refer to Base:Base::operator=, but MSVC does not like Base::Base, + // see bugs 821 and 920. + using ReadOnlyMapBase::Base::operator=; + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MapBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MapBase) +}; + +#undef EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS + +} // end namespace Eigen + +#endif // EIGEN_MAPBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/MathFunctions.h b/src/3rdparty/eigen/Eigen/src/Core/MathFunctions.h new file mode 100644 index 0000000..5e36ce8 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/MathFunctions.h @@ -0,0 +1,2103 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (c) 2021, NVIDIA CORPORATION. All rights reserved. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATHFUNCTIONS_H +#define EIGEN_MATHFUNCTIONS_H + +// TODO this should better be moved to NumTraits +// Source: WolframAlpha +#define EIGEN_PI 3.141592653589793238462643383279502884197169399375105820974944592307816406L +#define EIGEN_LOG2E 1.442695040888963407359924681001892137426645954152985934135449406931109219L +#define EIGEN_LN2 0.693147180559945309417232121458176568075500134360255254120680009493393621L + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +/** \internal \class global_math_functions_filtering_base + * + * What it does: + * Defines a typedef 'type' as follows: + * - if type T has a member typedef Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl, then + * global_math_functions_filtering_base::type is a typedef for it. + * - otherwise, global_math_functions_filtering_base::type is a typedef for T. + * + * How it's used: + * To allow to defined the global math functions (like sin...) in certain cases, like the Array expressions. + * When you do sin(array1+array2), the object array1+array2 has a complicated expression type, all what you want to know + * is that it inherits ArrayBase. So we implement a partial specialization of sin_impl for ArrayBase. + * So we must make sure to use sin_impl > and not sin_impl, otherwise our partial + * specialization won't be used. How does sin know that? That's exactly what global_math_functions_filtering_base tells + * it. + * + * How it's implemented: + * SFINAE in the style of enable_if. Highly susceptible of breaking compilers. With GCC, it sure does work, but if you + * replace the typename dummy by an integer template parameter, it doesn't work anymore! + */ + +template +struct global_math_functions_filtering_base { + typedef T type; +}; + +template +struct always_void { + typedef void type; +}; + +template +struct global_math_functions_filtering_base< + T, typename always_void::type> { + typedef typename T::Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl type; +}; + +#define EIGEN_MATHFUNC_IMPL(func, scalar) \ + Eigen::internal::func##_impl::type> +#define EIGEN_MATHFUNC_RETVAL(func, scalar) \ + typename Eigen::internal::func##_retval< \ + typename Eigen::internal::global_math_functions_filtering_base::type>::type + +/**************************************************************************** + * Implementation of real * + ****************************************************************************/ + +template ::IsComplex> +struct real_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { return x; } +}; + +template +struct real_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + using std::real; + return real(x); + } +}; + +template +struct real_impl : real_default_impl {}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct real_impl> { + typedef T RealScalar; + EIGEN_DEVICE_FUNC static inline T run(const std::complex& x) { return x.real(); } +}; +#endif + +template +struct real_retval { + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** + * Implementation of imag * + ****************************************************************************/ + +template ::IsComplex> +struct imag_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar&) { return RealScalar(0); } +}; + +template +struct imag_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + using std::imag; + return imag(x); + } +}; + +template +struct imag_impl : imag_default_impl {}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct imag_impl> { + typedef T RealScalar; + EIGEN_DEVICE_FUNC static inline T run(const std::complex& x) { return x.imag(); } +}; +#endif + +template +struct imag_retval { + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** + * Implementation of real_ref * + ****************************************************************************/ + +template +struct real_ref_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar& run(Scalar& x) { return reinterpret_cast(&x)[0]; } + EIGEN_DEVICE_FUNC static inline const RealScalar& run(const Scalar& x) { + return reinterpret_cast(&x)[0]; + } +}; + +template +struct real_ref_retval { + typedef typename NumTraits::Real& type; +}; + +/**************************************************************************** + * Implementation of imag_ref * + ****************************************************************************/ + +template +struct imag_ref_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar& run(Scalar& x) { return reinterpret_cast(&x)[1]; } + EIGEN_DEVICE_FUNC static inline const RealScalar& run(const Scalar& x) { + return reinterpret_cast(&x)[1]; + } +}; + +template +struct imag_ref_default_impl { + EIGEN_DEVICE_FUNC constexpr static Scalar run(Scalar&) { return Scalar(0); } + EIGEN_DEVICE_FUNC constexpr static const Scalar run(const Scalar&) { return Scalar(0); } +}; + +template +struct imag_ref_impl : imag_ref_default_impl::IsComplex> {}; + +template +struct imag_ref_retval { + typedef typename NumTraits::Real& type; +}; + +} // namespace internal + +namespace numext { + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(real, Scalar) real(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(real, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC inline internal::add_const_on_value_type_t real_ref( + const Scalar& x) { + return internal::real_ref_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(real_ref, Scalar) real_ref(Scalar& x) { + return EIGEN_MATHFUNC_IMPL(real_ref, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(imag, Scalar) imag(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(imag, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar select(const Scalar& mask, const Scalar& a, const Scalar& b) { + return numext::is_exactly_zero(mask) ? b : a; +} + +} // namespace numext + +namespace internal { + +/**************************************************************************** + * Implementation of conj * + ****************************************************************************/ + +template ::IsComplex> +struct conj_default_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) { return x; } +}; + +template +struct conj_default_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) { + using std::conj; + return conj(x); + } +}; + +template ::IsComplex> +struct conj_impl : conj_default_impl {}; + +template +struct conj_retval { + typedef Scalar type; +}; + +/**************************************************************************** + * Implementation of abs2 * + ****************************************************************************/ + +template +struct abs2_impl_default { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { return x * x; } +}; + +template +struct abs2_impl_default // IsComplex +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + return numext::real(x) * numext::real(x) + numext::imag(x) * numext::imag(x); + } +}; + +template +struct abs2_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + return abs2_impl_default::IsComplex>::run(x); + } +}; + +template +struct abs2_retval { + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** + * Implementation of sqrt/rsqrt * + ****************************************************************************/ + +template +struct sqrt_impl { + EIGEN_DEVICE_FUNC static EIGEN_ALWAYS_INLINE Scalar run(const Scalar& x) { + EIGEN_USING_STD(sqrt); + return sqrt(x); + } +}; + +// Complex sqrt defined in MathFunctionsImpl.h. +template +EIGEN_DEVICE_FUNC ComplexT complex_sqrt(const ComplexT& a_x); + +// Custom implementation is faster than `std::sqrt`, works on +// GPU, and correctly handles special cases (unlike MSVC). +template +struct sqrt_impl> { + EIGEN_DEVICE_FUNC static EIGEN_ALWAYS_INLINE std::complex run(const std::complex& x) { return complex_sqrt(x); } +}; + +template +struct sqrt_retval { + typedef Scalar type; +}; + +// Default implementation relies on numext::sqrt, at bottom of file. +template +struct rsqrt_impl; + +// Complex rsqrt defined in MathFunctionsImpl.h. +template +EIGEN_DEVICE_FUNC ComplexT complex_rsqrt(const ComplexT& a_x); + +template +struct rsqrt_impl> { + EIGEN_DEVICE_FUNC static EIGEN_ALWAYS_INLINE std::complex run(const std::complex& x) { + return complex_rsqrt(x); + } +}; + +template +struct rsqrt_retval { + typedef Scalar type; +}; + +/**************************************************************************** + * Implementation of norm1 * + ****************************************************************************/ + +template +struct norm1_default_impl; + +template +struct norm1_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + EIGEN_USING_STD(abs); + return abs(numext::real(x)) + abs(numext::imag(x)); + } +}; + +template +struct norm1_default_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) { + EIGEN_USING_STD(abs); + return abs(x); + } +}; + +template +struct norm1_impl : norm1_default_impl::IsComplex> {}; + +template +struct norm1_retval { + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** + * Implementation of hypot * + ****************************************************************************/ + +template +struct hypot_impl; + +template +struct hypot_retval { + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** + * Implementation of cast * + ****************************************************************************/ + +template +struct cast_impl { + EIGEN_DEVICE_FUNC static inline NewType run(const OldType& x) { return static_cast(x); } +}; + +template +struct cast_impl { + EIGEN_DEVICE_FUNC static inline bool run(const OldType& x) { return x != OldType(0); } +}; + +// Casting from S -> Complex leads to an implicit conversion from S to T, +// generating warnings on clang. Here we explicitly cast the real component. +template +struct cast_impl::IsComplex && NumTraits::IsComplex>> { + EIGEN_DEVICE_FUNC static inline NewType run(const OldType& x) { + typedef typename NumTraits::Real NewReal; + return static_cast(static_cast(x)); + } +}; + +// here, for once, we're plainly returning NewType: we don't want cast to do weird things. + +template +EIGEN_DEVICE_FUNC inline NewType cast(const OldType& x) { + return cast_impl::run(x); +} + +/**************************************************************************** + * Implementation of arg * + ****************************************************************************/ + +// Visual Studio 2017 has a bug where arg(float) returns 0 for negative inputs. +// This seems to be fixed in VS 2019. +#if (!EIGEN_COMP_MSVC || EIGEN_COMP_MSVC >= 1920) +// std::arg is only defined for types of std::complex, or integer types or float/double/long double +template ::IsComplex || is_integral::value || + is_same::value || is_same::value || + is_same::value> +struct arg_default_impl; + +template +struct arg_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + // There is no official ::arg on device in CUDA/HIP, so we always need to use std::arg. + using std::arg; + return static_cast(arg(x)); + } +}; + +// Must be non-complex floating-point type (e.g. half/bfloat16). +template +struct arg_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + return (x < Scalar(0)) ? RealScalar(EIGEN_PI) : RealScalar(0); + } +}; +#else +template ::IsComplex> +struct arg_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + return (x < RealScalar(0)) ? RealScalar(EIGEN_PI) : RealScalar(0); + } +}; + +template +struct arg_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC static inline RealScalar run(const Scalar& x) { + EIGEN_USING_STD(arg); + return arg(x); + } +}; +#endif +template +struct arg_impl : arg_default_impl {}; + +template +struct arg_retval { + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** + * Implementation of expm1 * + ****************************************************************************/ + +// This implementation is based on GSL Math's expm1. +namespace std_fallback { +// fallback expm1 implementation in case there is no expm1(Scalar) function in namespace of Scalar, +// or that there is no suitable std::expm1 function available. Implementation +// attributed to Kahan. See: http://www.plunk.org/~hatch/rightway.php. +template +EIGEN_DEVICE_FUNC inline Scalar expm1(const Scalar& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + typedef typename NumTraits::Real RealScalar; + + EIGEN_USING_STD(exp); + Scalar u = exp(x); + if (numext::equal_strict(u, Scalar(1))) { + return x; + } + Scalar um1 = u - RealScalar(1); + if (numext::equal_strict(um1, Scalar(-1))) { + return RealScalar(-1); + } + + EIGEN_USING_STD(log); + Scalar logu = log(u); + return numext::equal_strict(u, logu) ? u : (u - RealScalar(1)) * x / logu; +} +} // namespace std_fallback + +template +struct expm1_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + EIGEN_USING_STD(expm1); + return expm1(x); + } +}; + +template +struct expm1_retval { + typedef Scalar type; +}; + +/**************************************************************************** + * Implementation of log * + ****************************************************************************/ + +// Complex log defined in MathFunctionsImpl.h. +template +EIGEN_DEVICE_FUNC ComplexT complex_log(const ComplexT& z); + +template +struct log_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) { + EIGEN_USING_STD(log); + return static_cast(log(x)); + } +}; + +template +struct log_impl> { + EIGEN_DEVICE_FUNC static inline std::complex run(const std::complex& z) { return complex_log(z); } +}; + +/**************************************************************************** + * Implementation of log1p * + ****************************************************************************/ + +namespace std_fallback { +// fallback log1p implementation in case there is no log1p(Scalar) function in namespace of Scalar, +// or that there is no suitable std::log1p function available +template +EIGEN_DEVICE_FUNC inline Scalar log1p(const Scalar& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + typedef typename NumTraits::Real RealScalar; + EIGEN_USING_STD(log); + Scalar x1p = RealScalar(1) + x; + Scalar log_1p = log_impl::run(x1p); + const bool is_small = numext::equal_strict(x1p, Scalar(1)); + const bool is_inf = numext::equal_strict(x1p, log_1p); + return (is_small || is_inf) ? x : x * (log_1p / (x1p - RealScalar(1))); +} +} // namespace std_fallback + +template +struct log1p_impl { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) { + EIGEN_USING_STD(log1p); + return log1p(x); + } +}; + +// Specialization for complex types that are not supported by std::log1p. +template +struct log1p_impl> { + EIGEN_STATIC_ASSERT_NON_INTEGER(RealScalar) + + EIGEN_DEVICE_FUNC static inline std::complex run(const std::complex& x) { + return std_fallback::log1p(x); + } +}; + +template +struct log1p_retval { + typedef Scalar type; +}; + +/**************************************************************************** + * Implementation of pow * + ****************************************************************************/ + +template ::IsInteger && NumTraits::IsInteger> +struct pow_impl { + // typedef Scalar retval; + typedef typename ScalarBinaryOpTraits>::ReturnType + result_type; + static EIGEN_DEVICE_FUNC inline result_type run(const ScalarX& x, const ScalarY& y) { + EIGEN_USING_STD(pow); + return pow(x, y); + } +}; + +template +struct pow_impl { + typedef ScalarX result_type; + static EIGEN_DEVICE_FUNC inline ScalarX run(ScalarX x, ScalarY y) { + ScalarX res(1); + eigen_assert(!NumTraits::IsSigned || y >= 0); + if (y & 1) res *= x; + y >>= 1; + while (y) { + x *= x; + if (y & 1) res *= x; + y >>= 1; + } + return res; + } +}; + +enum { meta_floor_log2_terminate, meta_floor_log2_move_up, meta_floor_log2_move_down, meta_floor_log2_bogus }; + +template +struct meta_floor_log2_selector { + enum { + middle = (lower + upper) / 2, + value = (upper <= lower + 1) ? int(meta_floor_log2_terminate) + : (n < (1 << middle)) ? int(meta_floor_log2_move_down) + : (n == 0) ? int(meta_floor_log2_bogus) + : int(meta_floor_log2_move_up) + }; +}; + +template ::value> +struct meta_floor_log2 {}; + +template +struct meta_floor_log2 { + enum { value = meta_floor_log2::middle>::value }; +}; + +template +struct meta_floor_log2 { + enum { value = meta_floor_log2::middle, upper>::value }; +}; + +template +struct meta_floor_log2 { + enum { value = (n >= ((unsigned int)(1) << (lower + 1))) ? lower + 1 : lower }; +}; + +template +struct meta_floor_log2 { + // no value, error at compile time +}; + +template +struct count_bits_impl { + static_assert(std::is_integral::value && std::is_unsigned::value, + "BitsType must be an unsigned integer"); + static EIGEN_DEVICE_FUNC inline int clz(BitsType bits) { + int n = CHAR_BIT * sizeof(BitsType); + int shift = n / 2; + while (bits > 0 && shift > 0) { + BitsType y = bits >> shift; + if (y > 0) { + n -= shift; + bits = y; + } + shift /= 2; + } + if (shift == 0) { + --n; + } + return n; + } + + static EIGEN_DEVICE_FUNC inline int ctz(BitsType bits) { + int n = CHAR_BIT * sizeof(BitsType); + int shift = n / 2; + while (bits > 0 && shift > 0) { + BitsType y = bits << shift; + if (y > 0) { + n -= shift; + bits = y; + } + shift /= 2; + } + if (shift == 0) { + --n; + } + return n; + } +}; + +// Count leading zeros. +template +EIGEN_DEVICE_FUNC inline int clz(BitsType bits) { + return count_bits_impl::clz(bits); +} + +// Count trailing zeros. +template +EIGEN_DEVICE_FUNC inline int ctz(BitsType bits) { + return count_bits_impl::ctz(bits); +} + +#if EIGEN_COMP_GNUC || EIGEN_COMP_CLANG + +template +struct count_bits_impl< + BitsType, std::enable_if_t::value && sizeof(BitsType) <= sizeof(unsigned int)>> { + static constexpr int kNumBits = static_cast(sizeof(BitsType) * CHAR_BIT); + static EIGEN_DEVICE_FUNC inline int clz(BitsType bits) { + static constexpr int kLeadingBitsOffset = (sizeof(unsigned int) - sizeof(BitsType)) * CHAR_BIT; + return bits == 0 ? kNumBits : __builtin_clz(static_cast(bits)) - kLeadingBitsOffset; + } + + static EIGEN_DEVICE_FUNC inline int ctz(BitsType bits) { + return bits == 0 ? kNumBits : __builtin_ctz(static_cast(bits)); + } +}; + +template +struct count_bits_impl::value && sizeof(unsigned int) < sizeof(BitsType) && + sizeof(BitsType) <= sizeof(unsigned long)>> { + static constexpr int kNumBits = static_cast(sizeof(BitsType) * CHAR_BIT); + static EIGEN_DEVICE_FUNC inline int clz(BitsType bits) { + static constexpr int kLeadingBitsOffset = (sizeof(unsigned long) - sizeof(BitsType)) * CHAR_BIT; + return bits == 0 ? kNumBits : __builtin_clzl(static_cast(bits)) - kLeadingBitsOffset; + } + + static EIGEN_DEVICE_FUNC inline int ctz(BitsType bits) { + return bits == 0 ? kNumBits : __builtin_ctzl(static_cast(bits)); + } +}; + +template +struct count_bits_impl::value && sizeof(unsigned long) < sizeof(BitsType) && + sizeof(BitsType) <= sizeof(unsigned long long)>> { + static constexpr int kNumBits = static_cast(sizeof(BitsType) * CHAR_BIT); + static EIGEN_DEVICE_FUNC inline int clz(BitsType bits) { + static constexpr int kLeadingBitsOffset = (sizeof(unsigned long long) - sizeof(BitsType)) * CHAR_BIT; + return bits == 0 ? kNumBits : __builtin_clzll(static_cast(bits)) - kLeadingBitsOffset; + } + + static EIGEN_DEVICE_FUNC inline int ctz(BitsType bits) { + return bits == 0 ? kNumBits : __builtin_ctzll(static_cast(bits)); + } +}; + +#elif EIGEN_COMP_MSVC + +template +struct count_bits_impl< + BitsType, std::enable_if_t::value && sizeof(BitsType) <= sizeof(unsigned long)>> { + static constexpr int kNumBits = static_cast(sizeof(BitsType) * CHAR_BIT); + static EIGEN_DEVICE_FUNC inline int clz(BitsType bits) { + unsigned long out; + _BitScanReverse(&out, static_cast(bits)); + return bits == 0 ? kNumBits : (kNumBits - 1) - static_cast(out); + } + + static EIGEN_DEVICE_FUNC inline int ctz(BitsType bits) { + unsigned long out; + _BitScanForward(&out, static_cast(bits)); + return bits == 0 ? kNumBits : static_cast(out); + } +}; + +#ifdef _WIN64 + +template +struct count_bits_impl::value && sizeof(unsigned long) < sizeof(BitsType) && + sizeof(BitsType) <= sizeof(__int64)>> { + static constexpr int kNumBits = static_cast(sizeof(BitsType) * CHAR_BIT); + static EIGEN_DEVICE_FUNC inline int clz(BitsType bits) { + unsigned long out; + _BitScanReverse64(&out, static_cast(bits)); + return bits == 0 ? kNumBits : (kNumBits - 1) - static_cast(out); + } + + static EIGEN_DEVICE_FUNC inline int ctz(BitsType bits) { + unsigned long out; + _BitScanForward64(&out, static_cast(bits)); + return bits == 0 ? kNumBits : static_cast(out); + } +}; + +#endif // _WIN64 + +#endif // EIGEN_COMP_GNUC || EIGEN_COMP_CLANG + +template +struct log_2_impl { + static constexpr int kTotalBits = sizeof(BitsType) * CHAR_BIT; + static EIGEN_DEVICE_FUNC inline int run_ceil(const BitsType& x) { + const int n = kTotalBits - clz(x); + bool power_of_two = (x & (x - 1)) == 0; + return x == 0 ? 0 : power_of_two ? (n - 1) : n; + } + static EIGEN_DEVICE_FUNC inline int run_floor(const BitsType& x) { + const int n = kTotalBits - clz(x); + return x == 0 ? 0 : n - 1; + } +}; + +template +int log2_ceil(const BitsType& x) { + return log_2_impl::run_ceil(x); +} + +template +int log2_floor(const BitsType& x) { + return log_2_impl::run_floor(x); +} + +// Implementation of is* functions + +template +EIGEN_DEVICE_FUNC std::enable_if_t::has_infinity || std::numeric_limits::has_quiet_NaN || + std::numeric_limits::has_signaling_NaN), + bool> +isfinite_impl(const T&) { + return true; +} + +template +EIGEN_DEVICE_FUNC std::enable_if_t<(std::numeric_limits::has_infinity || std::numeric_limits::has_quiet_NaN || + std::numeric_limits::has_signaling_NaN) && + (!NumTraits::IsComplex), + bool> +isfinite_impl(const T& x) { + EIGEN_USING_STD(isfinite); + return isfinite EIGEN_NOT_A_MACRO(x); +} + +template +EIGEN_DEVICE_FUNC std::enable_if_t::has_infinity, bool> isinf_impl(const T&) { + return false; +} + +template +EIGEN_DEVICE_FUNC std::enable_if_t<(std::numeric_limits::has_infinity && !NumTraits::IsComplex), bool> isinf_impl( + const T& x) { + EIGEN_USING_STD(isinf); + return isinf EIGEN_NOT_A_MACRO(x); +} + +template +EIGEN_DEVICE_FUNC +std::enable_if_t::has_quiet_NaN || std::numeric_limits::has_signaling_NaN), bool> +isnan_impl(const T&) { + return false; +} + +template +EIGEN_DEVICE_FUNC std::enable_if_t< + (std::numeric_limits::has_quiet_NaN || std::numeric_limits::has_signaling_NaN) && (!NumTraits::IsComplex), + bool> +isnan_impl(const T& x) { + EIGEN_USING_STD(isnan); + return isnan EIGEN_NOT_A_MACRO(x); +} + +// The following overload are defined at the end of this file +template +EIGEN_DEVICE_FUNC bool isfinite_impl(const std::complex& x); +template +EIGEN_DEVICE_FUNC bool isnan_impl(const std::complex& x); +template +EIGEN_DEVICE_FUNC bool isinf_impl(const std::complex& x); +template +EIGEN_DEFINE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS T ptanh_float(const T& a_x); + +/**************************************************************************** + * Implementation of sign * + ****************************************************************************/ +template ::IsComplex != 0), + bool IsInteger = (NumTraits::IsInteger != 0)> +struct sign_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& a) { return Scalar((a > Scalar(0)) - (a < Scalar(0))); } +}; + +template +struct sign_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& a) { + return (isnan_impl)(a) ? a : Scalar((a > Scalar(0)) - (a < Scalar(0))); + } +}; + +template +struct sign_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& a) { + using real_type = typename NumTraits::Real; + EIGEN_USING_STD(abs); + real_type aa = abs(a); + if (aa == real_type(0)) return Scalar(0); + aa = real_type(1) / aa; + return Scalar(numext::real(a) * aa, numext::imag(a) * aa); + } +}; + +// The sign function for bool is the identity. +template <> +struct sign_impl { + EIGEN_DEVICE_FUNC static inline bool run(const bool& a) { return a; } +}; + +template +struct sign_retval { + typedef Scalar type; +}; + +// suppress "unary minus operator applied to unsigned type, result still unsigned" warnings on MSVC +// note: `0 - a` is distinct from `-a` when Scalar is a floating point type and `a` is zero + +template ::IsInteger> +struct negate_impl { + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Scalar run(const Scalar& a) { return -a; } +}; + +template +struct negate_impl { + EIGEN_STATIC_ASSERT((!is_same::value), NEGATE IS NOT DEFINED FOR BOOLEAN TYPES) + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Scalar run(const Scalar& a) { return Scalar(0) - a; } +}; + +template +struct negate_retval { + typedef Scalar type; +}; + +template ::type>::IsInteger> +struct nearest_integer_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_floor(const Scalar& x) { + EIGEN_USING_STD(floor) return floor(x); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_ceil(const Scalar& x) { + EIGEN_USING_STD(ceil) return ceil(x); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_rint(const Scalar& x) { + EIGEN_USING_STD(rint) return rint(x); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_round(const Scalar& x) { + EIGEN_USING_STD(round) return round(x); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_trunc(const Scalar& x) { + EIGEN_USING_STD(trunc) return trunc(x); + } +}; +template +struct nearest_integer_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_floor(const Scalar& x) { return x; } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_ceil(const Scalar& x) { return x; } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_rint(const Scalar& x) { return x; } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_round(const Scalar& x) { return x; } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run_trunc(const Scalar& x) { return x; } +}; + +// Extra namespace to prevent leaking std::fma into Eigen::internal. +namespace has_fma_detail { + +template +struct has_fma_impl : public std::false_type {}; + +using std::fma; + +template +struct has_fma_impl< + T, std::enable_if_t(), std::declval(), std::declval()))>::value>> + : public std::true_type {}; + +} // namespace has_fma_detail + +template +struct has_fma : public has_fma_detail::has_fma_impl {}; + +// Default implementation. +template +struct fma_impl { + static_assert(has_fma::value, "No function fma(...) for type. Please provide an implementation."); +}; + +// STD or ADL version if it exists. +template +struct fma_impl::value>> { + static EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T run(const T& a, const T& b, const T& c) { + using std::fma; + return fma(a, b, c); + } +}; + +#if defined(EIGEN_GPUCC) +template <> +struct has_fma : public true_type {}; + +template <> +struct fma_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE float run(const float& a, const float& b, const float& c) { + return ::fmaf(a, b, c); + } +}; + +template <> +struct has_fma : public true_type {}; + +template <> +struct fma_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE double run(const double& a, const double& b, const double& c) { + return ::fma(a, b, c); + } +}; +#endif + +// Basic multiply-add. +template +struct madd_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run(const Scalar& x, const Scalar& y, const Scalar& z) { + return x * y + z; + } +}; + +#if EIGEN_SCALAR_MADD_USE_FMA +template +struct madd_impl::value>> { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar run(const Scalar& x, const Scalar& y, const Scalar& z) { + return fma_impl::run(x, y, z); + } +}; +#endif + +} // end namespace internal + +/**************************************************************************** + * Generic math functions * + ****************************************************************************/ + +namespace numext { + +#if (!defined(EIGEN_GPUCC) || defined(EIGEN_CONSTEXPR_ARE_DEVICE_FUNC)) +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T mini(const T& x, const T& y) { + EIGEN_USING_STD(min) + return min EIGEN_NOT_A_MACRO(x, y); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T maxi(const T& x, const T& y) { + EIGEN_USING_STD(max) + return max EIGEN_NOT_A_MACRO(x, y); +} +#else +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T mini(const T& x, const T& y) { + return y < x ? y : x; +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float mini(const float& x, const float& y) { + return fminf(x, y); +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double mini(const double& x, const double& y) { + return fmin(x, y); +} + +#ifndef EIGEN_GPU_COMPILE_PHASE +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE long double mini(const long double& x, const long double& y) { +#if defined(EIGEN_HIPCC) + // no "fminl" on HIP yet + return (x < y) ? x : y; +#else + return fminl(x, y); +#endif +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T maxi(const T& x, const T& y) { + return x < y ? y : x; +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float maxi(const float& x, const float& y) { + return fmaxf(x, y); +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double maxi(const double& x, const double& y) { + return fmax(x, y); +} +#ifndef EIGEN_GPU_COMPILE_PHASE +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE long double maxi(const long double& x, const long double& y) { +#if defined(EIGEN_HIPCC) + // no "fmaxl" on HIP yet + return (x > y) ? x : y; +#else + return fmaxl(x, y); +#endif +} +#endif +#endif + +#if defined(SYCL_DEVICE_ONLY) + +#define SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_char) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_short) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_int) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_long) +#define SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_char) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_short) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_int) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_long) +#define SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_uchar) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_ushort) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_uint) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_ulong) +#define SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_uchar) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_ushort) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_uint) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_ulong) +#define SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) +#define SYCL_SPECIALIZE_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) +#define SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_double) +#define SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_double) +#define SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(NAME, FUNC, RET_TYPE) \ + SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, cl::sycl::cl_double) + +#define SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE) \ + template <> \ + EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE RET_TYPE NAME(const ARG_TYPE& x) { \ + return cl::sycl::FUNC(x); \ + } + +#define SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, TYPE) SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, TYPE, TYPE) + +#define SYCL_SPECIALIZE_GEN1_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE1, ARG_TYPE2) \ + template <> \ + EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE RET_TYPE NAME(const ARG_TYPE1& x, const ARG_TYPE2& y) { \ + return cl::sycl::FUNC(x, y); \ + } + +#define SYCL_SPECIALIZE_GEN2_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE) \ + SYCL_SPECIALIZE_GEN1_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE, ARG_TYPE) + +#define SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, TYPE) SYCL_SPECIALIZE_GEN2_BINARY_FUNC(NAME, FUNC, TYPE, TYPE) + +SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(mini, min) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(mini, fmin) +SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(maxi, max) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(maxi, fmax) + +#endif + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(arg, Scalar) arg(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(arg, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC inline internal::add_const_on_value_type_t imag_ref( + const Scalar& x) { + return internal::imag_ref_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(imag_ref, Scalar) imag_ref(Scalar& x) { + return EIGEN_MATHFUNC_IMPL(imag_ref, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(conj, Scalar) conj(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(conj, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(sign, Scalar) sign(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(sign, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(negate, Scalar) negate(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(negate, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(abs2, Scalar) abs2(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(abs2, Scalar)::run(x); +} + +EIGEN_DEVICE_FUNC inline bool abs2(bool x) { return x; } + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T absdiff(const T& x, const T& y) { + return x > y ? x - y : y - x; +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float absdiff(const float& x, const float& y) { + return fabsf(x - y); +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double absdiff(const double& x, const double& y) { + return fabs(x - y); +} + +// HIP and CUDA do not support long double. +#ifndef EIGEN_GPU_COMPILE_PHASE +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE long double absdiff(const long double& x, const long double& y) { + return fabsl(x - y); +} +#endif + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(norm1, Scalar) norm1(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(norm1, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(hypot, Scalar) hypot(const Scalar& x, const Scalar& y) { + return EIGEN_MATHFUNC_IMPL(hypot, Scalar)::run(x, y); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(hypot, hypot) +#endif + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(log1p, Scalar) log1p(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(log1p, Scalar)::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(log1p, log1p) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float log1p(const float& x) { + return ::log1pf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double log1p(const double& x) { + return ::log1p(x); +} +#endif + +template +EIGEN_DEVICE_FUNC inline typename internal::pow_impl::result_type pow(const ScalarX& x, + const ScalarY& y) { + return internal::pow_impl::run(x, y); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(pow, pow) +#endif + +template +EIGEN_DEVICE_FUNC bool(isnan)(const T& x) { + return internal::isnan_impl(x); +} +template +EIGEN_DEVICE_FUNC bool(isinf)(const T& x) { + return internal::isinf_impl(x); +} +template +EIGEN_DEVICE_FUNC bool(isfinite)(const T& x) { + return internal::isfinite_impl(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isnan, isnan, bool) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isinf, isinf, bool) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isfinite, isfinite, bool) +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar rint(const Scalar& x) { + return internal::nearest_integer_impl::run_rint(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar round(const Scalar& x) { + return internal::nearest_integer_impl::run_round(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar(floor)(const Scalar& x) { + return internal::nearest_integer_impl::run_floor(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar(ceil)(const Scalar& x) { + return internal::nearest_integer_impl::run_ceil(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar(trunc)(const Scalar& x) { + return internal::nearest_integer_impl::run_trunc(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(round, round) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(floor, floor) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(ceil, ceil) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(trunc, trunc) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float floor(const float& x) { + return ::floorf(x); +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double floor(const double& x) { + return ::floor(x); +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float ceil(const float& x) { + return ::ceilf(x); +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double ceil(const double& x) { + return ::ceil(x); +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float trunc(const float& x) { + return ::truncf(x); +} +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double trunc(const double& x) { + return ::trunc(x); +} +#endif + +// Integer division with rounding up. +// T is assumed to be an integer type with a>=0, and b>0 +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE constexpr T div_ceil(T a, T b) { + using UnsignedT = typename internal::make_unsigned::type; + EIGEN_STATIC_ASSERT((NumTraits::IsInteger), THIS FUNCTION IS FOR INTEGER TYPES) + // Note: explicitly declaring a and b as non-negative values allows the compiler to use better optimizations + const UnsignedT ua = UnsignedT(a); + const UnsignedT ub = UnsignedT(b); + // Note: This form is used because it cannot overflow. + return ua == 0 ? 0 : (ua - 1) / ub + 1; +} + +// Integer round down to nearest power of b +// T is assumed to be an integer type with a>=0, and b>0 +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE constexpr T round_down(T a, U b) { + using UnsignedT = typename internal::make_unsigned::type; + using UnsignedU = typename internal::make_unsigned::type; + EIGEN_STATIC_ASSERT((NumTraits::IsInteger), THIS FUNCTION IS FOR INTEGER TYPES) + EIGEN_STATIC_ASSERT((NumTraits::IsInteger), THIS FUNCTION IS FOR INTEGER TYPES) + // Note: explicitly declaring a and b as non-negative values allows the compiler to use better optimizations + const UnsignedT ua = UnsignedT(a); + const UnsignedU ub = UnsignedU(b); + return ub * (ua / ub); +} + +/** Log base 2 for 32 bits positive integers. + * Conveniently returns 0 for x==0. */ +constexpr int log2(int x) { + unsigned int v(x); + constexpr int table[32] = {0, 9, 1, 10, 13, 21, 2, 29, 11, 14, 16, 18, 22, 25, 3, 30, + 8, 12, 20, 28, 15, 17, 24, 7, 19, 27, 23, 6, 26, 5, 4, 31}; + v |= v >> 1; + v |= v >> 2; + v |= v >> 4; + v |= v >> 8; + v |= v >> 16; + return table[(v * 0x07C4ACDDU) >> 27]; +} + +/** \returns the square root of \a x. + * + * It is essentially equivalent to + * \code using std::sqrt; return sqrt(x); \endcode + * but slightly faster for float/double and some compilers (e.g., gcc), thanks to + * specializations when SSE is enabled. + * + * It's usage is justified in performance critical functions, like norm/normalize. + */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE EIGEN_MATHFUNC_RETVAL(sqrt, Scalar) sqrt(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(sqrt, Scalar)::run(x); +} + +// Boolean specialization, avoids implicit float to bool conversion (-Wimplicit-conversion-floating-point-to-bool). +template <> +EIGEN_DEFINE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS EIGEN_DEVICE_FUNC bool sqrt(const bool& x) { + return x; +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sqrt, sqrt) +#endif + +/** \returns the cube root of \a x. **/ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE std::enable_if_t::IsComplex, T> cbrt(const T& x) { + EIGEN_USING_STD(cbrt); + return static_cast(cbrt(x)); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE std::enable_if_t::IsComplex, T> cbrt(const T& x) { + EIGEN_USING_STD(pow); + return pow(x, typename NumTraits::Real(1.0 / 3.0)); +} + +/** \returns the reciprocal square root of \a x. **/ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T rsqrt(const T& x) { + return internal::rsqrt_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T log(const T& x) { + return internal::log_impl::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(log, log) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float log(const float& x) { + return ::logf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double log(const double& x) { + return ::log(x); +} +#endif + +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE std::enable_if_t::IsSigned || NumTraits::IsComplex, typename NumTraits::Real> +abs(const T& x) { + EIGEN_USING_STD(abs); + return abs(x); +} + +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE std::enable_if_t::IsSigned || NumTraits::IsComplex), typename NumTraits::Real> +abs(const T& x) { + return x; +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_INTEGER_TYPES_UNARY(abs, abs) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(abs, fabs) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float abs(const float& x) { + return ::fabsf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double abs(const double& x) { + return ::fabs(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float abs(const std::complex& x) { + return ::hypotf(x.real(), x.imag()); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double abs(const std::complex& x) { + return ::hypot(x.real(), x.imag()); +} +#endif + +template ::IsInteger, bool IsSigned = NumTraits::IsSigned> +struct signbit_impl; +template +struct signbit_impl { + static constexpr size_t Size = sizeof(Scalar); + static constexpr size_t Shift = (CHAR_BIT * Size) - 1; + using intSize_t = typename get_integer_by_size::signed_type; + EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE static Scalar run(const Scalar& x) { + intSize_t a = bit_cast(x); + a = a >> Shift; + Scalar result = bit_cast(a); + return result; + } +}; +template +struct signbit_impl { + static constexpr size_t Size = sizeof(Scalar); + static constexpr size_t Shift = (CHAR_BIT * Size) - 1; + EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE static constexpr Scalar run(const Scalar& x) { return x >> Shift; } +}; +template +struct signbit_impl { + EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE static constexpr Scalar run(const Scalar&) { return Scalar(0); } +}; +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE static constexpr Scalar signbit(const Scalar& x) { + return signbit_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T exp(const T& x) { + EIGEN_USING_STD(exp); + return exp(x); +} + +// MSVC screws up some edge-cases for std::exp(complex). +#ifdef EIGEN_COMP_MSVC +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE std::complex exp(const std::complex& x) { + EIGEN_USING_STD(exp); + // If z is (x,±∞) (for any finite x), the result is (NaN,NaN) and FE_INVALID is raised. + // If z is (x,NaN) (for any finite x), the result is (NaN,NaN) and FE_INVALID may be raised. + if ((isfinite)(real_ref(x)) && !(isfinite)(imag_ref(x))) { + return std::complex(NumTraits::quiet_NaN(), NumTraits::quiet_NaN()); + } + // If z is (+∞,±∞), the result is (±∞,NaN) and FE_INVALID is raised (the sign of the real part is unspecified) + // If z is (+∞,NaN), the result is (±∞,NaN) (the sign of the real part is unspecified) + if ((real_ref(x) == NumTraits::infinity() && !(isfinite)(imag_ref(x)))) { + return std::complex(NumTraits::infinity(), NumTraits::quiet_NaN()); + } + return exp(x); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(exp, exp) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float exp(const float& x) { + return ::expf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double exp(const double& x) { + return ::exp(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE std::complex exp(const std::complex& x) { + float com = ::expf(x.real()); + float res_real = com * ::cosf(x.imag()); + float res_imag = com * ::sinf(x.imag()); + return std::complex(res_real, res_imag); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE std::complex exp(const std::complex& x) { + double com = ::exp(x.real()); + double res_real = com * ::cos(x.imag()); + double res_imag = com * ::sin(x.imag()); + return std::complex(res_real, res_imag); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T exp2(const T& x) { + EIGEN_USING_STD(exp2); + return exp2(x); +} + +// MSVC screws up some edge-cases for std::exp2(complex). +#ifdef EIGEN_COMP_MSVC +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE std::complex exp2(const std::complex& x) { + EIGEN_USING_STD(exp); + // If z is (x,±∞) (for any finite x), the result is (NaN,NaN) and FE_INVALID is raised. + // If z is (x,NaN) (for any finite x), the result is (NaN,NaN) and FE_INVALID may be raised. + if ((isfinite)(real_ref(x)) && !(isfinite)(imag_ref(x))) { + return std::complex(NumTraits::quiet_NaN(), NumTraits::quiet_NaN()); + } + // If z is (+∞,±∞), the result is (±∞,NaN) and FE_INVALID is raised (the sign of the real part is unspecified) + // If z is (+∞,NaN), the result is (±∞,NaN) (the sign of the real part is unspecified) + if ((real_ref(x) == NumTraits::infinity() && !(isfinite)(imag_ref(x)))) { + return std::complex(NumTraits::infinity(), NumTraits::quiet_NaN()); + } + return exp2(x); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(exp2, exp2) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float exp2(const float& x) { + return ::exp2f(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double exp2(const double& x) { + return ::exp2(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE std::complex exp2(const std::complex& x) { + float com = ::exp2f(x.real()); + float res_real = com * ::cosf(static_cast(EIGEN_LN2) * x.imag()); + float res_imag = com * ::sinf(static_cast(EIGEN_LN2) * x.imag()); + return std::complex(res_real, res_imag); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE std::complex exp2(const std::complex& x) { + double com = ::exp2(x.real()); + double res_real = com * ::cos(static_cast(EIGEN_LN2) * x.imag()); + double res_imag = com * ::sin(static_cast(EIGEN_LN2) * x.imag()); + return std::complex(res_real, res_imag); +} +#endif + +template +EIGEN_DEVICE_FUNC inline EIGEN_MATHFUNC_RETVAL(expm1, Scalar) expm1(const Scalar& x) { + return EIGEN_MATHFUNC_IMPL(expm1, Scalar)::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(expm1, expm1) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float expm1(const float& x) { + return ::expm1f(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double expm1(const double& x) { + return ::expm1(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T cos(const T& x) { + EIGEN_USING_STD(cos); + return cos(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(cos, cos) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float cos(const float& x) { + return ::cosf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double cos(const double& x) { + return ::cos(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T sin(const T& x) { + EIGEN_USING_STD(sin); + return sin(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sin, sin) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float sin(const float& x) { + return ::sinf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double sin(const double& x) { + return ::sin(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T tan(const T& x) { + EIGEN_USING_STD(tan); + return tan(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(tan, tan) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float tan(const float& x) { + return ::tanf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double tan(const double& x) { + return ::tan(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T acos(const T& x) { + EIGEN_USING_STD(acos); + return acos(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T acosh(const T& x) { + EIGEN_USING_STD(acosh); + return static_cast(acosh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(acos, acos) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(acosh, acosh) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float acos(const float& x) { + return ::acosf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double acos(const double& x) { + return ::acos(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T asin(const T& x) { + EIGEN_USING_STD(asin); + return asin(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T asinh(const T& x) { + EIGEN_USING_STD(asinh); + return static_cast(asinh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(asin, asin) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(asinh, asinh) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float asin(const float& x) { + return ::asinf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double asin(const double& x) { + return ::asin(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T atan(const T& x) { + EIGEN_USING_STD(atan); + return static_cast(atan(x)); +} + +template ::IsComplex, int> = 0> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T atan2(const T& y, const T& x) { + EIGEN_USING_STD(atan2); + return static_cast(atan2(y, x)); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T atanh(const T& x) { + EIGEN_USING_STD(atanh); + return static_cast(atanh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(atan, atan) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(atanh, atanh) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float atan(const float& x) { + return ::atanf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double atan(const double& x) { + return ::atan(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T cosh(const T& x) { + EIGEN_USING_STD(cosh); + return static_cast(cosh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(cosh, cosh) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float cosh(const float& x) { + return ::coshf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double cosh(const double& x) { + return ::cosh(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T sinh(const T& x) { + EIGEN_USING_STD(sinh); + return static_cast(sinh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sinh, sinh) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float sinh(const float& x) { + return ::sinhf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double sinh(const double& x) { + return ::sinh(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T tanh(const T& x) { + EIGEN_USING_STD(tanh); + return tanh(x); +} + +#if (!defined(EIGEN_GPUCC)) && EIGEN_FAST_MATH && !defined(SYCL_DEVICE_ONLY) +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float tanh(float x) { return internal::ptanh_float(x); } +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(tanh, tanh) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float tanh(const float& x) { + return ::tanhf(x); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double tanh(const double& x) { + return ::tanh(x); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE T fmod(const T& a, const T& b) { + EIGEN_USING_STD(fmod); + return fmod(a, b); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(fmod, fmod) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE float fmod(const float& a, const float& b) { + return ::fmodf(a, b); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE double fmod(const double& a, const double& b) { + return ::fmod(a, b); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +#undef SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_BINARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_UNARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE +#undef SYCL_SPECIALIZE_GEN_UNARY_FUNC +#undef SYCL_SPECIALIZE_UNARY_FUNC +#undef SYCL_SPECIALIZE_GEN1_BINARY_FUNC +#undef SYCL_SPECIALIZE_GEN2_BINARY_FUNC +#undef SYCL_SPECIALIZE_BINARY_FUNC +#endif + +template ::value>> +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar logical_shift_left(const Scalar& a, int n) { + return a << n; +} + +template ::value>> +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar logical_shift_right(const Scalar& a, int n) { + using UnsignedScalar = typename numext::get_integer_by_size::unsigned_type; + return bit_cast(bit_cast(a) >> n); +} + +template ::value>> +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar arithmetic_shift_right(const Scalar& a, int n) { + using SignedScalar = typename numext::get_integer_by_size::signed_type; + return bit_cast(bit_cast(a) >> n); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar fma(const Scalar& x, const Scalar& y, const Scalar& z) { + return internal::fma_impl::run(x, y, z); +} + +// Multiply-add. +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar madd(const Scalar& x, const Scalar& y, const Scalar& z) { + return internal::madd_impl::run(x, y, z); +} + +} // end namespace numext + +namespace internal { + +template +EIGEN_DEVICE_FUNC bool isfinite_impl(const std::complex& x) { + return (numext::isfinite)(numext::real(x)) && (numext::isfinite)(numext::imag(x)); +} + +template +EIGEN_DEVICE_FUNC bool isnan_impl(const std::complex& x) { + return (numext::isnan)(numext::real(x)) || (numext::isnan)(numext::imag(x)); +} + +template +EIGEN_DEVICE_FUNC bool isinf_impl(const std::complex& x) { + return ((numext::isinf)(numext::real(x)) || (numext::isinf)(numext::imag(x))) && (!(numext::isnan)(x)); +} + +/**************************************************************************** + * Implementation of fuzzy comparisons * + ****************************************************************************/ + +template +struct scalar_fuzzy_default_impl {}; + +template +struct scalar_fuzzy_default_impl { + typedef typename NumTraits::Real RealScalar; + template + EIGEN_DEVICE_FUNC static inline bool isMuchSmallerThan(const Scalar& x, const OtherScalar& y, + const RealScalar& prec) { + return numext::abs(x) <= numext::abs(y) * prec; + } + EIGEN_DEVICE_FUNC static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar& prec) { + return numext::abs(x - y) <= numext::mini(numext::abs(x), numext::abs(y)) * prec; + } + EIGEN_DEVICE_FUNC static inline bool isApproxOrLessThan(const Scalar& x, const Scalar& y, const RealScalar& prec) { + return x <= y || isApprox(x, y, prec); + } +}; + +template +struct scalar_fuzzy_default_impl { + typedef typename NumTraits::Real RealScalar; + template + EIGEN_DEVICE_FUNC static inline bool isMuchSmallerThan(const Scalar& x, const Scalar&, const RealScalar&) { + return x == Scalar(0); + } + EIGEN_DEVICE_FUNC static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar&) { return x == y; } + EIGEN_DEVICE_FUNC static inline bool isApproxOrLessThan(const Scalar& x, const Scalar& y, const RealScalar&) { + return x <= y; + } +}; + +template +struct scalar_fuzzy_default_impl { + typedef typename NumTraits::Real RealScalar; + template + EIGEN_DEVICE_FUNC static inline bool isMuchSmallerThan(const Scalar& x, const OtherScalar& y, + const RealScalar& prec) { + return numext::abs2(x) <= numext::abs2(y) * prec * prec; + } + EIGEN_DEVICE_FUNC static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar& prec) { + return numext::abs2(x - y) <= numext::mini(numext::abs2(x), numext::abs2(y)) * prec * prec; + } +}; + +template +struct scalar_fuzzy_impl + : scalar_fuzzy_default_impl::IsComplex, NumTraits::IsInteger> {}; + +template +EIGEN_DEVICE_FUNC inline bool isMuchSmallerThan( + const Scalar& x, const OtherScalar& y, + const typename NumTraits::Real& precision = NumTraits::dummy_precision()) { + return scalar_fuzzy_impl::template isMuchSmallerThan(x, y, precision); +} + +template +EIGEN_DEVICE_FUNC inline bool isApprox( + const Scalar& x, const Scalar& y, + const typename NumTraits::Real& precision = NumTraits::dummy_precision()) { + return scalar_fuzzy_impl::isApprox(x, y, precision); +} + +template +EIGEN_DEVICE_FUNC inline bool isApproxOrLessThan( + const Scalar& x, const Scalar& y, + const typename NumTraits::Real& precision = NumTraits::dummy_precision()) { + return scalar_fuzzy_impl::isApproxOrLessThan(x, y, precision); +} + +/****************************************** +*** The special case of the bool type *** +******************************************/ + +template <> +struct scalar_fuzzy_impl { + typedef bool RealScalar; + + template + EIGEN_DEVICE_FUNC static inline bool isMuchSmallerThan(const bool& x, const bool&, const bool&) { + return !x; + } + + EIGEN_DEVICE_FUNC static inline bool isApprox(bool x, bool y, bool) { return x == y; } + + EIGEN_DEVICE_FUNC static inline bool isApproxOrLessThan(const bool& x, const bool& y, const bool&) { + return (!x) || y; + } +}; + +} // end namespace internal + +// Default implementations that rely on other numext implementations +namespace internal { + +// Specialization for complex types that are not supported by std::expm1. +template +struct expm1_impl> { + EIGEN_STATIC_ASSERT_NON_INTEGER(RealScalar) + + EIGEN_DEVICE_FUNC static inline std::complex run(const std::complex& x) { + RealScalar xr = x.real(); + RealScalar xi = x.imag(); + // expm1(z) = exp(z) - 1 + // = exp(x + i * y) - 1 + // = exp(x) * (cos(y) + i * sin(y)) - 1 + // = exp(x) * cos(y) - 1 + i * exp(x) * sin(y) + // Imag(expm1(z)) = exp(x) * sin(y) + // Real(expm1(z)) = exp(x) * cos(y) - 1 + // = exp(x) * cos(y) - 1. + // = expm1(x) + exp(x) * (cos(y) - 1) + // = expm1(x) + exp(x) * (2 * sin(y / 2) ** 2) + RealScalar erm1 = numext::expm1(xr); + RealScalar er = erm1 + RealScalar(1.); + RealScalar sin2 = numext::sin(xi / RealScalar(2.)); + sin2 = sin2 * sin2; + RealScalar s = numext::sin(xi); + RealScalar real_part = erm1 - RealScalar(2.) * er * sin2; + return std::complex(real_part, er * s); + } +}; + +template +struct rsqrt_impl { + EIGEN_DEVICE_FUNC static EIGEN_ALWAYS_INLINE T run(const T& x) { return T(1) / numext::sqrt(x); } +}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct conj_impl, true> { + EIGEN_DEVICE_FUNC static inline std::complex run(const std::complex& x) { + return std::complex(numext::real(x), -numext::imag(x)); + } +}; +#endif + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_MATHFUNCTIONS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/MathFunctionsImpl.h b/src/3rdparty/eigen/Eigen/src/Core/MathFunctionsImpl.h new file mode 100644 index 0000000..c4b5da3 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/MathFunctionsImpl.h @@ -0,0 +1,263 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2014 Pedro Gonnet (pedro.gonnet@gmail.com) +// Copyright (C) 2016 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATHFUNCTIONSIMPL_H +#define EIGEN_MATHFUNCTIONSIMPL_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +/** \internal Fast reciprocal using Newton-Raphson's method. + + Preconditions: + 1. The starting guess provided in approx_a_recip must have at least half + the leading mantissa bits in the correct result, such that a single + Newton-Raphson step is sufficient to get within 1-2 ulps of the correct + result. + 2. If a is zero, approx_a_recip must be infinite with the same sign as a. + 3. If a is infinite, approx_a_recip must be zero with the same sign as a. + + If the preconditions are satisfied, which they are for the _*_rcp_ps + instructions on x86, the result has a maximum relative error of 2 ulps, + and correctly handles reciprocals of zero, infinity, and NaN. +*/ +template +struct generic_reciprocal_newton_step { + static_assert(Steps > 0, "Steps must be at least 1."); + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Packet run(const Packet& a, const Packet& approx_a_recip) { + using Scalar = typename unpacket_traits::type; + const Packet two = pset1(Scalar(2)); + // Refine the approximation using one Newton-Raphson step: + // x_{i} = x_{i-1} * (2 - a * x_{i-1}) + const Packet x = generic_reciprocal_newton_step::run(a, approx_a_recip); + const Packet tmp = pnmadd(a, x, two); + // If tmp is NaN, it means that a is either +/-0 or +/-Inf. + // In this case return the approximation directly. + const Packet is_not_nan = pcmp_eq(tmp, tmp); + return pselect(is_not_nan, pmul(x, tmp), x); + } +}; + +template +struct generic_reciprocal_newton_step { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Packet run(const Packet& /*unused*/, const Packet& approx_rsqrt) { + return approx_rsqrt; + } +}; + +/** \internal Fast reciprocal sqrt using Newton-Raphson's method. + + Preconditions: + 1. The starting guess provided in approx_a_recip must have at least half + the leading mantissa bits in the correct result, such that a single + Newton-Raphson step is sufficient to get within 1-2 ulps of the correct + result. + 2. If a is zero, approx_a_recip must be infinite with the same sign as a. + 3. If a is infinite, approx_a_recip must be zero with the same sign as a. + + If the preconditions are satisfied, which they are for the _*_rcp_ps + instructions on x86, the result has a maximum relative error of 2 ulps, + and correctly handles zero, infinity, and NaN. Positive denormals are + treated as zero. +*/ +template +struct generic_rsqrt_newton_step { + static_assert(Steps > 0, "Steps must be at least 1."); + using Scalar = typename unpacket_traits::type; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Packet run(const Packet& a, const Packet& approx_rsqrt) { + const Scalar kMinusHalf = Scalar(-1) / Scalar(2); + const Packet cst_minus_half = pset1(kMinusHalf); + const Packet cst_minus_one = pset1(Scalar(-1)); + + Packet inv_sqrt = approx_rsqrt; + for (int step = 0; step < Steps; ++step) { + // Refine the approximation using one Newton-Raphson step: + // h_n = (x * inv_sqrt) * inv_sqrt - 1 (so that h_n is nearly 0). + // inv_sqrt = inv_sqrt - 0.5 * inv_sqrt * h_n + Packet r2 = pmul(a, inv_sqrt); + Packet half_r = pmul(inv_sqrt, cst_minus_half); + Packet h_n = pmadd(r2, inv_sqrt, cst_minus_one); + inv_sqrt = pmadd(half_r, h_n, inv_sqrt); + } + + // If x is NaN, then either: + // 1) the input is NaN + // 2) zero and infinity were multiplied + // In either of these cases, return approx_rsqrt + return pselect(pisnan(inv_sqrt), approx_rsqrt, inv_sqrt); + } +}; + +template +struct generic_rsqrt_newton_step { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Packet run(const Packet& /*unused*/, const Packet& approx_rsqrt) { + return approx_rsqrt; + } +}; + +/** \internal Fast sqrt using Newton-Raphson's method. + + Preconditions: + 1. The starting guess for the reciprocal sqrt provided in approx_rsqrt must + have at least half the leading mantissa bits in the correct result, such + that a single Newton-Raphson step is sufficient to get within 1-2 ulps of + the correct result. + 2. If a is zero, approx_rsqrt must be infinite. + 3. If a is infinite, approx_rsqrt must be zero. + + If the preconditions are satisfied, which they are for the _*_rsqrt_ps + instructions on x86, the result has a maximum relative error of 2 ulps, + and correctly handles zero and infinity, and NaN. Positive denormal inputs + are treated as zero. +*/ +template +struct generic_sqrt_newton_step { + static_assert(Steps > 0, "Steps must be at least 1."); + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Packet run(const Packet& a, const Packet& approx_rsqrt) { + using Scalar = typename unpacket_traits::type; + const Packet one_point_five = pset1(Scalar(1.5)); + const Packet minus_half = pset1(Scalar(-0.5)); + // If a is inf or zero, return a directly. + const Packet inf_mask = pcmp_eq(a, pset1(NumTraits::infinity())); + const Packet return_a = por(pcmp_eq(a, pzero(a)), inf_mask); + // Do a single step of Newton's iteration for reciprocal square root: + // x_{n+1} = x_n * (1.5 + (-0.5 * x_n) * (a * x_n))). + // The Newton's step is computed this way to avoid over/under-flows. + Packet rsqrt = pmul(approx_rsqrt, pmadd(pmul(minus_half, approx_rsqrt), pmul(a, approx_rsqrt), one_point_five)); + for (int step = 1; step < Steps; ++step) { + rsqrt = pmul(rsqrt, pmadd(pmul(minus_half, rsqrt), pmul(a, rsqrt), one_point_five)); + } + + // Return sqrt(x) = x * rsqrt(x) for non-zero finite positive arguments. + // Return a itself for 0 or +inf, NaN for negative arguments. + return pselect(return_a, a, pmul(a, rsqrt)); + } +}; + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE RealScalar positive_real_hypot(const RealScalar& x, const RealScalar& y) { + // IEEE IEC 6059 special cases. + if ((numext::isinf)(x) || (numext::isinf)(y)) return NumTraits::infinity(); + if ((numext::isnan)(x) || (numext::isnan)(y)) return NumTraits::quiet_NaN(); + + EIGEN_USING_STD(sqrt); + RealScalar p, qp; + p = numext::maxi(x, y); + if (numext::is_exactly_zero(p)) return RealScalar(0); + qp = numext::mini(y, x) / p; + return p * sqrt(RealScalar(1) + qp * qp); +} + +template +struct hypot_impl { + typedef typename NumTraits::Real RealScalar; + static EIGEN_DEVICE_FUNC inline RealScalar run(const Scalar& x, const Scalar& y) { + EIGEN_USING_STD(abs); + return positive_real_hypot(abs(x), abs(y)); + } +}; + +// Generic complex sqrt implementation that correctly handles corner cases +// according to https://en.cppreference.com/w/cpp/numeric/complex/sqrt +template +EIGEN_DEVICE_FUNC ComplexT complex_sqrt(const ComplexT& z) { + // Computes the principal sqrt of the input. + // + // For a complex square root of the number x + i*y. We want to find real + // numbers u and v such that + // (u + i*v)^2 = x + i*y <=> + // u^2 - v^2 + i*2*u*v = x + i*v. + // By equating the real and imaginary parts we get: + // u^2 - v^2 = x + // 2*u*v = y. + // + // For x >= 0, this has the numerically stable solution + // u = sqrt(0.5 * (x + sqrt(x^2 + y^2))) + // v = y / (2 * u) + // and for x < 0, + // v = sign(y) * sqrt(0.5 * (-x + sqrt(x^2 + y^2))) + // u = y / (2 * v) + // + // Letting w = sqrt(0.5 * (|x| + |z|)), + // if x == 0: u = w, v = sign(y) * w + // if x > 0: u = w, v = y / (2 * w) + // if x < 0: u = |y| / (2 * w), v = sign(y) * w + using T = typename NumTraits::Real; + const T x = numext::real(z); + const T y = numext::imag(z); + const T zero = T(0); + const T w = numext::sqrt(T(0.5) * (numext::abs(x) + numext::hypot(x, y))); + + return (numext::isinf)(y) ? ComplexT(NumTraits::infinity(), y) + : numext::is_exactly_zero(x) ? ComplexT(w, y < zero ? -w : w) + : x > zero ? ComplexT(w, y / (2 * w)) + : ComplexT(numext::abs(y) / (2 * w), y < zero ? -w : w); +} + +// Generic complex rsqrt implementation. +template +EIGEN_DEVICE_FUNC ComplexT complex_rsqrt(const ComplexT& z) { + // Computes the principal reciprocal sqrt of the input. + // + // For a complex reciprocal square root of the number z = x + i*y. We want to + // find real numbers u and v such that + // (u + i*v)^2 = 1 / (x + i*y) <=> + // u^2 - v^2 + i*2*u*v = x/|z|^2 - i*v/|z|^2. + // By equating the real and imaginary parts we get: + // u^2 - v^2 = x/|z|^2 + // 2*u*v = y/|z|^2. + // + // For x >= 0, this has the numerically stable solution + // u = sqrt(0.5 * (x + |z|)) / |z| + // v = -y / (2 * u * |z|) + // and for x < 0, + // v = -sign(y) * sqrt(0.5 * (-x + |z|)) / |z| + // u = -y / (2 * v * |z|) + // + // Letting w = sqrt(0.5 * (|x| + |z|)), + // if x == 0: u = w / |z|, v = -sign(y) * w / |z| + // if x > 0: u = w / |z|, v = -y / (2 * w * |z|) + // if x < 0: u = |y| / (2 * w * |z|), v = -sign(y) * w / |z| + using T = typename NumTraits::Real; + const T x = numext::real(z); + const T y = numext::imag(z); + const T zero = T(0); + + const T abs_z = numext::hypot(x, y); + const T w = numext::sqrt(T(0.5) * (numext::abs(x) + abs_z)); + const T woz = w / abs_z; + // Corner cases consistent with 1/sqrt(z) on gcc/clang. + return numext::is_exactly_zero(abs_z) ? ComplexT(NumTraits::infinity(), NumTraits::quiet_NaN()) + : ((numext::isinf)(x) || (numext::isinf)(y)) ? ComplexT(zero, zero) + : numext::is_exactly_zero(x) ? ComplexT(woz, y < zero ? woz : -woz) + : x > zero ? ComplexT(woz, -y / (2 * w * abs_z)) + : ComplexT(numext::abs(y) / (2 * w * abs_z), y < zero ? woz : -woz); +} + +template +EIGEN_DEVICE_FUNC ComplexT complex_log(const ComplexT& z) { + // Computes complex log. + using T = typename NumTraits::Real; + T a = numext::abs(z); + EIGEN_USING_STD(atan2); + T b = atan2(z.imag(), z.real()); + return ComplexT(numext::log(a), b); +} + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_MATHFUNCTIONSIMPL_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Matrix.h b/src/3rdparty/eigen/Eigen/src/Core/Matrix.h new file mode 100644 index 0000000..a2c8eba --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Matrix.h @@ -0,0 +1,534 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (C) 2008-2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIX_H +#define EIGEN_MATRIX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits> { + private: + constexpr static int size = internal::size_at_compile_time(Rows_, Cols_); + typedef typename find_best_packet::type PacketScalar; + enum { + row_major_bit = Options_ & RowMajor ? RowMajorBit : 0, + is_dynamic_size_storage = MaxRows_ == Dynamic || MaxCols_ == Dynamic, + max_size = is_dynamic_size_storage ? Dynamic : MaxRows_ * MaxCols_, + default_alignment = compute_default_alignment::value, + actual_alignment = ((Options_ & DontAlign) == 0) ? default_alignment : 0, + required_alignment = unpacket_traits::alignment, + packet_access_bit = (packet_traits::Vectorizable && + (EIGEN_UNALIGNED_VECTORIZE || (int(actual_alignment) >= int(required_alignment)))) + ? PacketAccessBit + : 0 + }; + + public: + typedef Scalar_ Scalar; + typedef Dense StorageKind; + typedef Eigen::Index StorageIndex; + typedef MatrixXpr XprKind; + enum { + RowsAtCompileTime = Rows_, + ColsAtCompileTime = Cols_, + MaxRowsAtCompileTime = MaxRows_, + MaxColsAtCompileTime = MaxCols_, + Flags = compute_matrix_flags(Options_), + Options = Options_, + InnerStrideAtCompileTime = 1, + OuterStrideAtCompileTime = (int(Options) & int(RowMajor)) ? ColsAtCompileTime : RowsAtCompileTime, + + // FIXME, the following flag in only used to define NeedsToAlign in PlainObjectBase + EvaluatorFlags = LinearAccessBit | DirectAccessBit | packet_access_bit | row_major_bit, + Alignment = actual_alignment + }; +}; +} // namespace internal + +/** \class Matrix + * \ingroup Core_Module + * + * \brief The matrix class, also used for vectors and row-vectors + * + * The %Matrix class is the work-horse for all \em dense (\ref dense "note") matrices and vectors within Eigen. + * Vectors are matrices with one column, and row-vectors are matrices with one row. + * + * The %Matrix class encompasses \em both fixed-size and dynamic-size objects (\ref fixedsize "note"). + * + * The first three template parameters are required: + * \tparam Scalar_ Numeric type, e.g. float, double, int or std::complex. + * User defined scalar types are supported as well (see \ref user_defined_scalars "here"). + * \tparam Rows_ Number of rows, or \b Dynamic + * \tparam Cols_ Number of columns, or \b Dynamic + * + * The remaining template parameters are optional -- in most cases you don't have to worry about them. + * \tparam Options_ A combination of either \b #RowMajor or \b #ColMajor, and of either + * \b #AutoAlign or \b #DontAlign. + * The former controls \ref TopicStorageOrders "storage order", and defaults to column-major. The latter + * controls alignment, which is required for vectorization. It defaults to aligning matrices except for fixed sizes that + * aren't a multiple of the packet size. \tparam MaxRows_ Maximum number of rows. Defaults to \a Rows_ (\ref maxrows + * "note"). \tparam MaxCols_ Maximum number of columns. Defaults to \a Cols_ (\ref maxrows "note"). + * + * Eigen provides a number of typedefs covering the usual cases. Here are some examples: + * + * \li \c Matrix2d is a 2x2 square matrix of doubles (\c Matrix) + * \li \c Vector4f is a vector of 4 floats (\c Matrix) + * \li \c RowVector3i is a row-vector of 3 ints (\c Matrix) + * + * \li \c MatrixXf is a dynamic-size matrix of floats (\c Matrix) + * \li \c VectorXf is a dynamic-size vector of floats (\c Matrix) + * + * \li \c Matrix2Xf is a partially fixed-size (dynamic-size) matrix of floats (\c Matrix) + * \li \c MatrixX3d is a partially dynamic-size (fixed-size) matrix of double (\c Matrix) + * + * See \link matrixtypedefs this page \endlink for a complete list of predefined \em %Matrix and \em Vector typedefs. + * + * You can access elements of vectors and matrices using normal subscripting: + * + * \code + * Eigen::VectorXd v(10); + * v[0] = 0.1; + * v[1] = 0.2; + * v(0) = 0.3; + * v(1) = 0.4; + * + * Eigen::MatrixXi m(10, 10); + * m(0, 1) = 1; + * m(0, 2) = 2; + * m(0, 3) = 3; + * \endcode + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_MATRIX_PLUGIN. + * + * Some notes: + * + *

+ *
\anchor dense Dense versus sparse:
+ *
This %Matrix class handles dense, not sparse matrices and vectors. For sparse matrices and vectors, see the + * Sparse module. + * + * Dense matrices and vectors are plain usual arrays of coefficients. All the coefficients are stored, in an ordinary + * contiguous array. This is unlike Sparse matrices and vectors where the coefficients are stored as a list of nonzero + * coefficients.
+ * + *
\anchor fixedsize Fixed-size versus dynamic-size:
+ *
Fixed-size means that the numbers of rows and columns are known at compile-time. In this case, Eigen allocates + * the array of coefficients as a fixed-size array, as a class member. This makes sense for very small matrices, + * typically up to 4x4, sometimes up to 16x16. Larger matrices should be declared as dynamic-size even if one happens to + * know their size at compile-time. + * + * Dynamic-size means that the numbers of rows or columns are not necessarily known at compile-time. In this case they + * are runtime variables, and the array of coefficients is allocated dynamically on the heap. + * + * Note that \em dense matrices, be they Fixed-size or Dynamic-size, do not expand dynamically in the sense of + * a std::map. If you want this behavior, see the Sparse module.
+ * + *
\anchor maxrows MaxRows_ and MaxCols_:
+ *
In most cases, one just leaves these parameters to the default values. + * These parameters mean the maximum size of rows and columns that the matrix may have. They are useful in cases + * when the exact numbers of rows and columns are not known at compile-time, but it is known at compile-time that they + * cannot exceed a certain value. This happens when taking dynamic-size blocks inside fixed-size matrices: in this case + * MaxRows_ and MaxCols_ are the dimensions of the original matrix, while Rows_ and Cols_ are Dynamic.
+ *
+ * + * ABI and storage layout + * + * The table below summarizes the ABI of some possible Matrix instances which is fixed thorough the lifetime of Eigen 3. + * + * + * + * + * + * + *
Matrix typeEquivalent C structure
\code Matrix \endcode\code + * struct { + * T *data; // with (size_t(data)%EIGEN_MAX_ALIGN_BYTES)==0 + * Eigen::Index rows, cols; + * }; + * \endcode
\code + * Matrix + * Matrix \endcode\code + * struct { + * T *data; // with (size_t(data)%EIGEN_MAX_ALIGN_BYTES)==0 + * Eigen::Index size; + * }; + * \endcode
\code Matrix \endcode\code + * struct { + * T data[Rows*Cols]; // with (size_t(data)%A(Rows*Cols*sizeof(T)))==0 + * }; + * \endcode
\code Matrix \endcode\code + * struct { + * T data[MaxRows*MaxCols]; // with (size_t(data)%A(MaxRows*MaxCols*sizeof(T)))==0 + * Eigen::Index rows, cols; + * }; + * \endcode
+ * Note that in this table Rows, Cols, MaxRows and MaxCols are all positive integers. A(S) is defined to the largest + * possible power-of-two smaller to EIGEN_MAX_STATIC_ALIGN_BYTES. + * + * \see MatrixBase for the majority of the API methods for matrices, \ref TopicClassHierarchy, + * \ref TopicStorageOrders + */ + +template +class Matrix : public PlainObjectBase> { + public: + /** \brief Base class typedef. + * \sa PlainObjectBase + */ + typedef PlainObjectBase Base; + + enum { Options = Options_ }; + + EIGEN_DENSE_PUBLIC_INTERFACE(Matrix) + + typedef typename Base::PlainObject PlainObject; + + using Base::base; + using Base::coeffRef; + + /** + * \brief Assigns matrices to each other. + * + * \note This is a special case of the templated operator=. Its purpose is + * to prevent a default operator= from hiding the templated operator=. + * + * \callgraph + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Matrix& operator=(const Matrix& other) { return Base::_set(other); } + + /** \internal + * \brief Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Matrix& operator=(const DenseBase& other) { + return Base::_set(other); + } + + /** + * \brief Copies the generic expression \a other into *this. + * \copydetails DenseBase::operator=(const EigenBase &other) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Matrix& operator=(const EigenBase& other) { + return Base::operator=(other); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Matrix& operator=(const ReturnByValue& func) { + return Base::operator=(func); + } + + /** \brief Default constructor. + * + * For fixed-size matrices, does nothing. + * + * For dynamic-size matrices, creates an empty matrix of size 0. Does not allocate any array. Such a matrix + * is called a null matrix. This constructor is the unique way to create null matrices: resizing + * a matrix to 0 is not supported. + * + * \sa resize(Index,Index) + */ +#if defined(EIGEN_INITIALIZE_COEFFS) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Matrix() { EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED } +#else + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Matrix() = default; +#endif + /** \brief Move constructor */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Matrix(Matrix&&) = default; + /** \brief Moves the matrix into the other one. + * + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Matrix& operator=(Matrix&& other) noexcept( + std::is_nothrow_move_assignable::value) { + Base::operator=(std::move(other)); + return *this; + } + + /** \brief Construct a row of column vector with fixed size from an arbitrary number of coefficients. + * + * \only_for_vectors + * + * This constructor is for 1D array or vectors with more than 4 coefficients. + * + * \warning To construct a column (resp. row) vector of fixed length, the number of values passed to this + * constructor must match the the fixed number of rows (resp. columns) of \c *this. + * + * + * Example: \include Matrix_variadic_ctor_cxx11.cpp + * Output: \verbinclude Matrix_variadic_ctor_cxx11.out + * + * \sa Matrix(const std::initializer_list>&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Matrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, + const ArgTypes&... args) + : Base(a0, a1, a2, a3, args...) {} + + /** \brief Constructs a Matrix and initializes it from the coefficients given as initializer-lists grouped by row. + * \cpp11 + * \anchor matrix_initializer_list + * + * In the general case, the constructor takes a list of rows, each row being represented as a list of coefficients: + * + * Example: \include Matrix_initializer_list_23_cxx11.cpp + * Output: \verbinclude Matrix_initializer_list_23_cxx11.out + * + * Each of the inner initializer lists must contain the exact same number of elements, otherwise an assertion is + * triggered. + * + * In the case of a compile-time column vector, implicit transposition from a single row is allowed. + * Therefore VectorXd{{1,2,3,4,5}} is legal and the more verbose syntax + * RowVectorXd{{1},{2},{3},{4},{5}} can be avoided: + * + * Example: \include Matrix_initializer_list_vector_cxx11.cpp + * Output: \verbinclude Matrix_initializer_list_vector_cxx11.out + * + * In the case of fixed-sized matrices, the initializer list sizes must exactly match the matrix sizes, + * and implicit transposition is allowed for compile-time vectors only. + * + * \sa Matrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC explicit constexpr EIGEN_STRONG_INLINE Matrix( + const std::initializer_list>& list) + : Base(list) {} + +#ifndef EIGEN_PARSED_BY_DOXYGEN + + // This constructor is for both 1x1 matrices and dynamic vectors + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit Matrix(const T& x) { + Base::template _init1(x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Matrix(const T0& x, const T1& y) { + Base::template _init2(x, y); + } + +#else + /** \brief Constructs a fixed-sized matrix initialized with coefficients starting at \a data */ + EIGEN_DEVICE_FUNC explicit Matrix(const Scalar* data); + + /** \brief Constructs a vector or row-vector with given dimension. \only_for_vectors + * + * This is useful for dynamic-size vectors. For fixed-size vectors, + * it is redundant to pass these parameters, so one should use the default constructor + * Matrix() instead. + * + * \warning This constructor is disabled for fixed-size \c 1x1 matrices. For instance, + * calling Matrix(1) will call the initialization constructor: Matrix(const Scalar&). + * For fixed-size \c 1x1 matrices it is therefore recommended to use the default + * constructor Matrix() instead, especially when using one of the non standard + * \c EIGEN_INITIALIZE_MATRICES_BY_{ZERO,\c NAN} macros (see \ref TopicPreprocessorDirectives). + */ + EIGEN_STRONG_INLINE explicit Matrix(Index dim); + /** \brief Constructs an initialized 1x1 matrix with the given coefficient + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) */ + Matrix(const Scalar& x); + /** \brief Constructs an uninitialized matrix with \a rows rows and \a cols columns. + * + * This is useful for dynamic-size matrices. For fixed-size matrices, + * it is redundant to pass these parameters, so one should use the default constructor + * Matrix() instead. + * + * \warning This constructor is disabled for fixed-size \c 1x2 and \c 2x1 vectors. For instance, + * calling Matrix2f(2,1) will call the initialization constructor: Matrix(const Scalar& x, const Scalar& y). + * For fixed-size \c 1x2 or \c 2x1 vectors it is therefore recommended to use the default + * constructor Matrix() instead, especially when using one of the non standard + * \c EIGEN_INITIALIZE_MATRICES_BY_{ZERO,\c NAN} macros (see \ref TopicPreprocessorDirectives). + */ + EIGEN_DEVICE_FUNC Matrix(Index rows, Index cols); + + /** \brief Constructs an initialized 2D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) */ + Matrix(const Scalar& x, const Scalar& y); +#endif // end EIGEN_PARSED_BY_DOXYGEN + + /** \brief Constructs an initialized 3D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Matrix(const Scalar& x, const Scalar& y, const Scalar& z) { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Matrix, 3) + m_storage.data()[0] = x; + m_storage.data()[1] = y; + m_storage.data()[2] = z; + } + /** \brief Constructs an initialized 4D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Matrix(const Scalar& x, const Scalar& y, const Scalar& z, const Scalar& w) { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Matrix, 4) + m_storage.data()[0] = x; + m_storage.data()[1] = y; + m_storage.data()[2] = z; + m_storage.data()[3] = w; + } + + /** \brief Copy constructor */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Matrix(const Matrix&) = default; + + /** \brief Copy constructor for generic expressions. + * \sa MatrixBase::operator=(const EigenBase&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Matrix(const EigenBase& other) : Base(other.derived()) {} + + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return 1; } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return this->innerSize(); } + + /////////// Geometry module /////////// + + template + EIGEN_DEVICE_FUNC explicit Matrix(const RotationBase& r); + template + EIGEN_DEVICE_FUNC Matrix& operator=(const RotationBase& r); + +// allow to extend Matrix outside Eigen +#ifdef EIGEN_MATRIX_PLUGIN +#include EIGEN_MATRIX_PLUGIN +#endif + + protected: + template + friend struct internal::conservative_resize_like_impl; + + using Base::m_storage; +}; + +/** \defgroup matrixtypedefs Global matrix typedefs + * + * \ingroup Core_Module + * + * %Eigen defines several typedef shortcuts for most common matrix and vector types. + * + * The general patterns are the following: + * + * \c MatrixSizeType where \c Size can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for dynamic size, + * and where \c Type can be \c i for integer, \c f for float, \c d for double, \c cf for complex float, \c cd + * for complex double. + * + * For example, \c Matrix3d is a fixed-size 3x3 matrix type of doubles, and \c MatrixXf is a dynamic-size matrix of + * floats. + * + * There are also \c VectorSizeType and \c RowVectorSizeType which are self-explanatory. For example, \c Vector4cf is + * a fixed-size vector of 4 complex floats. + * + * With \cpp11, template alias are also defined for common sizes. + * They follow the same pattern as above except that the scalar type suffix is replaced by a + * template parameter, i.e.: + * - `MatrixSize` where `Size` can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for dynamic size. + * - `MatrixXSize` and `MatrixSizeX` where `Size` can be \c 2,\c 3,\c 4 for hybrid dynamic/fixed matrices. + * - `VectorSize` and `RowVectorSize` for column and row vectors. + * + * With \cpp11, you can also use fully generic column and row vector types: `Vector` and + * `RowVector`. + * + * \sa class Matrix + */ + +#define EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, Size, SizeSuffix) \ + /** \ingroup matrixtypedefs */ \ + /** \brief `Size`×`Size` matrix of type `Type`. */ \ + typedef Matrix Matrix##SizeSuffix##TypeSuffix; \ + /** \ingroup matrixtypedefs */ \ + /** \brief `Size`×`1` vector of type `Type`. */ \ + typedef Matrix Vector##SizeSuffix##TypeSuffix; \ + /** \ingroup matrixtypedefs */ \ + /** \brief `1`×`Size` vector of type `Type`. */ \ + typedef Matrix RowVector##SizeSuffix##TypeSuffix; + +#define EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, Size) \ + /** \ingroup matrixtypedefs */ \ + /** \brief `Size`×`Dynamic` matrix of type `Type`. */ \ + typedef Matrix Matrix##Size##X##TypeSuffix; \ + /** \ingroup matrixtypedefs */ \ + /** \brief `Dynamic`×`Size` matrix of type `Type`. */ \ + typedef Matrix Matrix##X##Size##TypeSuffix; + +#define EIGEN_MAKE_TYPEDEFS_ALL_SIZES(Type, TypeSuffix) \ + EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 2, 2) \ + EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 3, 3) \ + EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 4, 4) \ + EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, Dynamic, X) \ + EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 2) \ + EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 3) \ + EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 4) + +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(int, i) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(float, f) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(double, d) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(std::complex, cf) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(std::complex, cd) + +#undef EIGEN_MAKE_TYPEDEFS_ALL_SIZES +#undef EIGEN_MAKE_TYPEDEFS +#undef EIGEN_MAKE_FIXED_TYPEDEFS + +#define EIGEN_MAKE_TYPEDEFS(Size, SizeSuffix) \ + /** \ingroup matrixtypedefs */ \ + /** \brief \cpp11 `Size`×`Size` matrix of type `Type`.*/ \ + template \ + using Matrix##SizeSuffix = Matrix; \ + /** \ingroup matrixtypedefs */ \ + /** \brief \cpp11 `Size`×`1` vector of type `Type`.*/ \ + template \ + using Vector##SizeSuffix = Matrix; \ + /** \ingroup matrixtypedefs */ \ + /** \brief \cpp11 `1`×`Size` vector of type `Type`.*/ \ + template \ + using RowVector##SizeSuffix = Matrix; + +#define EIGEN_MAKE_FIXED_TYPEDEFS(Size) \ + /** \ingroup matrixtypedefs */ \ + /** \brief \cpp11 `Size`×`Dynamic` matrix of type `Type` */ \ + template \ + using Matrix##Size##X = Matrix; \ + /** \ingroup matrixtypedefs */ \ + /** \brief \cpp11 `Dynamic`×`Size` matrix of type `Type`. */ \ + template \ + using Matrix##X##Size = Matrix; + +EIGEN_MAKE_TYPEDEFS(2, 2) +EIGEN_MAKE_TYPEDEFS(3, 3) +EIGEN_MAKE_TYPEDEFS(4, 4) +EIGEN_MAKE_TYPEDEFS(Dynamic, X) +EIGEN_MAKE_FIXED_TYPEDEFS(2) +EIGEN_MAKE_FIXED_TYPEDEFS(3) +EIGEN_MAKE_FIXED_TYPEDEFS(4) + +/** \ingroup matrixtypedefs + * \brief \cpp11 `Size`×`1` vector of type `Type`. */ +template +using Vector = Matrix; + +/** \ingroup matrixtypedefs + * \brief \cpp11 `1`×`Size` vector of type `Type`. */ +template +using RowVector = Matrix; + +#undef EIGEN_MAKE_TYPEDEFS +#undef EIGEN_MAKE_FIXED_TYPEDEFS + +} // end namespace Eigen + +#endif // EIGEN_MATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/MatrixBase.h b/src/3rdparty/eigen/Eigen/src/Core/MatrixBase.h new file mode 100644 index 0000000..045993d --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/MatrixBase.h @@ -0,0 +1,545 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2009 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIXBASE_H +#define EIGEN_MATRIXBASE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class MatrixBase + * \ingroup Core_Module + * + * \brief Base class for all dense matrices, vectors, and expressions + * + * This class is the base that is inherited by all matrix, vector, and related expression + * types. Most of the Eigen API is contained in this class, and its base classes. Other important + * classes for the Eigen API are Matrix, and VectorwiseOp. + * + * Note that some methods are defined in other modules such as the \ref LU_Module LU module + * for all functions related to matrix inversions. + * + * \tparam Derived is the derived type, e.g. a matrix type, or an expression, etc. + * + * When writing a function taking Eigen objects as argument, if you want your function + * to take as argument any matrix, vector, or expression, just let it take a + * MatrixBase argument. As an example, here is a function printFirstRow which, given + * a matrix, vector, or expression \a x, prints the first row of \a x. + * + * \code + template + void printFirstRow(const Eigen::MatrixBase& x) + { + cout << x.row(0) << endl; + } + * \endcode + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_MATRIXBASE_PLUGIN. + * + * \sa \blank \ref TopicClassHierarchy + */ +template +class MatrixBase : public DenseBase { + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef MatrixBase StorageBaseType; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + typedef DenseBase Base; + using Base::ColsAtCompileTime; + using Base::Flags; + using Base::IsVectorAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::RowsAtCompileTime; + using Base::SizeAtCompileTime; + + using Base::coeff; + using Base::coeffRef; + using Base::cols; + using Base::const_cast_derived; + using Base::derived; + using Base::eval; + using Base::lazyAssign; + using Base::rows; + using Base::size; + using Base::operator-; + using Base::operator+=; + using Base::operator-=; + using Base::operator*=; + using Base::operator/=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + typedef typename Base::ConstTransposeReturnType ConstTransposeReturnType; + typedef typename Base::RowXpr RowXpr; + typedef typename Base::ColXpr ColXpr; +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** type of the equivalent square matrix */ + typedef Matrix + SquareMatrixType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + + /** \returns the size of the main diagonal, which is min(rows(),cols()). + * \sa rows(), cols(), SizeAtCompileTime. */ + EIGEN_DEVICE_FUNC inline Index diagonalSize() const { return (numext::mini)(rows(), cols()); } + + typedef typename Base::PlainObject PlainObject; + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp, PlainObject> ConstantReturnType; + /** \internal the return type of MatrixBase::adjoint() */ + typedef std::conditional_t::IsComplex, + CwiseUnaryOp, ConstTransposeReturnType>, + ConstTransposeReturnType> + AdjointReturnType; + /** \internal Return type of eigenvalues() */ + typedef Matrix, internal::traits::ColsAtCompileTime, 1, ColMajor> + EigenvaluesReturnType; + /** \internal the return type of identity */ + typedef CwiseNullaryOp, PlainObject> IdentityReturnType; + /** \internal the return type of unit vectors */ + typedef Block, SquareMatrixType>, + internal::traits::RowsAtCompileTime, internal::traits::ColsAtCompileTime> + BasisReturnType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::MatrixBase +#define EIGEN_DOC_UNARY_ADDONS(X, Y) +#include "../plugins/CommonCwiseBinaryOps.inc" +#include "../plugins/MatrixCwiseUnaryOps.inc" +#include "../plugins/MatrixCwiseBinaryOps.inc" +#ifdef EIGEN_MATRIXBASE_PLUGIN +#include EIGEN_MATRIXBASE_PLUGIN +#endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_UNARY_ADDONS + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const MatrixBase& other); + + // We cannot inherit here via Base::operator= since it is causing + // trouble with MSVC. + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const DenseBase& other); + + template + EIGEN_DEVICE_FUNC Derived& operator=(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC Derived& operator=(const ReturnByValue& other); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator+=(const MatrixBase& other); + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator-=(const MatrixBase& other); + + template + EIGEN_DEVICE_FUNC const Product operator*(const MatrixBase& other) const; + + template + EIGEN_DEVICE_FUNC const Product lazyProduct( + const MatrixBase& other) const; + + template + Derived& operator*=(const EigenBase& other); + + template + void applyOnTheLeft(const EigenBase& other); + + template + void applyOnTheRight(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC const Product operator*( + const DiagonalBase& diagonal) const; + + template + EIGEN_DEVICE_FUNC const Product operator*( + const SkewSymmetricBase& skew) const; + + template + EIGEN_DEVICE_FUNC typename ScalarBinaryOpTraits::Scalar, + typename internal::traits::Scalar>::ReturnType + dot(const MatrixBase& other) const; + + EIGEN_DEVICE_FUNC RealScalar squaredNorm() const; + EIGEN_DEVICE_FUNC RealScalar norm() const; + RealScalar stableNorm() const; + RealScalar blueNorm() const; + RealScalar hypotNorm() const; + EIGEN_DEVICE_FUNC const PlainObject normalized() const; + EIGEN_DEVICE_FUNC const PlainObject stableNormalized() const; + EIGEN_DEVICE_FUNC void normalize(); + EIGEN_DEVICE_FUNC void stableNormalize(); + + EIGEN_DEVICE_FUNC const AdjointReturnType adjoint() const; + EIGEN_DEVICE_FUNC void adjointInPlace(); + + typedef Diagonal DiagonalReturnType; + EIGEN_DEVICE_FUNC DiagonalReturnType diagonal(); + + typedef Diagonal ConstDiagonalReturnType; + EIGEN_DEVICE_FUNC const ConstDiagonalReturnType diagonal() const; + + template + EIGEN_DEVICE_FUNC Diagonal diagonal(); + + template + EIGEN_DEVICE_FUNC const Diagonal diagonal() const; + + EIGEN_DEVICE_FUNC Diagonal diagonal(Index index); + EIGEN_DEVICE_FUNC const Diagonal diagonal(Index index) const; + + template + struct TriangularViewReturnType { + typedef TriangularView Type; + }; + template + struct ConstTriangularViewReturnType { + typedef const TriangularView Type; + }; + + template + EIGEN_DEVICE_FUNC typename TriangularViewReturnType::Type triangularView(); + template + EIGEN_DEVICE_FUNC typename ConstTriangularViewReturnType::Type triangularView() const; + + template + struct SelfAdjointViewReturnType { + typedef SelfAdjointView Type; + }; + template + struct ConstSelfAdjointViewReturnType { + typedef const SelfAdjointView Type; + }; + + template + EIGEN_DEVICE_FUNC typename SelfAdjointViewReturnType::Type selfadjointView(); + template + EIGEN_DEVICE_FUNC typename ConstSelfAdjointViewReturnType::Type selfadjointView() const; + + const SparseView sparseView( + const Scalar& m_reference = Scalar(0), + const typename NumTraits::Real& m_epsilon = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC static const IdentityReturnType Identity(); + EIGEN_DEVICE_FUNC static const IdentityReturnType Identity(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const BasisReturnType Unit(Index size, Index i); + EIGEN_DEVICE_FUNC static const BasisReturnType Unit(Index i); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitX(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitY(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitZ(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitW(); + + EIGEN_DEVICE_FUNC const DiagonalWrapper asDiagonal() const; + const PermutationWrapper asPermutation() const; + EIGEN_DEVICE_FUNC const SkewSymmetricWrapper asSkewSymmetric() const; + + EIGEN_DEVICE_FUNC Derived& setIdentity(); + EIGEN_DEVICE_FUNC Derived& setIdentity(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setUnit(Index i); + EIGEN_DEVICE_FUNC Derived& setUnit(Index newSize, Index i); + + bool isIdentity(const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isDiagonal(const RealScalar& prec = NumTraits::dummy_precision()) const; + + bool isUpperTriangular(const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isLowerTriangular(const RealScalar& prec = NumTraits::dummy_precision()) const; + + bool isSkewSymmetric(const RealScalar& prec = NumTraits::dummy_precision()) const; + + template + bool isOrthogonal(const MatrixBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isUnitary(const RealScalar& prec = NumTraits::dummy_precision()) const; + + /** \returns true if each coefficients of \c *this and \a other are all exactly equal. + * \warning When using floating point scalar values you probably should rather use a + * fuzzy comparison such as isApprox() + * \sa isApprox(), operator!= */ + template + EIGEN_DEVICE_FUNC inline bool operator==(const MatrixBase& other) const { + return (this->rows() == other.rows()) && (this->cols() == other.cols()) && cwiseEqual(other).all(); + } + + /** \returns true if at least one pair of coefficients of \c *this and \a other are not exactly equal to each other. + * \warning When using floating point scalar values you probably should rather use a + * fuzzy comparison such as isApprox() + * \sa isApprox(), operator== */ + template + EIGEN_DEVICE_FUNC inline bool operator!=(const MatrixBase& other) const { + return !(*this == other); + } + + NoAlias EIGEN_DEVICE_FUNC noalias(); + + // TODO forceAlignedAccess is temporarily disabled + // Need to find a nicer workaround. + inline const Derived& forceAlignedAccess() const { return derived(); } + inline Derived& forceAlignedAccess() { return derived(); } + template + inline const Derived& forceAlignedAccessIf() const { + return derived(); + } + template + inline Derived& forceAlignedAccessIf() { + return derived(); + } + + EIGEN_DEVICE_FUNC Scalar trace() const; + + template + EIGEN_DEVICE_FUNC RealScalar lpNorm() const; + + EIGEN_DEVICE_FUNC MatrixBase& matrix() { return *this; } + EIGEN_DEVICE_FUNC const MatrixBase& matrix() const { return *this; } + + /** \returns an \link Eigen::ArrayBase Array \endlink expression of this matrix + * \sa ArrayBase::matrix() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ArrayWrapper array() { return ArrayWrapper(derived()); } + /** \returns a const \link Eigen::ArrayBase Array \endlink expression of this matrix + * \sa ArrayBase::matrix() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const ArrayWrapper array() const { + return ArrayWrapper(derived()); + } + + /////////// LU module /////////// + + template + inline const FullPivLU fullPivLu() const; + template + inline const PartialPivLU partialPivLu() const; + + template + inline const PartialPivLU lu() const; + + EIGEN_DEVICE_FUNC inline const Inverse inverse() const; + + template + inline void computeInverseAndDetWithCheck( + ResultType& inverse, typename ResultType::Scalar& determinant, bool& invertible, + const RealScalar& absDeterminantThreshold = NumTraits::dummy_precision()) const; + + template + inline void computeInverseWithCheck( + ResultType& inverse, bool& invertible, + const RealScalar& absDeterminantThreshold = NumTraits::dummy_precision()) const; + + EIGEN_DEVICE_FUNC Scalar determinant() const; + + /////////// Cholesky module /////////// + + inline const LLT llt() const; + inline const LDLT ldlt() const; + + /////////// QR module /////////// + + inline const HouseholderQR householderQr() const; + template + inline const ColPivHouseholderQR colPivHouseholderQr() const; + template + inline const FullPivHouseholderQR fullPivHouseholderQr() const; + template + inline const CompleteOrthogonalDecomposition completeOrthogonalDecomposition() const; + + /////////// Eigenvalues module /////////// + + inline EigenvaluesReturnType eigenvalues() const; + inline RealScalar operatorNorm() const; + + /////////// SVD module /////////// + + template + inline JacobiSVD jacobiSvd() const; + template + EIGEN_DEPRECATED_WITH_REASON("Options should be specified using method's template parameter.") + inline JacobiSVD jacobiSvd(unsigned int computationOptions) const; + + template + inline BDCSVD bdcSvd() const; + template + EIGEN_DEPRECATED_WITH_REASON("Options should be specified using method's template parameter.") + inline BDCSVD bdcSvd(unsigned int computationOptions) const; + + /////////// Geometry module /////////// + + template + EIGEN_DEVICE_FUNC inline typename internal::cross_impl::return_type cross( + const MatrixBase& other) const; + + template + EIGEN_DEVICE_FUNC inline PlainObject cross3(const MatrixBase& other) const; + + EIGEN_DEVICE_FUNC inline PlainObject unitOrthogonal(void) const; + + EIGEN_DEPRECATED_WITH_REASON("Use .canonicalEulerAngles() instead.") + EIGEN_DEVICE_FUNC inline Matrix eulerAngles(Index a0, Index a1, Index a2) const; + + EIGEN_DEVICE_FUNC inline Matrix canonicalEulerAngles(Index a0, Index a1, Index a2) const; + + // put this as separate enum value to work around possible GCC 4.3 bug (?) + enum { + HomogeneousReturnTypeDirection = + ColsAtCompileTime == 1 && RowsAtCompileTime == 1 + ? ((internal::traits::Flags & RowMajorBit) == RowMajorBit ? Horizontal : Vertical) + : ColsAtCompileTime == 1 ? Vertical + : Horizontal + }; + typedef Homogeneous HomogeneousReturnType; + EIGEN_DEVICE_FUNC inline HomogeneousReturnType homogeneous() const; + + enum { SizeMinusOne = SizeAtCompileTime == Dynamic ? Dynamic : SizeAtCompileTime - 1 }; + typedef Block::ColsAtCompileTime == 1 ? SizeMinusOne : 1, + internal::traits::ColsAtCompileTime == 1 ? 1 : SizeMinusOne> + ConstStartMinusOne; + typedef EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE(ConstStartMinusOne, Scalar, quotient) HNormalizedReturnType; + EIGEN_DEVICE_FUNC inline const HNormalizedReturnType hnormalized() const; + + ////////// Householder module /////////// + + EIGEN_DEVICE_FUNC void makeHouseholderInPlace(Scalar& tau, RealScalar& beta); + template + EIGEN_DEVICE_FUNC void makeHouseholder(EssentialPart& essential, Scalar& tau, RealScalar& beta) const; + template + EIGEN_DEVICE_FUNC void applyHouseholderOnTheLeft(const EssentialPart& essential, const Scalar& tau, + Scalar* workspace); + template + EIGEN_DEVICE_FUNC void applyHouseholderOnTheRight(const EssentialPart& essential, const Scalar& tau, + Scalar* workspace); + + ///////// Jacobi module ///////// + + template + EIGEN_DEVICE_FUNC void applyOnTheLeft(Index p, Index q, const JacobiRotation& j); + template + EIGEN_DEVICE_FUNC void applyOnTheRight(Index p, Index q, const JacobiRotation& j); + + ///////// SparseCore module ///////// + + template + EIGEN_STRONG_INLINE const typename SparseMatrixBase::template CwiseProductDenseReturnType::Type + cwiseProduct(const SparseMatrixBase& other) const { + return other.cwiseProduct(derived()); + } + + ///////// MatrixFunctions module ///////// + + typedef typename internal::stem_function::type StemFunction; +#define EIGEN_MATRIX_FUNCTION(ReturnType, Name, Description) \ + /** \returns an expression of the matrix Description of \c *this. \brief This function requires the unsupported MatrixFunctions module. To compute the \ + * coefficient-wise Description use ArrayBase::##Name . */ \ + const ReturnType Name() const; +#define EIGEN_MATRIX_FUNCTION_1(ReturnType, Name, Description, Argument) \ + /** \returns an expression of the matrix Description of \c *this. \brief This function requires the unsupported MatrixFunctions module. To compute the \ + * coefficient-wise Description use ArrayBase::##Name . */ \ + const ReturnType Name(Argument) const; + + EIGEN_MATRIX_FUNCTION(MatrixExponentialReturnValue, exp, exponential) + /** \brief Helper function for the unsupported + * MatrixFunctions module.*/ + const MatrixFunctionReturnValue matrixFunction(StemFunction f) const; + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, cosh, hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, sinh, hyperbolic sine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, atanh, inverse hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, acosh, inverse hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, asinh, inverse hyperbolic sine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, cos, cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, sin, sine) + EIGEN_MATRIX_FUNCTION(MatrixSquareRootReturnValue, sqrt, square root) + EIGEN_MATRIX_FUNCTION(MatrixLogarithmReturnValue, log, logarithm) + EIGEN_MATRIX_FUNCTION_1(MatrixPowerReturnValue, pow, power to \c p, const RealScalar& p) + EIGEN_MATRIX_FUNCTION_1(MatrixComplexPowerReturnValue, pow, power to \c p, const internal::make_complex_t& p) + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MatrixBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MatrixBase) + + private: + EIGEN_DEVICE_FUNC explicit MatrixBase(int); + EIGEN_DEVICE_FUNC MatrixBase(int, int); + template + EIGEN_DEVICE_FUNC explicit MatrixBase(const MatrixBase&); + + protected: + // mixing arrays and matrices is not legal + template + Derived& operator+=(const ArrayBase&) { + EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar)) == -1, + YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); + return *this; + } + // mixing arrays and matrices is not legal + template + Derived& operator-=(const ArrayBase&) { + EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar)) == -1, + YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); + return *this; + } +}; + +/*************************************************************************** + * Implementation of matrix base methods + ***************************************************************************/ + +/** replaces \c *this by \c *this * \a other. + * + * \returns a reference to \c *this + * + * Example: \include MatrixBase_applyOnTheRight.cpp + * Output: \verbinclude MatrixBase_applyOnTheRight.out + */ +template +template +inline Derived& MatrixBase::operator*=(const EigenBase& other) { + other.derived().applyThisOnTheRight(derived()); + return derived(); +} + +/** replaces \c *this by \c *this * \a other. It is equivalent to MatrixBase::operator*=(). + * + * Example: \include MatrixBase_applyOnTheRight.cpp + * Output: \verbinclude MatrixBase_applyOnTheRight.out + */ +template +template +inline void MatrixBase::applyOnTheRight(const EigenBase& other) { + other.derived().applyThisOnTheRight(derived()); +} + +/** replaces \c *this by \a other * \c *this. + * + * Example: \include MatrixBase_applyOnTheLeft.cpp + * Output: \verbinclude MatrixBase_applyOnTheLeft.out + */ +template +template +inline void MatrixBase::applyOnTheLeft(const EigenBase& other) { + other.derived().applyThisOnTheLeft(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_MATRIXBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/NestByValue.h b/src/3rdparty/eigen/Eigen/src/Core/NestByValue.h new file mode 100644 index 0000000..2ce83a8 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/NestByValue.h @@ -0,0 +1,91 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NESTBYVALUE_H +#define EIGEN_NESTBYVALUE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > : public traits { + enum { Flags = traits::Flags & ~NestByRefBit }; +}; +} // namespace internal + +/** \class NestByValue + * \ingroup Core_Module + * + * \brief Expression which must be nested by value + * + * \tparam ExpressionType the type of the object of which we are requiring nesting-by-value + * + * This class is the return type of MatrixBase::nestByValue() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::nestByValue() + */ +template +class NestByValue : public internal::dense_xpr_base >::type { + public: + typedef typename internal::dense_xpr_base::type Base; + static constexpr bool HasDirectAccess = internal::has_direct_access::ret; + + EIGEN_DENSE_PUBLIC_INTERFACE(NestByValue) + + EIGEN_DEVICE_FUNC explicit inline NestByValue(const ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_expression.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_expression.cols(); } + + EIGEN_DEVICE_FUNC operator const ExpressionType&() const { return m_expression; } + + EIGEN_DEVICE_FUNC const ExpressionType& nestedExpression() const { return m_expression; } + + EIGEN_DEVICE_FUNC typename std::enable_if::type data() const { + return m_expression.data(); + } + + EIGEN_DEVICE_FUNC typename std::enable_if::type innerStride() const { + return m_expression.innerStride(); + } + + EIGEN_DEVICE_FUNC typename std::enable_if::type outerStride() const { + return m_expression.outerStride(); + } + + protected: + const ExpressionType m_expression; +}; + +/** \returns an expression of the temporary version of *this. + */ +template +EIGEN_DEVICE_FUNC inline const NestByValue DenseBase::nestByValue() const { + return NestByValue(derived()); +} + +namespace internal { + +// Evaluator of Solve -> eval into a temporary +template +struct evaluator > : public evaluator { + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const NestByValue& xpr) : Base(xpr.nestedExpression()) {} +}; +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_NESTBYVALUE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/NoAlias.h b/src/3rdparty/eigen/Eigen/src/Core/NoAlias.h new file mode 100644 index 0000000..b6c7209 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/NoAlias.h @@ -0,0 +1,102 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NOALIAS_H +#define EIGEN_NOALIAS_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class NoAlias + * \ingroup Core_Module + * + * \brief Pseudo expression providing an operator = assuming no aliasing + * + * \tparam ExpressionType the type of the object on which to do the lazy assignment + * + * This class represents an expression with special assignment operators + * assuming no aliasing between the target expression and the source expression. + * More precisely it alloas to bypass the EvalBeforeAssignBit flag of the source expression. + * It is the return type of MatrixBase::noalias() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::noalias() + */ +template class StorageBase> +class NoAlias { + public: + typedef typename ExpressionType::Scalar Scalar; + + EIGEN_DEVICE_FUNC explicit NoAlias(ExpressionType& expression) : m_expression(expression) {} + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ExpressionType& operator=(const StorageBase& other) { + call_assignment_no_alias(m_expression, other.derived(), + internal::assign_op()); + return m_expression; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ExpressionType& operator+=(const StorageBase& other) { + call_assignment_no_alias(m_expression, other.derived(), + internal::add_assign_op()); + return m_expression; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ExpressionType& operator-=(const StorageBase& other) { + call_assignment_no_alias(m_expression, other.derived(), + internal::sub_assign_op()); + return m_expression; + } + + EIGEN_DEVICE_FUNC ExpressionType& expression() const { return m_expression; } + + protected: + ExpressionType& m_expression; +}; + +/** \returns a pseudo expression of \c *this with an operator= assuming + * no aliasing between \c *this and the source expression. + * + * More precisely, noalias() allows to bypass the EvalBeforeAssignBit flag. + * Currently, even though several expressions may alias, only product + * expressions have this flag. Therefore, noalias() is only useful when + * the source expression contains a matrix product. + * + * Here are some examples where noalias is useful: + * \code + * D.noalias() = A * B; + * D.noalias() += A.transpose() * B; + * D.noalias() -= 2 * A * B.adjoint(); + * \endcode + * + * On the other hand the following example will lead to a \b wrong result: + * \code + * A.noalias() = A * B; + * \endcode + * because the result matrix A is also an operand of the matrix product. Therefore, + * there is no alternative than evaluating A * B in a temporary, that is the default + * behavior when you write: + * \code + * A = A * B; + * \endcode + * + * \sa class NoAlias + */ +template +NoAlias EIGEN_DEVICE_FUNC MatrixBase::noalias() { + return NoAlias(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_NOALIAS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/NumTraits.h b/src/3rdparty/eigen/Eigen/src/Core/NumTraits.h new file mode 100644 index 0000000..bf41c3b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/NumTraits.h @@ -0,0 +1,335 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NUMTRAITS_H +#define EIGEN_NUMTRAITS_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +// default implementation of digits(), based on numeric_limits if specialized, +// 0 for integer types, and log2(epsilon()) otherwise. +template ::is_specialized, + bool is_integer = NumTraits::IsInteger> +struct default_digits_impl { + EIGEN_DEVICE_FUNC constexpr static int run() { return std::numeric_limits::digits; } +}; + +template +struct default_digits_impl // Floating point +{ + EIGEN_DEVICE_FUNC constexpr static int run() { + using std::ceil; + using std::log2; + typedef typename NumTraits::Real Real; + return int(ceil(-log2(NumTraits::epsilon()))); + } +}; + +template +struct default_digits_impl // Integer +{ + EIGEN_DEVICE_FUNC constexpr static int run() { return 0; } +}; + +// default implementation of digits10(), based on numeric_limits if specialized, +// 0 for integer types, and floor((digits()-1)*log10(2)) otherwise. +template ::is_specialized, + bool is_integer = NumTraits::IsInteger> +struct default_digits10_impl { + EIGEN_DEVICE_FUNC constexpr static int run() { return std::numeric_limits::digits10; } +}; + +template +struct default_digits10_impl // Floating point +{ + EIGEN_DEVICE_FUNC constexpr static int run() { + using std::floor; + using std::log10; + typedef typename NumTraits::Real Real; + return int(floor((internal::default_digits_impl::run() - 1) * log10(2))); + } +}; + +template +struct default_digits10_impl // Integer +{ + EIGEN_DEVICE_FUNC constexpr static int run() { return 0; } +}; + +// default implementation of max_digits10(), based on numeric_limits if specialized, +// 0 for integer types, and log10(2) * digits() + 1 otherwise. +template ::is_specialized, + bool is_integer = NumTraits::IsInteger> +struct default_max_digits10_impl { + EIGEN_DEVICE_FUNC constexpr static int run() { return std::numeric_limits::max_digits10; } +}; + +template +struct default_max_digits10_impl // Floating point +{ + EIGEN_DEVICE_FUNC constexpr static int run() { + using std::ceil; + using std::log10; + typedef typename NumTraits::Real Real; + return int(ceil(internal::default_digits_impl::run() * log10(2) + 1)); + } +}; + +template +struct default_max_digits10_impl // Integer +{ + EIGEN_DEVICE_FUNC constexpr static int run() { return 0; } +}; + +} // end namespace internal + +namespace numext { + +/** \internal bit-wise cast without changing the underlying bit representation. */ +#if defined(__cpp_lib_bit_cast) && __cpp_lib_bit_cast >= 201806L +template +EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC constexpr Tgt bit_cast(const Src& src) { + return std::bit_cast(src); +} +#elif EIGEN_HAS_BUILTIN(__builtin_bit_cast) +template +EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC constexpr Tgt bit_cast(const Src& src) { + EIGEN_STATIC_ASSERT(std::is_trivially_copyable::value, THIS_TYPE_IS_NOT_SUPPORTED) + EIGEN_STATIC_ASSERT(std::is_trivially_copyable::value, THIS_TYPE_IS_NOT_SUPPORTED) + EIGEN_STATIC_ASSERT(sizeof(Src) == sizeof(Tgt), THIS_TYPE_IS_NOT_SUPPORTED) + return __builtin_bit_cast(Tgt, src); +} +#else +template +EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC Tgt bit_cast(const Src& src) { + // The behaviour of memcpy is not specified for non-trivially copyable types + EIGEN_STATIC_ASSERT(std::is_trivially_copyable::value, THIS_TYPE_IS_NOT_SUPPORTED) + EIGEN_STATIC_ASSERT(std::is_trivially_copyable::value && std::is_default_constructible::value, + THIS_TYPE_IS_NOT_SUPPORTED) + EIGEN_STATIC_ASSERT(sizeof(Src) == sizeof(Tgt), THIS_TYPE_IS_NOT_SUPPORTED) + + Tgt tgt; + // Load src into registers first. This allows the memcpy to be elided by CUDA. + const Src staged = src; + EIGEN_USING_STD(memcpy) + memcpy(static_cast(&tgt), static_cast(&staged), sizeof(Tgt)); + return tgt; +} +#endif +} // namespace numext + +// clang-format off +/** \class NumTraits + * \ingroup Core_Module + * + * \brief Holds information about the various numeric (i.e. scalar) types allowed by Eigen. + * + * \tparam T the numeric type at hand + * + * This class stores enums, typedefs and static methods giving information about a numeric type. + * + * The provided data consists of: + * \li A typedef \c Real, giving the "real part" type of \a T. If \a T is already real, + * then \c Real is just a typedef to \a T. If \a T is `std::complex` then \c Real + * is a typedef to \a U. + * \li A typedef \c NonInteger, giving the type that should be used for operations producing non-integral values, + * such as quotients, square roots, etc. If \a T is a floating-point type, then this typedef just gives + * \a T again. Note however that many Eigen functions such as internal::sqrt simply refuse to + * take integers. Outside of a few cases, Eigen doesn't do automatic type promotion. Thus, this typedef is + * only intended as a helper for code that needs to explicitly promote types. + * \li A typedef \c Literal giving the type to use for numeric literals such as "2" or "0.5". For instance, for + * `std::complex`, Literal is defined as \a U. Of course, this type must be fully compatible with \a T. In doubt, + * just use \a T here. + * \li A typedef \c Nested giving the type to use to nest a value inside of the expression tree. If you don't know what + * this means, just use \a T here. + * \li An enum value \c IsComplex. It is equal to 1 if \a T is a \c std::complex type, and to 0 otherwise. + * \li An enum value \c IsInteger. It is equal to \c 1 if \a T is an integer type such as \c int, and to \c 0 otherwise. + * \li Enum values \c ReadCost, \c AddCost and \c MulCost representing a rough estimate of the number of CPU cycles needed to by + * move / add / mul instructions respectively, assuming the data is already stored in CPU registers. Stay vague here. + * No need to do architecture-specific stuff. If you don't know what this means, just use \c Eigen::HugeCost. + * \li An enum value \c IsSigned. It is equal to \c 1 if \a T is a signed type and to 0 if \a T is unsigned. + * \li An enum value \c RequireInitialization. It is equal to \c 1 if the constructor of the numeric type \a T must be + * called, and to 0 if it is safe not to call it. Default is 0 if \a T is an arithmetic type, and 1 otherwise. + * \li An epsilon() function which, unlike + * `std::numeric_limits::epsilon()`, it returns a \c Real instead of a \a T. + * \li A dummy_precision() function returning a weak epsilon value. It is mainly used as a default value by the fuzzy + * comparison operators. + * \li highest() and lowest() functions returning the highest and lowest possible values respectively. + * \li digits() function returning the number of radix digits (non-sign digits for integers, mantissa for floating-point). + * This is the analogue of + * `std::numeric_limits::digits` which is used as the default implementation if specialized. + * \li digits10() function returning the number of decimal digits that can be represented without change. This is the + * analogue of + * `std::numeric_limits::digits10` which is used as the default implementation if specialized. + * \li max_digits10() function returning the number of decimal digits required to uniquely represent all distinct values + * of the type. This is the analogue of `std::numeric_limits::max_digits10` + * which is used as the default implementation if specialized. + * \li min_exponent() and max_exponent() functions returning the highest and lowest possible values, respectively, + * such that the radix raised to the power exponent-1 is a normalized floating-point number. These are equivalent + * to + * `std::numeric_limits::min_exponent`/`std::numeric_limits::max_exponent`. + * \li infinity() function returning a representation of positive infinity, if available. + * \li quiet_NaN() function returning a non-signaling "not-a-number", if available. + */ +// clang-format on +template +struct GenericNumTraits { + enum { + IsInteger = std::numeric_limits::is_integer, + IsSigned = std::numeric_limits::is_signed, + IsComplex = 0, + RequireInitialization = internal::is_arithmetic::value ? 0 : 1, + ReadCost = 1, + AddCost = 1, + MulCost = 1 + }; + + typedef T Real; + typedef std::conditional_t, T> NonInteger; + typedef T Nested; + typedef T Literal; + + EIGEN_DEVICE_FUNC constexpr static Real epsilon() { return numext::numeric_limits::epsilon(); } + + EIGEN_DEVICE_FUNC constexpr static int digits10() { return internal::default_digits10_impl::run(); } + + EIGEN_DEVICE_FUNC constexpr static int max_digits10() { return internal::default_max_digits10_impl::run(); } + + EIGEN_DEVICE_FUNC constexpr static int digits() { return internal::default_digits_impl::run(); } + + EIGEN_DEVICE_FUNC constexpr static int min_exponent() { return numext::numeric_limits::min_exponent; } + + EIGEN_DEVICE_FUNC constexpr static int max_exponent() { return numext::numeric_limits::max_exponent; } + + EIGEN_DEVICE_FUNC constexpr static Real dummy_precision() { + // make sure to override this for floating-point types + return Real(0); + } + + EIGEN_DEVICE_FUNC constexpr static T highest() { return (numext::numeric_limits::max)(); } + + EIGEN_DEVICE_FUNC constexpr static T lowest() { return (numext::numeric_limits::lowest)(); } + + EIGEN_DEVICE_FUNC constexpr static T infinity() { return numext::numeric_limits::infinity(); } + + EIGEN_DEVICE_FUNC constexpr static T quiet_NaN() { return numext::numeric_limits::quiet_NaN(); } +}; + +template +struct NumTraits : GenericNumTraits {}; + +template <> +struct NumTraits : GenericNumTraits { + EIGEN_DEVICE_FUNC constexpr static float dummy_precision() { return 1e-5f; } +}; + +template <> +struct NumTraits : GenericNumTraits { + EIGEN_DEVICE_FUNC constexpr static double dummy_precision() { return 1e-12; } +}; + +// GPU devices treat `long double` as `double`. +#ifndef EIGEN_GPU_COMPILE_PHASE +template <> +struct NumTraits : GenericNumTraits { + EIGEN_DEVICE_FUNC constexpr static long double dummy_precision() { return static_cast(1e-15l); } + +#if defined(EIGEN_ARCH_PPC) && (__LDBL_MANT_DIG__ == 106) + // PowerPC double double causes issues with some values + EIGEN_DEVICE_FUNC constexpr static long double epsilon() { + // 2^(-(__LDBL_MANT_DIG__)+1) + return static_cast(2.4651903288156618919116517665087e-32l); + } +#endif +}; +#endif + +template +struct NumTraits > : GenericNumTraits > { + typedef Real_ Real; + typedef typename NumTraits::Literal Literal; + enum { + IsComplex = 1, + IsSigned = NumTraits::IsSigned, + RequireInitialization = NumTraits::RequireInitialization, + ReadCost = 2 * NumTraits::ReadCost, + AddCost = 2 * NumTraits::AddCost, + MulCost = 4 * NumTraits::MulCost + 2 * NumTraits::AddCost + }; + + EIGEN_DEVICE_FUNC constexpr static Real epsilon() { return NumTraits::epsilon(); } + EIGEN_DEVICE_FUNC constexpr static Real dummy_precision() { return NumTraits::dummy_precision(); } + EIGEN_DEVICE_FUNC constexpr static int digits10() { return NumTraits::digits10(); } + EIGEN_DEVICE_FUNC constexpr static int max_digits10() { return NumTraits::max_digits10(); } +}; + +template +struct NumTraits > { + typedef Array ArrayType; + typedef typename NumTraits::Real RealScalar; + typedef Array Real; + typedef typename NumTraits::NonInteger NonIntegerScalar; + typedef Array NonInteger; + typedef ArrayType& Nested; + typedef typename NumTraits::Literal Literal; + + enum { + IsComplex = NumTraits::IsComplex, + IsInteger = NumTraits::IsInteger, + IsSigned = NumTraits::IsSigned, + RequireInitialization = 1, + ReadCost = ArrayType::SizeAtCompileTime == Dynamic + ? HugeCost + : ArrayType::SizeAtCompileTime * int(NumTraits::ReadCost), + AddCost = ArrayType::SizeAtCompileTime == Dynamic ? HugeCost + : ArrayType::SizeAtCompileTime * int(NumTraits::AddCost), + MulCost = ArrayType::SizeAtCompileTime == Dynamic ? HugeCost + : ArrayType::SizeAtCompileTime * int(NumTraits::MulCost) + }; + + EIGEN_DEVICE_FUNC constexpr static RealScalar epsilon() { return NumTraits::epsilon(); } + EIGEN_DEVICE_FUNC constexpr static RealScalar dummy_precision() { return NumTraits::dummy_precision(); } + + constexpr static int digits10() { return NumTraits::digits10(); } + constexpr static int max_digits10() { return NumTraits::max_digits10(); } +}; + +template <> +struct NumTraits : GenericNumTraits { + enum { RequireInitialization = 1, ReadCost = HugeCost, AddCost = HugeCost, MulCost = HugeCost }; + + constexpr static int digits10() { return 0; } + constexpr static int max_digits10() { return 0; } + + private: + static inline std::string epsilon(); + static inline std::string dummy_precision(); + static inline std::string lowest(); + static inline std::string highest(); + static inline std::string infinity(); + static inline std::string quiet_NaN(); +}; + +// Empty specialization for void to allow template specialization based on NumTraits::Real with T==void and SFINAE. +template <> +struct NumTraits {}; + +template <> +struct NumTraits : GenericNumTraits {}; + +} // end namespace Eigen + +#endif // EIGEN_NUMTRAITS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/PartialReduxEvaluator.h b/src/3rdparty/eigen/Eigen/src/Core/PartialReduxEvaluator.h new file mode 100644 index 0000000..1f638f9 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/PartialReduxEvaluator.h @@ -0,0 +1,253 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011-2018 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PARTIALREDUX_H +#define EIGEN_PARTIALREDUX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +/*************************************************************************** + * + * This file provides evaluators for partial reductions. + * There are two modes: + * + * - scalar path: simply calls the respective function on the column or row. + * -> nothing special here, all the tricky part is handled by the return + * types of VectorwiseOp's members. They embed the functor calling the + * respective DenseBase's member function. + * + * - vectorized path: implements a packet-wise reductions followed by + * some (optional) processing of the outcome, e.g., division by n for mean. + * + * For the vectorized path let's observe that the packet-size and outer-unrolling + * are both decided by the assignment logic. So all we have to do is to decide + * on the inner unrolling. + * + * For the unrolling, we can reuse "internal::redux_vec_unroller" from Redux.h, + * but be need to be careful to specify correct increment. + * + ***************************************************************************/ + +/* logic deciding a strategy for unrolling of vectorized paths */ +template +struct packetwise_redux_traits { + enum { + OuterSize = int(Evaluator::IsRowMajor) ? Evaluator::RowsAtCompileTime : Evaluator::ColsAtCompileTime, + Cost = OuterSize == Dynamic ? HugeCost + : OuterSize * Evaluator::CoeffReadCost + (OuterSize - 1) * functor_traits::Cost, + Unrolling = Cost <= EIGEN_UNROLLING_LIMIT ? CompleteUnrolling : NoUnrolling + }; +}; + +/* Value to be returned when size==0 , by default let's return 0 */ +template +EIGEN_DEVICE_FUNC PacketType packetwise_redux_empty_value(const Func&) { + const typename unpacket_traits::type zero(0); + return pset1(zero); +} + +/* For products the default is 1 */ +template +EIGEN_DEVICE_FUNC PacketType packetwise_redux_empty_value(const scalar_product_op&) { + return pset1(Scalar(1)); +} + +/* Perform the actual reduction */ +template ::Unrolling> +struct packetwise_redux_impl; + +/* Perform the actual reduction with unrolling */ +template +struct packetwise_redux_impl { + typedef redux_novec_unroller Base; + typedef typename Evaluator::Scalar Scalar; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE PacketType run(const Evaluator& eval, const Func& func, Index /*size*/) { + return redux_vec_unroller::OuterSize>::template run(eval, + func); + } +}; + +/* Add a specialization of redux_vec_unroller for size==0 at compiletime. + * This specialization is not required for general reductions, which is + * why it is defined here. + */ +template +struct redux_vec_unroller { + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE PacketType run(const Evaluator&, const Func& f) { + return packetwise_redux_empty_value(f); + } +}; + +/* Perform the actual reduction for dynamic sizes */ +template +struct packetwise_redux_impl { + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketScalar; + + template + EIGEN_DEVICE_FUNC static PacketType run(const Evaluator& eval, const Func& func, Index size) { + if (size == 0) return packetwise_redux_empty_value(func); + + const Index size4 = 1 + numext::round_down(size - 1, 4); + PacketType p = eval.template packetByOuterInner(0, 0); + // This loop is optimized for instruction pipelining: + // - each iteration generates two independent instructions + // - thanks to branch prediction and out-of-order execution we have independent instructions across loops + for (Index i = 1; i < size4; i += 4) + p = func.packetOp( + p, func.packetOp(func.packetOp(eval.template packetByOuterInner(i + 0, 0), + eval.template packetByOuterInner(i + 1, 0)), + func.packetOp(eval.template packetByOuterInner(i + 2, 0), + eval.template packetByOuterInner(i + 3, 0)))); + for (Index i = size4; i < size; ++i) + p = func.packetOp(p, eval.template packetByOuterInner(i, 0)); + return p; + } +}; + +template +struct packetwise_segment_redux_impl { + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketScalar; + + template + EIGEN_DEVICE_FUNC static PacketType run(const Evaluator& eval, const Func& func, Index size, Index begin, + Index count) { + if (size == 0) return packetwise_redux_empty_value(func); + + PacketType p = eval.template packetSegmentByOuterInner(0, 0, begin, count); + for (Index i = 1; i < size; ++i) + p = func.packetOp(p, eval.template packetSegmentByOuterInner(i, 0, begin, count)); + return p; + } +}; + +template +struct evaluator > + : evaluator_base > { + typedef PartialReduxExpr XprType; + typedef typename internal::nested_eval::type ArgTypeNested; + typedef add_const_on_value_type_t ConstArgTypeNested; + typedef internal::remove_all_t ArgTypeNestedCleaned; + typedef typename ArgType::Scalar InputScalar; + typedef typename XprType::Scalar Scalar; + enum { + TraversalSize = Direction == int(Vertical) ? int(ArgType::RowsAtCompileTime) : int(ArgType::ColsAtCompileTime) + }; + typedef typename MemberOp::template Cost CostOpType; + enum { + CoeffReadCost = TraversalSize == Dynamic ? HugeCost + : TraversalSize == 0 + ? 1 + : int(TraversalSize) * int(evaluator::CoeffReadCost) + int(CostOpType::value), + + ArgFlags_ = evaluator::Flags, + + Vectorizable_ = bool(int(ArgFlags_) & PacketAccessBit) && bool(MemberOp::Vectorizable) && + (Direction == int(Vertical) ? bool(ArgFlags_ & RowMajorBit) : (ArgFlags_ & RowMajorBit) == 0) && + (TraversalSize != 0), + + Flags = (traits::Flags & RowMajorBit) | (evaluator::Flags & (HereditaryBits & (~RowMajorBit))) | + (Vectorizable_ ? PacketAccessBit : 0) | LinearAccessBit, + + Alignment = 0 // FIXME this will need to be improved once PartialReduxExpr is vectorized + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType xpr) : m_arg(xpr.nestedExpression()), m_functor(xpr.functor()) { + EIGEN_INTERNAL_CHECK_COST_VALUE(TraversalSize == Dynamic ? HugeCost + : (TraversalSize == 0 ? 1 : int(CostOpType::value))); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index i, Index j) const { + return coeff(Direction == Vertical ? j : i); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index index) const { + return m_functor(m_arg.template subVector(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index i, Index j) const { + return packet(Direction == Vertical ? j : i); + } + + template + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC PacketType packet(Index idx) const { + static constexpr int PacketSize = internal::unpacket_traits::size; + static constexpr int PanelRows = Direction == Vertical ? ArgType::RowsAtCompileTime : PacketSize; + static constexpr int PanelCols = Direction == Vertical ? PacketSize : ArgType::ColsAtCompileTime; + using PanelType = Block; + using PanelEvaluator = typename internal::redux_evaluator; + using BinaryOp = typename MemberOp::BinaryOp; + using Impl = internal::packetwise_redux_impl; + + // FIXME + // See bug 1612, currently if PacketSize==1 (i.e. complex with 128bits registers) then the storage-order of + // panel get reversed and methods like packetByOuterInner do not make sense anymore in this context. So let's just + // by pass "vectorization" in this case: + if (PacketSize == 1) return internal::pset1(coeff(idx)); + + Index startRow = Direction == Vertical ? 0 : idx; + Index startCol = Direction == Vertical ? idx : 0; + Index numRows = Direction == Vertical ? m_arg.rows() : PacketSize; + Index numCols = Direction == Vertical ? PacketSize : m_arg.cols(); + + PanelType panel(m_arg, startRow, startCol, numRows, numCols); + PanelEvaluator panel_eval(panel); + PacketType p = Impl::template run(panel_eval, m_functor.binaryFunc(), m_arg.outerSize()); + return p; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index i, Index j, Index begin, Index count) const { + return packetSegment(Direction == Vertical ? j : i, begin, count); + } + + template + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC PacketType packetSegment(Index idx, Index begin, Index count) const { + static constexpr int PanelRows = Direction == Vertical ? ArgType::RowsAtCompileTime : Dynamic; + static constexpr int PanelCols = Direction == Vertical ? Dynamic : ArgType::ColsAtCompileTime; + using PanelType = Block; + using PanelEvaluator = typename internal::redux_evaluator; + using BinaryOp = typename MemberOp::BinaryOp; + using Impl = internal::packetwise_segment_redux_impl; + + Index startRow = Direction == Vertical ? 0 : idx; + Index startCol = Direction == Vertical ? idx : 0; + Index numRows = Direction == Vertical ? m_arg.rows() : begin + count; + Index numCols = Direction == Vertical ? begin + count : m_arg.cols(); + + PanelType panel(m_arg, startRow, startCol, numRows, numCols); + PanelEvaluator panel_eval(panel); + PacketType p = Impl::template run(panel_eval, m_functor.binaryFunc(), m_arg.outerSize(), begin, count); + return p; + } + + protected: + ConstArgTypeNested m_arg; + const MemberOp m_functor; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PARTIALREDUX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/PermutationMatrix.h b/src/3rdparty/eigen/Eigen/src/Core/PermutationMatrix.h new file mode 100644 index 0000000..7713354 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/PermutationMatrix.h @@ -0,0 +1,555 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2009-2015 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PERMUTATIONMATRIX_H +#define EIGEN_PERMUTATIONMATRIX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +enum PermPermProduct_t { PermPermProduct }; + +} // end namespace internal + +/** \class PermutationBase + * \ingroup Core_Module + * + * \brief Base class for permutations + * + * \tparam Derived the derived class + * + * This class is the base class for all expressions representing a permutation matrix, + * internally stored as a vector of integers. + * The convention followed here is that if \f$ \sigma \f$ is a permutation, the corresponding permutation matrix + * \f$ P_\sigma \f$ is such that if \f$ (e_1,\ldots,e_p) \f$ is the canonical basis, we have: + * \f[ P_\sigma(e_i) = e_{\sigma(i)}. \f] + * This convention ensures that for any two permutations \f$ \sigma, \tau \f$, we have: + * \f[ P_{\sigma\circ\tau} = P_\sigma P_\tau. \f] + * + * Permutation matrices are square and invertible. + * + * Notice that in addition to the member functions and operators listed here, there also are non-member + * operator* to multiply any kind of permutation object with any kind of matrix expression (MatrixBase) + * on either side. + * + * \sa class PermutationMatrix, class PermutationWrapper + */ +template +class PermutationBase : public EigenBase { + typedef internal::traits Traits; + typedef EigenBase Base; + + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + enum { + Flags = Traits::Flags, + RowsAtCompileTime = Traits::RowsAtCompileTime, + ColsAtCompileTime = Traits::ColsAtCompileTime, + MaxRowsAtCompileTime = Traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = Traits::MaxColsAtCompileTime + }; + typedef typename Traits::StorageIndex StorageIndex; + typedef Matrix + DenseMatrixType; + typedef PermutationMatrix + PlainPermutationType; + typedef PlainPermutationType PlainObject; + using Base::derived; + typedef Inverse InverseReturnType; + typedef void Scalar; +#endif + + /** Copies the other permutation into *this */ + template + Derived& operator=(const PermutationBase& other) { + indices() = other.indices(); + return derived(); + } + + /** Assignment from the Transpositions \a tr */ + template + Derived& operator=(const TranspositionsBase& tr) { + setIdentity(tr.size()); + for (Index k = size() - 1; k >= 0; --k) applyTranspositionOnTheRight(k, tr.coeff(k)); + return derived(); + } + + /** \returns the number of rows */ + inline EIGEN_DEVICE_FUNC Index rows() const { return Index(indices().size()); } + + /** \returns the number of columns */ + inline EIGEN_DEVICE_FUNC Index cols() const { return Index(indices().size()); } + + /** \returns the size of a side of the respective square matrix, i.e., the number of indices */ + inline EIGEN_DEVICE_FUNC Index size() const { return Index(indices().size()); } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + void evalTo(MatrixBase& other) const { + other.setZero(); + for (Index i = 0; i < rows(); ++i) other.coeffRef(indices().coeff(i), i) = typename DenseDerived::Scalar(1); + } +#endif + + /** \returns a Matrix object initialized from this permutation matrix. Notice that it + * is inefficient to return this Matrix object by value. For efficiency, favor using + * the Matrix constructor taking EigenBase objects. + */ + DenseMatrixType toDenseMatrix() const { return derived(); } + + /** \returns the plain matrix representation of the permutation. */ + DenseMatrixType eval() const { return toDenseMatrix(); } + + /** const version of indices(). */ + const IndicesType& indices() const { return derived().indices(); } + /** \returns a reference to the stored array representing the permutation. */ + IndicesType& indices() { return derived().indices(); } + + /** Resizes to given size. + */ + inline void resize(Index newSize) { indices().resize(newSize); } + + /** Sets *this to be the identity permutation matrix */ + void setIdentity() { + StorageIndex n = StorageIndex(size()); + for (StorageIndex i = 0; i < n; ++i) indices().coeffRef(i) = i; + } + + /** Sets *this to be the identity permutation matrix of given size. + */ + void setIdentity(Index newSize) { + resize(newSize); + setIdentity(); + } + + /** Multiplies *this by the transposition \f$(ij)\f$ on the left. + * + * \returns a reference to *this. + * + * \warning This is much slower than applyTranspositionOnTheRight(Index,Index): + * this has linear complexity and requires a lot of branching. + * + * \sa applyTranspositionOnTheRight(Index,Index) + */ + Derived& applyTranspositionOnTheLeft(Index i, Index j) { + eigen_assert(i >= 0 && j >= 0 && i < size() && j < size()); + for (Index k = 0; k < size(); ++k) { + if (indices().coeff(k) == i) + indices().coeffRef(k) = StorageIndex(j); + else if (indices().coeff(k) == j) + indices().coeffRef(k) = StorageIndex(i); + } + return derived(); + } + + /** Multiplies *this by the transposition \f$(ij)\f$ on the right. + * + * \returns a reference to *this. + * + * This is a fast operation, it only consists in swapping two indices. + * + * \sa applyTranspositionOnTheLeft(Index,Index) + */ + Derived& applyTranspositionOnTheRight(Index i, Index j) { + eigen_assert(i >= 0 && j >= 0 && i < size() && j < size()); + std::swap(indices().coeffRef(i), indices().coeffRef(j)); + return derived(); + } + + /** \returns the inverse permutation matrix. + * + * \note \blank \note_try_to_help_rvo + */ + inline InverseReturnType inverse() const { return InverseReturnType(derived()); } + /** \returns the transpose permutation matrix. + * + * \note \blank \note_try_to_help_rvo + */ + inline InverseReturnType transpose() const { return InverseReturnType(derived()); } + + /**** multiplication helpers to hopefully get RVO ****/ + +#ifndef EIGEN_PARSED_BY_DOXYGEN + protected: + template + void assignTranspose(const PermutationBase& other) { + for (Index i = 0; i < rows(); ++i) indices().coeffRef(other.indices().coeff(i)) = i; + } + template + void assignProduct(const Lhs& lhs, const Rhs& rhs) { + eigen_assert(lhs.cols() == rhs.rows()); + for (Index i = 0; i < rows(); ++i) indices().coeffRef(i) = lhs.indices().coeff(rhs.indices().coeff(i)); + } +#endif + + public: + /** \returns the product permutation matrix. + * + * \note \blank \note_try_to_help_rvo + */ + template + inline PlainPermutationType operator*(const PermutationBase& other) const { + return PlainPermutationType(internal::PermPermProduct, derived(), other.derived()); + } + + /** \returns the product of a permutation with another inverse permutation. + * + * \note \blank \note_try_to_help_rvo + */ + template + inline PlainPermutationType operator*(const InverseImpl& other) const { + return PlainPermutationType(internal::PermPermProduct, *this, other.eval()); + } + + /** \returns the product of an inverse permutation with another permutation. + * + * \note \blank \note_try_to_help_rvo + */ + template + friend inline PlainPermutationType operator*(const InverseImpl& other, + const PermutationBase& perm) { + return PlainPermutationType(internal::PermPermProduct, other.eval(), perm); + } + + /** \returns the determinant of the permutation matrix, which is either 1 or -1 depending on the parity of the + * permutation. + * + * This function is O(\c n) procedure allocating a buffer of \c n booleans. + */ + Index determinant() const { + Index res = 1; + Index n = size(); + Matrix mask(n); + mask.fill(false); + Index r = 0; + while (r < n) { + // search for the next seed + while (r < n && mask[r]) r++; + if (r >= n) break; + // we got one, let's follow it until we are back to the seed + Index k0 = r++; + mask.coeffRef(k0) = true; + for (Index k = indices().coeff(k0); k != k0; k = indices().coeff(k)) { + mask.coeffRef(k) = true; + res = -res; + } + } + return res; + } + + protected: +}; + +namespace internal { +template +struct traits > + : traits< + Matrix > { + typedef PermutationStorage StorageKind; + typedef Matrix IndicesType; + typedef StorageIndex_ StorageIndex; + typedef void Scalar; +}; +} // namespace internal + +/** \class PermutationMatrix + * \ingroup Core_Module + * + * \brief Permutation matrix + * + * \tparam SizeAtCompileTime the number of rows/cols, or Dynamic + * \tparam MaxSizeAtCompileTime the maximum number of rows/cols, or Dynamic. This optional parameter defaults to + * SizeAtCompileTime. Most of the time, you should not have to specify it. \tparam StorageIndex_ the integer type of the + * indices + * + * This class represents a permutation matrix, internally stored as a vector of integers. + * + * \sa class PermutationBase, class PermutationWrapper, class DiagonalMatrix + */ +template +class PermutationMatrix + : public PermutationBase > { + typedef PermutationBase Base; + typedef internal::traits Traits; + + public: + typedef const PermutationMatrix& Nested; + +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + typedef typename Traits::StorageIndex StorageIndex; +#endif + + inline PermutationMatrix() {} + + /** Constructs an uninitialized permutation matrix of given size. + */ + explicit inline PermutationMatrix(Index size) : m_indices(size) { + eigen_internal_assert(size <= NumTraits::highest()); + } + + /** Copy constructor. */ + template + inline PermutationMatrix(const PermutationBase& other) : m_indices(other.indices()) {} + + /** Generic constructor from expression of the indices. The indices + * array has the meaning that the permutations sends each integer i to indices[i]. + * + * \warning It is your responsibility to check that the indices array that you passes actually + * describes a permutation, i.e., each value between 0 and n-1 occurs exactly once, where n is the + * array's size. + */ + template + explicit inline PermutationMatrix(const MatrixBase& indices) : m_indices(indices) {} + + /** Convert the Transpositions \a tr to a permutation matrix */ + template + explicit PermutationMatrix(const TranspositionsBase& tr) : m_indices(tr.size()) { + *this = tr; + } + + /** Copies the other permutation into *this */ + template + PermutationMatrix& operator=(const PermutationBase& other) { + m_indices = other.indices(); + return *this; + } + + /** Assignment from the Transpositions \a tr */ + template + PermutationMatrix& operator=(const TranspositionsBase& tr) { + return Base::operator=(tr.derived()); + } + + /** const version of indices(). */ + const IndicesType& indices() const { return m_indices; } + /** \returns a reference to the stored array representing the permutation. */ + IndicesType& indices() { return m_indices; } + + /**** multiplication helpers to hopefully get RVO ****/ + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + PermutationMatrix(const InverseImpl& other) + : m_indices(other.derived().nestedExpression().size()) { + eigen_internal_assert(m_indices.size() <= NumTraits::highest()); + StorageIndex end = StorageIndex(m_indices.size()); + for (StorageIndex i = 0; i < end; ++i) + m_indices.coeffRef(other.derived().nestedExpression().indices().coeff(i)) = i; + } + template + PermutationMatrix(internal::PermPermProduct_t, const Lhs& lhs, const Rhs& rhs) : m_indices(lhs.indices().size()) { + Base::assignProduct(lhs, rhs); + } +#endif + + protected: + IndicesType m_indices; +}; + +namespace internal { +template +struct traits, PacketAccess_> > + : traits< + Matrix > { + typedef PermutationStorage StorageKind; + typedef Map, PacketAccess_> IndicesType; + typedef StorageIndex_ StorageIndex; + typedef void Scalar; +}; +} // namespace internal + +template +class Map, PacketAccess_> + : public PermutationBase< + Map, PacketAccess_> > { + typedef PermutationBase Base; + typedef internal::traits Traits; + + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + typedef typename IndicesType::Scalar StorageIndex; +#endif + + inline Map(const StorageIndex* indicesPtr) : m_indices(indicesPtr) {} + + inline Map(const StorageIndex* indicesPtr, Index size) : m_indices(indicesPtr, size) {} + + /** Copies the other permutation into *this */ + template + Map& operator=(const PermutationBase& other) { + return Base::operator=(other.derived()); + } + + /** Assignment from the Transpositions \a tr */ + template + Map& operator=(const TranspositionsBase& tr) { + return Base::operator=(tr.derived()); + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + Map& operator=(const Map& other) { + m_indices = other.m_indices; + return *this; + } +#endif + + /** const version of indices(). */ + const IndicesType& indices() const { return m_indices; } + /** \returns a reference to the stored array representing the permutation. */ + IndicesType& indices() { return m_indices; } + + protected: + IndicesType m_indices; +}; + +template +class TranspositionsWrapper; +namespace internal { +template +struct traits > { + typedef PermutationStorage StorageKind; + typedef void Scalar; + typedef typename IndicesType_::Scalar StorageIndex; + typedef IndicesType_ IndicesType; + enum { + RowsAtCompileTime = IndicesType_::SizeAtCompileTime, + ColsAtCompileTime = IndicesType_::SizeAtCompileTime, + MaxRowsAtCompileTime = IndicesType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = IndicesType::MaxSizeAtCompileTime, + Flags = 0 + }; +}; +} // namespace internal + +/** \class PermutationWrapper + * \ingroup Core_Module + * + * \brief Class to view a vector of integers as a permutation matrix + * + * \tparam IndicesType_ the type of the vector of integer (can be any compatible expression) + * + * This class allows to view any vector expression of integers as a permutation matrix. + * + * \sa class PermutationBase, class PermutationMatrix + */ +template +class PermutationWrapper : public PermutationBase > { + typedef PermutationBase Base; + typedef internal::traits Traits; + + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; +#endif + + inline PermutationWrapper(const IndicesType& indices) : m_indices(indices) {} + + /** const version of indices(). */ + const internal::remove_all_t& indices() const { return m_indices; } + + protected: + typename IndicesType::Nested m_indices; +}; + +/** \returns the matrix with the permutation applied to the columns. + */ +template +EIGEN_DEVICE_FUNC const Product operator*( + const MatrixBase& matrix, const PermutationBase& permutation) { + return Product(matrix.derived(), permutation.derived()); +} + +/** \returns the matrix with the permutation applied to the rows. + */ +template +EIGEN_DEVICE_FUNC const Product operator*( + const PermutationBase& permutation, const MatrixBase& matrix) { + return Product(permutation.derived(), matrix.derived()); +} + +template +class InverseImpl : public EigenBase > { + typedef typename PermutationType::PlainPermutationType PlainPermutationType; + typedef internal::traits PermTraits; + + protected: + InverseImpl() {} + + public: + typedef Inverse InverseType; + using EigenBase >::derived; + +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename PermutationType::DenseMatrixType DenseMatrixType; + enum { + RowsAtCompileTime = PermTraits::RowsAtCompileTime, + ColsAtCompileTime = PermTraits::ColsAtCompileTime, + MaxRowsAtCompileTime = PermTraits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = PermTraits::MaxColsAtCompileTime + }; +#endif + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + void evalTo(MatrixBase& other) const { + other.setZero(); + for (Index i = 0; i < derived().rows(); ++i) + other.coeffRef(i, derived().nestedExpression().indices().coeff(i)) = typename DenseDerived::Scalar(1); + } +#endif + + /** \return the equivalent permutation matrix */ + PlainPermutationType eval() const { return derived(); } + + DenseMatrixType toDenseMatrix() const { return derived(); } + + /** \returns the matrix with the inverse permutation applied to the columns. + */ + template + friend const Product operator*(const MatrixBase& matrix, + const InverseType& trPerm) { + return Product(matrix.derived(), trPerm.derived()); + } + + /** \returns the matrix with the inverse permutation applied to the rows. + */ + template + const Product operator*(const MatrixBase& matrix) const { + return Product(derived(), matrix.derived()); + } +}; + +template +const PermutationWrapper MatrixBase::asPermutation() const { + return derived(); +} + +namespace internal { + +template <> +struct AssignmentKind { + typedef EigenBase2EigenBase Kind; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PERMUTATIONMATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/PlainObjectBase.h b/src/3rdparty/eigen/Eigen/src/Core/PlainObjectBase.h new file mode 100644 index 0000000..a78305e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/PlainObjectBase.h @@ -0,0 +1,1014 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2009 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSESTORAGEBASE_H +#define EIGEN_DENSESTORAGEBASE_H + +#if defined(EIGEN_INITIALIZE_MATRICES_BY_ZERO) +#define EIGEN_INITIALIZE_COEFFS +#define EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED \ + for (Index i = 0; i < base().size(); ++i) coeffRef(i) = Scalar(0); +#elif defined(EIGEN_INITIALIZE_MATRICES_BY_NAN) +#define EIGEN_INITIALIZE_COEFFS +#define EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED \ + for (Index i = 0; i < base().size(); ++i) coeffRef(i) = std::numeric_limits::quiet_NaN(); +#else +#undef EIGEN_INITIALIZE_COEFFS +#define EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED +#endif + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +#ifndef EIGEN_NO_DEBUG +template +struct check_rows_cols_for_overflow { + EIGEN_STATIC_ASSERT(MaxRowsAtCompileTime* MaxColsAtCompileTime == MaxSizeAtCompileTime, + YOU MADE A PROGRAMMING MISTAKE) + template + EIGEN_DEVICE_FUNC static EIGEN_ALWAYS_INLINE constexpr void run(Index, Index) {} +}; + +template +struct check_rows_cols_for_overflow { + template + EIGEN_DEVICE_FUNC static EIGEN_ALWAYS_INLINE constexpr void run(Index, Index cols) { + constexpr Index MaxIndex = NumTraits::highest(); + bool error = cols > (MaxIndex / MaxRowsAtCompileTime); + if (error) throw_std_bad_alloc(); + } +}; + +template +struct check_rows_cols_for_overflow { + template + EIGEN_DEVICE_FUNC static EIGEN_ALWAYS_INLINE constexpr void run(Index rows, Index) { + constexpr Index MaxIndex = NumTraits::highest(); + bool error = rows > (MaxIndex / MaxColsAtCompileTime); + if (error) throw_std_bad_alloc(); + } +}; + +template <> +struct check_rows_cols_for_overflow { + template + EIGEN_DEVICE_FUNC static EIGEN_ALWAYS_INLINE constexpr void run(Index rows, Index cols) { + constexpr Index MaxIndex = NumTraits::highest(); + bool error = cols == 0 ? false : (rows > (MaxIndex / cols)); + if (error) throw_std_bad_alloc(); + } +}; +#endif + +template +struct conservative_resize_like_impl; + +template +struct matrix_swap_impl; + +} // end namespace internal + +/** \class PlainObjectBase + * \ingroup Core_Module + * \brief %Dense storage base class for matrices and arrays. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_PLAINOBJECTBASE_PLUGIN. + * + * \tparam Derived is the derived type, e.g., a Matrix or Array + * + * \sa \ref TopicClassHierarchy + */ +template +class PlainObjectBase : public internal::dense_xpr_base::type { + public: + enum { Options = internal::traits::Options }; + typedef typename internal::dense_xpr_base::type Base; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + typedef Derived DenseType; + + using Base::ColsAtCompileTime; + using Base::Flags; + using Base::IsVectorAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::RowsAtCompileTime; + using Base::SizeAtCompileTime; + + typedef Eigen::Map MapType; + typedef const Eigen::Map ConstMapType; + typedef Eigen::Map AlignedMapType; + typedef const Eigen::Map ConstAlignedMapType; + template + struct StridedMapType { + typedef Eigen::Map type; + }; + template + struct StridedConstMapType { + typedef Eigen::Map type; + }; + template + struct StridedAlignedMapType { + typedef Eigen::Map type; + }; + template + struct StridedConstAlignedMapType { + typedef Eigen::Map type; + }; + + protected: + DenseStorage m_storage; + + public: + enum { NeedsToAlign = (SizeAtCompileTime != Dynamic) && (internal::traits::Alignment > 0) }; + EIGEN_MAKE_ALIGNED_OPERATOR_NEW_IF(NeedsToAlign) + + EIGEN_STATIC_ASSERT(internal::check_implication(MaxRowsAtCompileTime == 1 && MaxColsAtCompileTime != 1, + (int(Options) & RowMajor) == RowMajor), + INVALID_MATRIX_TEMPLATE_PARAMETERS) + EIGEN_STATIC_ASSERT(internal::check_implication(MaxColsAtCompileTime == 1 && MaxRowsAtCompileTime != 1, + (int(Options) & RowMajor) == 0), + INVALID_MATRIX_TEMPLATE_PARAMETERS) + EIGEN_STATIC_ASSERT((RowsAtCompileTime == Dynamic) || (RowsAtCompileTime >= 0), INVALID_MATRIX_TEMPLATE_PARAMETERS) + EIGEN_STATIC_ASSERT((ColsAtCompileTime == Dynamic) || (ColsAtCompileTime >= 0), INVALID_MATRIX_TEMPLATE_PARAMETERS) + EIGEN_STATIC_ASSERT((MaxRowsAtCompileTime == Dynamic) || (MaxRowsAtCompileTime >= 0), + INVALID_MATRIX_TEMPLATE_PARAMETERS) + EIGEN_STATIC_ASSERT((MaxColsAtCompileTime == Dynamic) || (MaxColsAtCompileTime >= 0), + INVALID_MATRIX_TEMPLATE_PARAMETERS) + EIGEN_STATIC_ASSERT((MaxRowsAtCompileTime == RowsAtCompileTime || RowsAtCompileTime == Dynamic), + INVALID_MATRIX_TEMPLATE_PARAMETERS) + EIGEN_STATIC_ASSERT((MaxColsAtCompileTime == ColsAtCompileTime || ColsAtCompileTime == Dynamic), + INVALID_MATRIX_TEMPLATE_PARAMETERS) + EIGEN_STATIC_ASSERT(((Options & (DontAlign | RowMajor)) == Options), INVALID_MATRIX_TEMPLATE_PARAMETERS) + + EIGEN_DEVICE_FUNC Base& base() { return *static_cast(this); } + EIGEN_DEVICE_FUNC const Base& base() const { return *static_cast(this); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const noexcept { return m_storage.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const noexcept { return m_storage.cols(); } + + /** This is an overloaded version of DenseCoeffsBase::coeff(Index,Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeff(Index) const for details. */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const Scalar& coeff(Index rowId, Index colId) const { + if (Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeff(Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeff(Index) const for details. */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const Scalar& coeff(Index index) const { + return m_storage.data()[index]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeffRef(Index,Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeffRef(Index,Index) const for details. */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& coeffRef(Index rowId, Index colId) { + if (Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeffRef(Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeffRef(Index) const for details. */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Scalar& coeffRef(Index index) { return m_storage.data()[index]; } + + /** This is the const version of coeffRef(Index,Index) which is thus synonym of coeff(Index,Index). + * It is provided for convenience. */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const Scalar& coeffRef(Index rowId, Index colId) const { + if (Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is the const version of coeffRef(Index) which is thus synonym of coeff(Index). + * It is provided for convenience. */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const Scalar& coeffRef(Index index) const { + return m_storage.data()[index]; + } + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketScalar packet(Index rowId, Index colId) const { + return internal::ploadt( + m_storage.data() + (Flags & RowMajorBit ? colId + rowId * m_storage.cols() : rowId + colId * m_storage.rows())); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketScalar packet(Index index) const { + return internal::ploadt(m_storage.data() + index); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE void writePacket(Index rowId, Index colId, const PacketScalar& val) { + internal::pstoret( + m_storage.data() + (Flags & RowMajorBit ? colId + rowId * m_storage.cols() : rowId + colId * m_storage.rows()), + val); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE void writePacket(Index index, const PacketScalar& val) { + internal::pstoret(m_storage.data() + index, val); + } + + /** \returns a const pointer to the data array of this matrix */ + EIGEN_DEVICE_FUNC constexpr const Scalar* data() const { return m_storage.data(); } + + /** \returns a pointer to the data array of this matrix */ + EIGEN_DEVICE_FUNC constexpr Scalar* data() { return m_storage.data(); } + + /** Resizes \c *this to a \a rows x \a cols matrix. + * + * This method is intended for dynamic-size matrices, although it is legal to call it on any + * matrix as long as fixed dimensions are left unchanged. If you only want to change the number + * of rows and/or of columns, you can use resize(NoChange_t, Index), resize(Index, NoChange_t). + * + * If the current number of coefficients of \c *this exactly matches the + * product \a rows * \a cols, then no memory allocation is performed and + * the current values are left unchanged. In all other cases, including + * shrinking, the data is reallocated and all previous values are lost. + * + * Example: \include Matrix_resize_int_int.cpp + * Output: \verbinclude Matrix_resize_int_int.out + * + * \sa resize(Index) for vectors, resize(NoChange_t, Index), resize(Index, NoChange_t) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr void resize(Index rows, Index cols) { + eigen_assert(internal::check_implication(RowsAtCompileTime != Dynamic, rows == RowsAtCompileTime) && + internal::check_implication(ColsAtCompileTime != Dynamic, cols == ColsAtCompileTime) && + internal::check_implication(RowsAtCompileTime == Dynamic && MaxRowsAtCompileTime != Dynamic, + rows <= MaxRowsAtCompileTime) && + internal::check_implication(ColsAtCompileTime == Dynamic && MaxColsAtCompileTime != Dynamic, + cols <= MaxColsAtCompileTime) && + rows >= 0 && cols >= 0 && "Invalid sizes when resizing a matrix or array."); +#ifndef EIGEN_NO_DEBUG + internal::check_rows_cols_for_overflow::run(rows, + cols); +#endif +#ifdef EIGEN_INITIALIZE_COEFFS + Index size = rows * cols; + bool size_changed = size != this->size(); + m_storage.resize(size, rows, cols); + if (size_changed) EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED +#else + m_storage.resize(rows * cols, rows, cols); +#endif + } + + /** Resizes \c *this to a vector of length \a size + * + * \only_for_vectors. This method does not work for + * partially dynamic matrices when the static dimension is anything other + * than 1. For example it will not work with Matrix. + * + * Example: \include Matrix_resize_int.cpp + * Output: \verbinclude Matrix_resize_int.out + * + * \sa resize(Index,Index), resize(NoChange_t, Index), resize(Index, NoChange_t) + */ + EIGEN_DEVICE_FUNC constexpr void resize(Index size) { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(PlainObjectBase) + eigen_assert(((SizeAtCompileTime == Dynamic && (MaxSizeAtCompileTime == Dynamic || size <= MaxSizeAtCompileTime)) || + SizeAtCompileTime == size) && + size >= 0); +#ifdef EIGEN_INITIALIZE_COEFFS + bool size_changed = size != this->size(); +#endif + if (RowsAtCompileTime == 1) + m_storage.resize(size, 1, size); + else + m_storage.resize(size, size, 1); +#ifdef EIGEN_INITIALIZE_COEFFS + if (size_changed) EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED +#endif + } + + /** Resizes the matrix, changing only the number of columns. For the parameter of type NoChange_t, just pass the + * special value \c NoChange as in the example below. + * + * Example: \include Matrix_resize_NoChange_int.cpp + * Output: \verbinclude Matrix_resize_NoChange_int.out + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC constexpr void resize(NoChange_t, Index cols) { resize(rows(), cols); } + + /** Resizes the matrix, changing only the number of rows. For the parameter of type NoChange_t, just pass the special + * value \c NoChange as in the example below. + * + * Example: \include Matrix_resize_int_NoChange.cpp + * Output: \verbinclude Matrix_resize_int_NoChange.out + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC constexpr void resize(Index rows, NoChange_t) { resize(rows, cols()); } + + /** Resizes \c *this to have the same dimensions as \a other. + * Takes care of doing all the checking that's needed. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void resizeLike(const EigenBase& _other) { + const OtherDerived& other = _other.derived(); +#ifndef EIGEN_NO_DEBUG + internal::check_rows_cols_for_overflow::run( + other.rows(), other.cols()); +#endif + const Index othersize = other.rows() * other.cols(); + if (RowsAtCompileTime == 1) { + eigen_assert(other.rows() == 1 || other.cols() == 1); + resize(1, othersize); + } else if (ColsAtCompileTime == 1) { + eigen_assert(other.rows() == 1 || other.cols() == 1); + resize(othersize, 1); + } else + resize(other.rows(), other.cols()); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * The method is intended for matrices of dynamic size. If you only want to change the number + * of rows and/or of columns, you can use conservativeResize(NoChange_t, Index) or + * conservativeResize(Index, NoChange_t). + * + * Matrices are resized relative to the top-left element. In case values need to be + * appended to the matrix they will be uninitialized. + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void conservativeResize(Index rows, Index cols) { + internal::conservative_resize_like_impl::run(*this, rows, cols); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * As opposed to conservativeResize(Index rows, Index cols), this version leaves + * the number of columns unchanged. + * + * In case the matrix is growing, new rows will be uninitialized. + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void conservativeResize(Index rows, NoChange_t) { + // Note: see the comment in conservativeResize(Index,Index) + conservativeResize(rows, cols()); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * As opposed to conservativeResize(Index rows, Index cols), this version leaves + * the number of rows unchanged. + * + * In case the matrix is growing, new columns will be uninitialized. + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void conservativeResize(NoChange_t, Index cols) { + // Note: see the comment in conservativeResize(Index,Index) + conservativeResize(rows(), cols); + } + + /** Resizes the vector to \a size while retaining old values. + * + * \only_for_vectors. This method does not work for + * partially dynamic matrices when the static dimension is anything other + * than 1. For example it will not work with Matrix. + * + * When values are appended, they will be uninitialized. + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void conservativeResize(Index size) { + internal::conservative_resize_like_impl::run(*this, size); + } + + /** Resizes the matrix to \a rows x \a cols of \c other, while leaving old values untouched. + * + * The method is intended for matrices of dynamic size. If you only want to change the number + * of rows and/or of columns, you can use conservativeResize(NoChange_t, Index) or + * conservativeResize(Index, NoChange_t). + * + * Matrices are resized relative to the top-left element. In case values need to be + * appended to the matrix they will copied from \c other. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void conservativeResizeLike(const DenseBase& other) { + internal::conservative_resize_like_impl::run(*this, other); + } + + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Derived& operator=(const PlainObjectBase& other) { + return _set(other); + } + + /** \sa MatrixBase::lazyAssign() */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& lazyAssign(const DenseBase& other) { + _resize_to_match(other); + return Base::lazyAssign(other.derived()); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const ReturnByValue& func) { + resize(func.rows(), func.cols()); + return Base::operator=(func); + } + + // Prevent user from trying to instantiate PlainObjectBase objects + // by making all its constructor protected. See bug 1074. + protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr PlainObjectBase() = default; + /** \brief Move constructor */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr PlainObjectBase(PlainObjectBase&&) = default; + /** \brief Move assignment operator */ + EIGEN_DEVICE_FUNC constexpr PlainObjectBase& operator=(PlainObjectBase&& other) noexcept { + m_storage = std::move(other.m_storage); + return *this; + } + + /** Copy constructor */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr PlainObjectBase(const PlainObjectBase&) = default; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PlainObjectBase(Index size, Index rows, Index cols) + : m_storage(size, rows, cols) {} + + /** \brief Construct a row of column vector with fixed size from an arbitrary number of coefficients. + * + * \only_for_vectors + * + * This constructor is for 1D array or vectors with more than 4 coefficients. + * + * \warning To construct a column (resp. row) vector of fixed length, the number of values passed to this + * constructor must match the the fixed number of rows (resp. columns) of \c *this. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PlainObjectBase(const Scalar& a0, const Scalar& a1, const Scalar& a2, + const Scalar& a3, const ArgTypes&... args) + : m_storage() { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, sizeof...(args) + 4); + m_storage.data()[0] = a0; + m_storage.data()[1] = a1; + m_storage.data()[2] = a2; + m_storage.data()[3] = a3; + Index i = 4; + auto x = {(m_storage.data()[i++] = args, 0)...}; + static_cast(x); + } + + /** \brief Constructs a Matrix or Array and initializes it by elements given by an initializer list of initializer + * lists + */ + EIGEN_DEVICE_FUNC explicit constexpr EIGEN_STRONG_INLINE PlainObjectBase( + const std::initializer_list>& list) + : m_storage() { + size_t list_size = 0; + if (list.begin() != list.end()) { + list_size = list.begin()->size(); + } + + // This is to allow syntax like VectorXi {{1, 2, 3, 4}} + if (ColsAtCompileTime == 1 && list.size() == 1) { + eigen_assert(list_size == static_cast(RowsAtCompileTime) || RowsAtCompileTime == Dynamic); + resize(list_size, ColsAtCompileTime); + if (list.begin()->begin() != nullptr) { + Index index = 0; + for (const Scalar& e : *list.begin()) { + coeffRef(index++) = e; + } + } + } else { + eigen_assert(list.size() == static_cast(RowsAtCompileTime) || RowsAtCompileTime == Dynamic); + eigen_assert(list_size == static_cast(ColsAtCompileTime) || ColsAtCompileTime == Dynamic); + resize(list.size(), list_size); + + Index row_index = 0; + for (const std::initializer_list& row : list) { + eigen_assert(list_size == row.size()); + Index col_index = 0; + for (const Scalar& e : row) { + coeffRef(row_index, col_index) = e; + ++col_index; + } + ++row_index; + } + } + } + + /** \sa PlainObjectBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PlainObjectBase(const DenseBase& other) : m_storage() { + resizeLike(other); + _set_noalias(other); + } + + /** \sa PlainObjectBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PlainObjectBase(const EigenBase& other) : m_storage() { + resizeLike(other); + *this = other.derived(); + } + /** \brief Copy constructor with in-place evaluation */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PlainObjectBase(const ReturnByValue& other) { + // FIXME this does not automatically transpose vectors if necessary + resize(other.rows(), other.cols()); + other.evalTo(this->derived()); + } + + public: + /** \brief Copies the generic expression \a other into *this. + * \copydetails DenseBase::operator=(const EigenBase &other) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& operator=(const EigenBase& other) { + _resize_to_match(other); + Base::operator=(other.derived()); + return this->derived(); + } + + /** \name Map + * These are convenience functions returning Map objects. The Map() static functions return unaligned Map objects, + * while the AlignedMap() functions return aligned Map objects and thus should be called only with 16-byte-aligned + * \a data pointers. + * + * Here is an example using strides: + * \include Matrix_Map_stride.cpp + * Output: \verbinclude Matrix_Map_stride.out + * + * \see class Map + */ + ///@{ + static inline ConstMapType Map(const Scalar* data) { return ConstMapType(data); } + static inline MapType Map(Scalar* data) { return MapType(data); } + static inline ConstMapType Map(const Scalar* data, Index size) { return ConstMapType(data, size); } + static inline MapType Map(Scalar* data, Index size) { return MapType(data, size); } + static inline ConstMapType Map(const Scalar* data, Index rows, Index cols) { return ConstMapType(data, rows, cols); } + static inline MapType Map(Scalar* data, Index rows, Index cols) { return MapType(data, rows, cols); } + + static inline ConstAlignedMapType MapAligned(const Scalar* data) { return ConstAlignedMapType(data); } + static inline AlignedMapType MapAligned(Scalar* data) { return AlignedMapType(data); } + static inline ConstAlignedMapType MapAligned(const Scalar* data, Index size) { + return ConstAlignedMapType(data, size); + } + static inline AlignedMapType MapAligned(Scalar* data, Index size) { return AlignedMapType(data, size); } + static inline ConstAlignedMapType MapAligned(const Scalar* data, Index rows, Index cols) { + return ConstAlignedMapType(data, rows, cols); + } + static inline AlignedMapType MapAligned(Scalar* data, Index rows, Index cols) { + return AlignedMapType(data, rows, cols); + } + + template + static inline typename StridedConstMapType>::type Map(const Scalar* data, + const Stride& stride) { + return typename StridedConstMapType>::type(data, stride); + } + template + static inline typename StridedMapType>::type Map(Scalar* data, + const Stride& stride) { + return typename StridedMapType>::type(data, stride); + } + template + static inline typename StridedConstMapType>::type Map(const Scalar* data, Index size, + const Stride& stride) { + return typename StridedConstMapType>::type(data, size, stride); + } + template + static inline typename StridedMapType>::type Map(Scalar* data, Index size, + const Stride& stride) { + return typename StridedMapType>::type(data, size, stride); + } + template + static inline typename StridedConstMapType>::type Map(const Scalar* data, Index rows, Index cols, + const Stride& stride) { + return typename StridedConstMapType>::type(data, rows, cols, stride); + } + template + static inline typename StridedMapType>::type Map(Scalar* data, Index rows, Index cols, + const Stride& stride) { + return typename StridedMapType>::type(data, rows, cols, stride); + } + + template + static inline typename StridedConstAlignedMapType>::type MapAligned( + const Scalar* data, const Stride& stride) { + return typename StridedConstAlignedMapType>::type(data, stride); + } + template + static inline typename StridedAlignedMapType>::type MapAligned( + Scalar* data, const Stride& stride) { + return typename StridedAlignedMapType>::type(data, stride); + } + template + static inline typename StridedConstAlignedMapType>::type MapAligned( + const Scalar* data, Index size, const Stride& stride) { + return typename StridedConstAlignedMapType>::type(data, size, stride); + } + template + static inline typename StridedAlignedMapType>::type MapAligned( + Scalar* data, Index size, const Stride& stride) { + return typename StridedAlignedMapType>::type(data, size, stride); + } + template + static inline typename StridedConstAlignedMapType>::type MapAligned( + const Scalar* data, Index rows, Index cols, const Stride& stride) { + return typename StridedConstAlignedMapType>::type(data, rows, cols, stride); + } + template + static inline typename StridedAlignedMapType>::type MapAligned( + Scalar* data, Index rows, Index cols, const Stride& stride) { + return typename StridedAlignedMapType>::type(data, rows, cols, stride); + } + ///@} + + using Base::setConstant; + EIGEN_DEVICE_FUNC Derived& setConstant(Index size, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(Index rows, Index cols, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(NoChange_t, Index cols, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(Index rows, NoChange_t, const Scalar& val); + + using Base::setZero; + EIGEN_DEVICE_FUNC Derived& setZero(Index size); + EIGEN_DEVICE_FUNC Derived& setZero(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setZero(NoChange_t, Index cols); + EIGEN_DEVICE_FUNC Derived& setZero(Index rows, NoChange_t); + + using Base::setOnes; + EIGEN_DEVICE_FUNC Derived& setOnes(Index size); + EIGEN_DEVICE_FUNC Derived& setOnes(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setOnes(NoChange_t, Index cols); + EIGEN_DEVICE_FUNC Derived& setOnes(Index rows, NoChange_t); + + using Base::setRandom; + Derived& setRandom(Index size); + Derived& setRandom(Index rows, Index cols); + Derived& setRandom(NoChange_t, Index cols); + Derived& setRandom(Index rows, NoChange_t); + +#ifdef EIGEN_PLAINOBJECTBASE_PLUGIN +#include EIGEN_PLAINOBJECTBASE_PLUGIN +#endif + + protected: + /** \internal Resizes *this in preparation for assigning \a other to it. + * Takes care of doing all the checking that's needed. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _resize_to_match(const EigenBase& other) { +#ifdef EIGEN_NO_AUTOMATIC_RESIZING + eigen_assert((this->size() == 0 || (IsVectorAtCompileTime ? (this->size() == other.size()) + : (rows() == other.rows() && cols() == other.cols()))) && + "Size mismatch. Automatic resizing is disabled because EIGEN_NO_AUTOMATIC_RESIZING is defined"); + EIGEN_ONLY_USED_FOR_DEBUG(other); +#else + resizeLike(other); +#endif + } + + /** + * \brief Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + * + * \sa operator=(const MatrixBase&), _set_noalias() + * + * \internal + */ + // aliasing is dealt once in internal::call_assignment + // so at this stage we have to assume aliasing... and resising has to be done later. + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Derived& _set(const DenseBase& other) { + internal::call_assignment(this->derived(), other.derived()); + return this->derived(); + } + + /** \internal Like _set() but additionally makes the assumption that no aliasing effect can happen (which + * is the case when creating a new matrix) so one can enforce lazy evaluation. + * + * \sa operator=(const MatrixBase&), _set() + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Derived& _set_noalias(const DenseBase& other) { + // I don't think we need this resize call since the lazyAssign will anyways resize + // and lazyAssign will be called by the assign selector. + //_resize_to_match(other); + // the 'false' below means to enforce lazy evaluation. We don't use lazyAssign() because + // it wouldn't allow to copy a row-vector into a column-vector. + internal::call_assignment_no_alias(this->derived(), other.derived(), + internal::assign_op()); + return this->derived(); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init2(Index rows, Index cols, + std::enable_if_t* = 0) { + EIGEN_STATIC_ASSERT(internal::is_valid_index_type::value && internal::is_valid_index_type::value, + T0 AND T1 MUST BE INTEGER TYPES) + resize(rows, cols); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init2(const T0& val0, const T1& val1, + std::enable_if_t* = 0) { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 2) + m_storage.data()[0] = Scalar(val0); + m_storage.data()[1] = Scalar(val1); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init2( + const Index& val0, const Index& val1, + std::enable_if_t<(!internal::is_same::value) && (internal::is_same::value) && + (internal::is_same::value) && Base::SizeAtCompileTime == 2, + T1>* = 0) { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 2) + m_storage.data()[0] = Scalar(val0); + m_storage.data()[1] = Scalar(val1); + } + + // The argument is convertible to the Index type and we either have a non 1x1 Matrix, or a dynamic-sized Array, + // then the argument is meant to be the size of the object. + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1( + Index size, + std::enable_if_t<(Base::SizeAtCompileTime != 1 || !internal::is_convertible::value) && + ((!internal::is_same::XprKind, ArrayXpr>::value || + Base::SizeAtCompileTime == Dynamic)), + T>* = 0) { + // NOTE MSVC 2008 complains if we directly put bool(NumTraits::IsInteger) as the EIGEN_STATIC_ASSERT argument. + const bool is_integer_alike = internal::is_valid_index_type::value; + EIGEN_UNUSED_VARIABLE(is_integer_alike); + EIGEN_STATIC_ASSERT(is_integer_alike, FLOATING_POINT_ARGUMENT_PASSED__INTEGER_WAS_EXPECTED) + resize(size); + } + + // We have a 1x1 matrix/array => the argument is interpreted as the value of the unique coefficient (case where scalar + // type can be implicitly converted) + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1( + const Scalar& val0, + std::enable_if_t::value, T>* = 0) { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 1) + m_storage.data()[0] = val0; + } + + // We have a 1x1 matrix/array => the argument is interpreted as the value of the unique coefficient (case where scalar + // type match the index type) + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1( + const Index& val0, + std::enable_if_t<(!internal::is_same::value) && (internal::is_same::value) && + Base::SizeAtCompileTime == 1 && internal::is_convertible::value, + T*>* = 0) { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 1) + m_storage.data()[0] = Scalar(val0); + } + + // Initialize a fixed size matrix from a pointer to raw data + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1(const Scalar* data) { + this->_set_noalias(ConstMapType(data)); + } + + // Initialize an arbitrary matrix from a dense expression + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1(const DenseBase& other) { + this->_set_noalias(other); + } + + // Initialize an arbitrary matrix from an object convertible to the Derived type. + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1(const Derived& other) { + this->_set_noalias(other); + } + + // Initialize an arbitrary matrix from a generic Eigen expression + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1(const EigenBase& other) { + this->derived() = other; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1(const ReturnByValue& other) { + resize(other.rows(), other.cols()); + other.evalTo(this->derived()); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1(const RotationBase& r) { + this->derived() = r; + } + + // For fixed-size Array + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1( + const Scalar& val0, + std::enable_if_t::value && + internal::is_same::XprKind, ArrayXpr>::value, + T>* = 0) { + Base::setConstant(val0); + } + + // For fixed-size Array + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _init1( + const Index& val0, + std::enable_if_t<(!internal::is_same::value) && (internal::is_same::value) && + Base::SizeAtCompileTime != Dynamic && Base::SizeAtCompileTime != 1 && + internal::is_convertible::value && + internal::is_same::XprKind, ArrayXpr>::value, + T*>* = 0) { + Base::setConstant(val0); + } + + template + friend struct internal::matrix_swap_impl; + + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal + * \brief Override DenseBase::swap() since for dynamic-sized matrices + * of same type it is enough to swap the data pointers. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void swap(DenseBase& other) { + enum {SwapPointers = internal::is_same::value && Base::SizeAtCompileTime == Dynamic}; + internal::matrix_swap_impl::run(this->derived(), other.derived()); + } + + /** \internal + * \brief const version forwarded to DenseBase::swap + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void swap(DenseBase const& other) { + Base::swap(other.derived()); + } + + enum {IsPlainObjectBase = 1}; +#endif + public: + // These apparently need to be down here for nvcc+icc to prevent duplicate + // Map symbol. + template + friend class Eigen::Map; + friend class Eigen::Map; + friend class Eigen::Map; +#if EIGEN_MAX_ALIGN_BYTES > 0 + // for EIGEN_MAX_ALIGN_BYTES==0, AlignedMax==Unaligned, and many compilers generate warnings for friend-ing a class + // twice. + friend class Eigen::Map; + friend class Eigen::Map; +#endif +}; + +namespace internal { + +template +struct conservative_resize_like_impl { + static constexpr bool IsRelocatable = std::is_trivially_copyable::value; + static void run(DenseBase& _this, Index rows, Index cols) { + if (_this.rows() == rows && _this.cols() == cols) return; + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(Derived) + + if (IsRelocatable && + ((Derived::IsRowMajor && _this.cols() == cols) || // row-major and we change only the number of rows + (!Derived::IsRowMajor && _this.rows() == rows))) // column-major and we change only the number of columns + { +#ifndef EIGEN_NO_DEBUG + internal::check_rows_cols_for_overflow::run(rows, cols); +#endif + _this.derived().m_storage.conservativeResize(rows * cols, rows, cols); + } else { + // The storage order does not allow us to use reallocation. + Derived tmp(rows, cols); + const Index common_rows = numext::mini(rows, _this.rows()); + const Index common_cols = numext::mini(cols, _this.cols()); + tmp.block(0, 0, common_rows, common_cols) = _this.block(0, 0, common_rows, common_cols); + _this.derived().swap(tmp); + } + } + + static void run(DenseBase& _this, const DenseBase& other) { + if (_this.rows() == other.rows() && _this.cols() == other.cols()) return; + + // Note: Here is space for improvement. Basically, for conservativeResize(Index,Index), + // neither RowsAtCompileTime or ColsAtCompileTime must be Dynamic. If only one of the + // dimensions is dynamic, one could use either conservativeResize(Index rows, NoChange_t) or + // conservativeResize(NoChange_t, Index cols). For these methods new static asserts like + // EIGEN_STATIC_ASSERT_DYNAMIC_ROWS and EIGEN_STATIC_ASSERT_DYNAMIC_COLS would be good. + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(Derived) + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(OtherDerived) + + if (IsRelocatable && + ((Derived::IsRowMajor && _this.cols() == other.cols()) || // row-major and we change only the number of rows + (!Derived::IsRowMajor && + _this.rows() == other.rows()))) // column-major and we change only the number of columns + { + const Index new_rows = other.rows() - _this.rows(); + const Index new_cols = other.cols() - _this.cols(); + _this.derived().m_storage.conservativeResize(other.size(), other.rows(), other.cols()); + if (new_rows > 0) + _this.bottomRightCorner(new_rows, other.cols()) = other.bottomRows(new_rows); + else if (new_cols > 0) + _this.bottomRightCorner(other.rows(), new_cols) = other.rightCols(new_cols); + } else { + // The storage order does not allow us to use reallocation. + Derived tmp(other); + const Index common_rows = numext::mini(tmp.rows(), _this.rows()); + const Index common_cols = numext::mini(tmp.cols(), _this.cols()); + tmp.block(0, 0, common_rows, common_cols) = _this.block(0, 0, common_rows, common_cols); + _this.derived().swap(tmp); + } + } +}; + +// Here, the specialization for vectors inherits from the general matrix case +// to allow calling .conservativeResize(rows,cols) on vectors. +template +struct conservative_resize_like_impl + : conservative_resize_like_impl { + typedef conservative_resize_like_impl Base; + using Base::IsRelocatable; + using Base::run; + + static void run(DenseBase& _this, Index size) { + const Index new_rows = Derived::RowsAtCompileTime == 1 ? 1 : size; + const Index new_cols = Derived::RowsAtCompileTime == 1 ? size : 1; + if (IsRelocatable) + _this.derived().m_storage.conservativeResize(size, new_rows, new_cols); + else + Base::run(_this.derived(), new_rows, new_cols); + } + + static void run(DenseBase& _this, const DenseBase& other) { + if (_this.rows() == other.rows() && _this.cols() == other.cols()) return; + + const Index num_new_elements = other.size() - _this.size(); + + const Index new_rows = Derived::RowsAtCompileTime == 1 ? 1 : other.rows(); + const Index new_cols = Derived::RowsAtCompileTime == 1 ? other.cols() : 1; + if (IsRelocatable) + _this.derived().m_storage.conservativeResize(other.size(), new_rows, new_cols); + else + Base::run(_this.derived(), new_rows, new_cols); + + if (num_new_elements > 0) _this.tail(num_new_elements) = other.tail(num_new_elements); + } +}; + +template +struct matrix_swap_impl { + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(MatrixTypeA& a, MatrixTypeB& b) { a.base().swap(b); } +}; + +template +struct matrix_swap_impl { + EIGEN_DEVICE_FUNC static inline void run(MatrixTypeA& a, MatrixTypeB& b) { + static_cast(a).m_storage.swap(static_cast(b).m_storage); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DENSESTORAGEBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Product.h b/src/3rdparty/eigen/Eigen/src/Core/Product.h new file mode 100644 index 0000000..e16c7cc --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Product.h @@ -0,0 +1,307 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2011 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PRODUCT_H +#define EIGEN_PRODUCT_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +template +class ProductImpl; + +namespace internal { + +template +struct traits> { + typedef remove_all_t LhsCleaned; + typedef remove_all_t RhsCleaned; + typedef traits LhsTraits; + typedef traits RhsTraits; + + typedef MatrixXpr XprKind; + + typedef typename ScalarBinaryOpTraits::Scalar, + typename traits::Scalar>::ReturnType Scalar; + typedef typename product_promote_storage_type::ret>::ret StorageKind; + typedef typename promote_index_type::type + StorageIndex; + + enum { + RowsAtCompileTime = LhsTraits::RowsAtCompileTime, + ColsAtCompileTime = RhsTraits::ColsAtCompileTime, + MaxRowsAtCompileTime = LhsTraits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = RhsTraits::MaxColsAtCompileTime, + + // FIXME: only needed by GeneralMatrixMatrixTriangular + InnerSize = min_size_prefer_fixed(LhsTraits::ColsAtCompileTime, RhsTraits::RowsAtCompileTime), + + // The storage order is somewhat arbitrary here. The correct one will be determined through the evaluator. + Flags = (MaxRowsAtCompileTime == 1 && MaxColsAtCompileTime != 1) ? RowMajorBit + : (MaxColsAtCompileTime == 1 && MaxRowsAtCompileTime != 1) ? 0 + : (((LhsTraits::Flags & NoPreferredStorageOrderBit) && (RhsTraits::Flags & RowMajorBit)) || + ((RhsTraits::Flags & NoPreferredStorageOrderBit) && (LhsTraits::Flags & RowMajorBit))) + ? RowMajorBit + : NoPreferredStorageOrderBit + }; +}; + +struct TransposeProductEnum { + // convenience enumerations to specialize transposed products + enum : int { + Default = 0x00, + Matrix = 0x01, + Permutation = 0x02, + MatrixMatrix = (Matrix << 8) | Matrix, + MatrixPermutation = (Matrix << 8) | Permutation, + PermutationMatrix = (Permutation << 8) | Matrix + }; +}; +template +struct TransposeKind { + static constexpr int Kind = is_matrix_base_xpr::value ? TransposeProductEnum::Matrix + : is_permutation_base_xpr::value ? TransposeProductEnum::Permutation + : TransposeProductEnum::Default; +}; + +template +struct TransposeProductKind { + static constexpr int Kind = (TransposeKind::Kind << 8) | TransposeKind::Kind; +}; + +template ::Kind> +struct product_transpose_helper { + // by default, don't optimize the transposed product + using Derived = Product; + using Scalar = typename Derived::Scalar; + using TransposeType = Transpose; + using ConjugateTransposeType = CwiseUnaryOp, TransposeType>; + using AdjointType = std::conditional_t::IsComplex, ConjugateTransposeType, TransposeType>; + + // return (lhs * rhs)^T + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TransposeType run_transpose(const Derived& derived) { + return TransposeType(derived); + } + // return (lhs * rhs)^H + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE AdjointType run_adjoint(const Derived& derived) { + return AdjointType(TransposeType(derived)); + } +}; + +template +struct product_transpose_helper { + // expand the transposed matrix-matrix product + using Derived = Product; + + using LhsScalar = typename traits::Scalar; + using LhsTransposeType = typename DenseBase::ConstTransposeReturnType; + using LhsConjugateTransposeType = CwiseUnaryOp, LhsTransposeType>; + using LhsAdjointType = + std::conditional_t::IsComplex, LhsConjugateTransposeType, LhsTransposeType>; + + using RhsScalar = typename traits::Scalar; + using RhsTransposeType = typename DenseBase::ConstTransposeReturnType; + using RhsConjugateTransposeType = CwiseUnaryOp, RhsTransposeType>; + using RhsAdjointType = + std::conditional_t::IsComplex, RhsConjugateTransposeType, RhsTransposeType>; + + using TransposeType = Product; + using AdjointType = Product; + + // return rhs^T * lhs^T + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TransposeType run_transpose(const Derived& derived) { + return TransposeType(RhsTransposeType(derived.rhs()), LhsTransposeType(derived.lhs())); + } + // return rhs^H * lhs^H + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE AdjointType run_adjoint(const Derived& derived) { + return AdjointType(RhsAdjointType(RhsTransposeType(derived.rhs())), + LhsAdjointType(LhsTransposeType(derived.lhs()))); + } +}; +template +struct product_transpose_helper { + // expand the transposed permutation-matrix product + using Derived = Product; + + using LhsInverseType = typename PermutationBase::InverseReturnType; + + using RhsScalar = typename traits::Scalar; + using RhsTransposeType = typename DenseBase::ConstTransposeReturnType; + using RhsConjugateTransposeType = CwiseUnaryOp, RhsTransposeType>; + using RhsAdjointType = + std::conditional_t::IsComplex, RhsConjugateTransposeType, RhsTransposeType>; + + using TransposeType = Product; + using AdjointType = Product; + + // return rhs^T * lhs^-1 + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TransposeType run_transpose(const Derived& derived) { + return TransposeType(RhsTransposeType(derived.rhs()), LhsInverseType(derived.lhs())); + } + // return rhs^H * lhs^-1 + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE AdjointType run_adjoint(const Derived& derived) { + return AdjointType(RhsAdjointType(RhsTransposeType(derived.rhs())), LhsInverseType(derived.lhs())); + } +}; +template +struct product_transpose_helper { + // expand the transposed matrix-permutation product + using Derived = Product; + + using LhsScalar = typename traits::Scalar; + using LhsTransposeType = typename DenseBase::ConstTransposeReturnType; + using LhsConjugateTransposeType = CwiseUnaryOp, LhsTransposeType>; + using LhsAdjointType = + std::conditional_t::IsComplex, LhsConjugateTransposeType, LhsTransposeType>; + + using RhsInverseType = typename PermutationBase::InverseReturnType; + + using TransposeType = Product; + using AdjointType = Product; + + // return rhs^-1 * lhs^T + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TransposeType run_transpose(const Derived& derived) { + return TransposeType(RhsInverseType(derived.rhs()), LhsTransposeType(derived.lhs())); + } + // return rhs^-1 * lhs^H + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE AdjointType run_adjoint(const Derived& derived) { + return AdjointType(RhsInverseType(derived.rhs()), LhsAdjointType(LhsTransposeType(derived.lhs()))); + } +}; + +} // end namespace internal + +/** \class Product + * \ingroup Core_Module + * + * \brief Expression of the product of two arbitrary matrices or vectors + * + * \tparam Lhs_ the type of the left-hand side expression + * \tparam Rhs_ the type of the right-hand side expression + * + * This class represents an expression of the product of two arbitrary matrices. + * + * The other template parameters are: + * \tparam Option can be DefaultProduct, AliasFreeProduct, or LazyProduct + * + */ +template +class Product + : public ProductImpl::StorageKind, typename internal::traits::StorageKind, + internal::product_type::ret>::ret> { + public: + typedef Lhs_ Lhs; + typedef Rhs_ Rhs; + + typedef + typename ProductImpl::StorageKind, typename internal::traits::StorageKind, + internal::product_type::ret>::ret>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Product) + + typedef typename internal::ref_selector::type LhsNested; + typedef typename internal::ref_selector::type RhsNested; + typedef internal::remove_all_t LhsNestedCleaned; + typedef internal::remove_all_t RhsNestedCleaned; + + using TransposeReturnType = typename internal::product_transpose_helper::TransposeType; + using AdjointReturnType = typename internal::product_transpose_helper::AdjointType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Product(const Lhs& lhs, const Rhs& rhs) : m_lhs(lhs), m_rhs(rhs) { + eigen_assert(lhs.cols() == rhs.rows() && "invalid matrix product" && + "if you wanted a coeff-wise or a dot product use the respective explicit functions"); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const noexcept { return m_lhs.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const noexcept { return m_rhs.cols(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const LhsNestedCleaned& lhs() const { return m_lhs; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const RhsNestedCleaned& rhs() const { return m_rhs; } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TransposeReturnType transpose() const { + return internal::product_transpose_helper::run_transpose(*this); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE AdjointReturnType adjoint() const { + return internal::product_transpose_helper::run_adjoint(*this); + } + + protected: + LhsNested m_lhs; + RhsNested m_rhs; +}; + +namespace internal { + +template ::ret> +class dense_product_base : public internal::dense_xpr_base>::type {}; + +/** Conversion to scalar for inner-products */ +template +class dense_product_base + : public internal::dense_xpr_base>::type { + typedef Product ProductXpr; + typedef typename internal::dense_xpr_base::type Base; + + public: + using Base::derived; + typedef typename Base::Scalar Scalar; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE operator const Scalar() const { + return internal::evaluator(derived()).coeff(0, 0); + } +}; + +} // namespace internal + +// Generic API dispatcher +template +class ProductImpl : public internal::generic_xpr_base, MatrixXpr, StorageKind>::type { + public: + typedef typename internal::generic_xpr_base, MatrixXpr, StorageKind>::type Base; +}; + +template +class ProductImpl : public internal::dense_product_base { + typedef Product Derived; + + public: + typedef typename internal::dense_product_base Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Derived) + protected: + enum { + IsOneByOne = (RowsAtCompileTime == 1 || RowsAtCompileTime == Dynamic) && + (ColsAtCompileTime == 1 || ColsAtCompileTime == Dynamic), + EnableCoeff = IsOneByOne || Option == LazyProduct + }; + + public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index row, Index col) const { + EIGEN_STATIC_ASSERT(EnableCoeff, THIS_METHOD_IS_ONLY_FOR_INNER_OR_LAZY_PRODUCTS); + eigen_assert((Option == LazyProduct) || (this->rows() == 1 && this->cols() == 1)); + + return internal::evaluator(derived()).coeff(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index i) const { + EIGEN_STATIC_ASSERT(EnableCoeff, THIS_METHOD_IS_ONLY_FOR_INNER_OR_LAZY_PRODUCTS); + eigen_assert((Option == LazyProduct) || (this->rows() == 1 && this->cols() == 1)); + + return internal::evaluator(derived()).coeff(i); + } +}; + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ProductEvaluators.h b/src/3rdparty/eigen/Eigen/src/Core/ProductEvaluators.h new file mode 100644 index 0000000..be55be5 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ProductEvaluators.h @@ -0,0 +1,1287 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008-2010 Gael Guennebaud +// Copyright (C) 2011 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PRODUCTEVALUATORS_H +#define EIGEN_PRODUCTEVALUATORS_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +/** \internal + * Evaluator of a product expression. + * Since products require special treatments to handle all possible cases, + * we simply defer the evaluation logic to a product_evaluator class + * which offers more partial specialization possibilities. + * + * \sa class product_evaluator + */ +template +struct evaluator> : public product_evaluator> { + typedef Product XprType; + typedef product_evaluator Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +// Catch "scalar * ( A * B )" and transform it to "(A*scalar) * B" +// TODO we should apply that rule only if that's really helpful +template +struct evaluator_assume_aliasing, + const CwiseNullaryOp, Plain1>, + const Product>> { + static const bool value = true; +}; +template +struct evaluator, + const CwiseNullaryOp, Plain1>, + const Product>> + : public evaluator> { + typedef CwiseBinaryOp, + const CwiseNullaryOp, Plain1>, + const Product> + XprType; + typedef evaluator> Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) + : Base(xpr.lhs().functor().m_other * xpr.rhs().lhs() * xpr.rhs().rhs()) {} +}; + +template +struct evaluator, DiagIndex>> + : public evaluator, DiagIndex>> { + typedef Diagonal, DiagIndex> XprType; + typedef evaluator, DiagIndex>> Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) + : Base(Diagonal, DiagIndex>( + Product(xpr.nestedExpression().lhs(), xpr.nestedExpression().rhs()), xpr.index())) {} +}; + +// Helper class to perform a matrix product with the destination at hand. +// Depending on the sizes of the factors, there are different evaluation strategies +// as controlled by internal::product_type. +template ::Shape, + typename RhsShape = typename evaluator_traits::Shape, + int ProductType = internal::product_type::value> +struct generic_product_impl; + +template +struct evaluator_assume_aliasing> { + static const bool value = true; +}; + +// This is the default evaluator implementation for products: +// It creates a temporary and call generic_product_impl +template +struct product_evaluator, ProductTag, LhsShape, RhsShape> + : public evaluator::PlainObject> { + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + typedef evaluator Base; + enum { Flags = Base::Flags | EvalBeforeNestingBit }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit product_evaluator(const XprType& xpr) + : m_result(xpr.rows(), xpr.cols()) { + internal::construct_at(this, m_result); + + // FIXME shall we handle nested_eval here?, + // if so, then we must take care at removing the call to nested_eval in the specializations (e.g., in + // permutation_matrix_product, transposition_matrix_product, etc.) + // typedef typename internal::nested_eval::type LhsNested; + // typedef typename internal::nested_eval::type RhsNested; + // typedef internal::remove_all_t LhsNestedCleaned; + // typedef internal::remove_all_t RhsNestedCleaned; + // + // const LhsNested lhs(xpr.lhs()); + // const RhsNested rhs(xpr.rhs()); + // + // generic_product_impl::evalTo(m_result, lhs, rhs); + + generic_product_impl::evalTo(m_result, xpr.lhs(), xpr.rhs()); + } + + protected: + PlainObject m_result; +}; + +// The following three shortcuts are enabled only if the scalar types match exactly. +// TODO: we could enable them for different scalar types when the product is not vectorized. + +// Dense = Product +template +struct Assignment, internal::assign_op, Dense2Dense, + std::enable_if_t<(Options == DefaultProduct || Options == AliasFreeProduct)>> { + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, + const internal::assign_op&) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + // FIXME shall we handle nested_eval here? + generic_product_impl::evalTo(dst, src.lhs(), src.rhs()); + } +}; + +// Dense += Product +template +struct Assignment, internal::add_assign_op, Dense2Dense, + std::enable_if_t<(Options == DefaultProduct || Options == AliasFreeProduct)>> { + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, + const internal::add_assign_op&) { + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + // FIXME shall we handle nested_eval here? + generic_product_impl::addTo(dst, src.lhs(), src.rhs()); + } +}; + +// Dense -= Product +template +struct Assignment, internal::sub_assign_op, Dense2Dense, + std::enable_if_t<(Options == DefaultProduct || Options == AliasFreeProduct)>> { + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, + const internal::sub_assign_op&) { + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + // FIXME shall we handle nested_eval here? + generic_product_impl::subTo(dst, src.lhs(), src.rhs()); + } +}; + +// Dense ?= scalar * Product +// TODO we should apply that rule if that's really helpful +// for instance, this is not good for inner products +template +struct Assignment, + const CwiseNullaryOp, Plain>, + const Product>, + AssignFunc, Dense2Dense> { + typedef CwiseBinaryOp, + const CwiseNullaryOp, Plain>, + const Product> + SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, + const AssignFunc& func) { + call_assignment_no_alias(dst, (src.lhs().functor().m_other * src.rhs().lhs()) * src.rhs().rhs(), func); + } +}; + +//---------------------------------------- +// Catch "Dense ?= xpr + Product<>" expression to save one temporary +// FIXME we could probably enable these rules for any product, i.e., not only Dense and DefaultProduct + +template +struct evaluator_assume_aliasing< + CwiseBinaryOp< + internal::scalar_sum_op::Scalar>, + const OtherXpr, const Product>, + DenseShape> { + static const bool value = true; +}; + +template +struct evaluator_assume_aliasing< + CwiseBinaryOp< + internal::scalar_difference_op::Scalar>, + const OtherXpr, const Product>, + DenseShape> { + static const bool value = true; +}; + +template +struct assignment_from_xpr_op_product { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(DstXprType& dst, const SrcXprType& src, + const InitialFunc& /*func*/) { + call_assignment_no_alias(dst, src.lhs(), Func1()); + call_assignment_no_alias(dst, src.rhs(), Func2()); + } +}; + +#define EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(ASSIGN_OP, BINOP, ASSIGN_OP2) \ + template \ + struct Assignment, const OtherXpr, \ + const Product>, \ + internal::ASSIGN_OP, Dense2Dense> \ + : assignment_from_xpr_op_product, \ + internal::ASSIGN_OP, \ + internal::ASSIGN_OP2> {} + +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(assign_op, scalar_sum_op, add_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(add_assign_op, scalar_sum_op, add_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(sub_assign_op, scalar_sum_op, sub_assign_op); + +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(assign_op, scalar_difference_op, sub_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(add_assign_op, scalar_difference_op, sub_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(sub_assign_op, scalar_difference_op, add_assign_op); + +//---------------------------------------- + +template +struct generic_product_impl { + using impl = default_inner_product_impl; + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + dst.coeffRef(0, 0) = impl::run(lhs, rhs); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + dst.coeffRef(0, 0) += impl::run(lhs, rhs); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + dst.coeffRef(0, 0) -= impl::run(lhs, rhs); + } +}; + +/*********************************************************************** + * Implementation of outer dense * dense vector product + ***********************************************************************/ + +// Column major result +template +void EIGEN_DEVICE_FUNC outer_product_selector_run(Dst& dst, const Lhs& lhs, const Rhs& rhs, const Func& func, + const false_type&) { + evaluator rhsEval(rhs); + ei_declare_local_nested_eval(Lhs, lhs, Rhs::SizeAtCompileTime, actual_lhs); + // FIXME if cols is large enough, then it might be useful to make sure that lhs is sequentially stored + // FIXME not very good if rhs is real and lhs complex while alpha is real too + const Index cols = dst.cols(); + for (Index j = 0; j < cols; ++j) func(dst.col(j), rhsEval.coeff(Index(0), j) * actual_lhs); +} + +// Row major result +template +void EIGEN_DEVICE_FUNC outer_product_selector_run(Dst& dst, const Lhs& lhs, const Rhs& rhs, const Func& func, + const true_type&) { + evaluator lhsEval(lhs); + ei_declare_local_nested_eval(Rhs, rhs, Lhs::SizeAtCompileTime, actual_rhs); + // FIXME if rows is large enough, then it might be useful to make sure that rhs is sequentially stored + // FIXME not very good if lhs is real and rhs complex while alpha is real too + const Index rows = dst.rows(); + for (Index i = 0; i < rows; ++i) func(dst.row(i), lhsEval.coeff(i, Index(0)) * actual_rhs); +} + +template +struct generic_product_impl { + template + struct is_row_major : bool_constant<(int(T::Flags) & RowMajorBit)> {}; + typedef typename Product::Scalar Scalar; + + // TODO it would be nice to be able to exploit our *_assign_op functors for that purpose + struct set { + template + EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { + dst.const_cast_derived() = src; + } + }; + struct add { + /** Add to dst. */ + template + EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { + dst.const_cast_derived() += src; + } + }; + struct sub { + template + EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { + dst.const_cast_derived() -= src; + } + }; + /** Scaled add. */ + struct adds { + Scalar m_scale; + /** Constructor */ + explicit adds(const Scalar& s) : m_scale(s) {} + /** Scaled add to dst. */ + template + void EIGEN_DEVICE_FUNC operator()(const Dst& dst, const Src& src) const { + dst.const_cast_derived() += m_scale * src; + } + }; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + internal::outer_product_selector_run(dst, lhs, rhs, set(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + internal::outer_product_selector_run(dst, lhs, rhs, add(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + internal::outer_product_selector_run(dst, lhs, rhs, sub(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dst& dst, const Lhs& lhs, const Rhs& rhs, + const Scalar& alpha) { + internal::outer_product_selector_run(dst, lhs, rhs, adds(alpha), is_row_major()); + } +}; + +// This base class provides default implementations for evalTo, addTo, subTo, in terms of scaleAndAddTo +template +struct generic_product_impl_base { + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + dst.setZero(); + scaleAndAddTo(dst, lhs, rhs, Scalar(1)); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + scaleAndAddTo(dst, lhs, rhs, Scalar(1)); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + scaleAndAddTo(dst, lhs, rhs, Scalar(-1)); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dst& dst, const Lhs& lhs, const Rhs& rhs, + const Scalar& alpha) { + Derived::scaleAndAddTo(dst, lhs, rhs, alpha); + } +}; + +template +struct generic_product_impl + : generic_product_impl_base> { + typedef typename nested_eval::type LhsNested; + typedef typename nested_eval::type RhsNested; + typedef typename Product::Scalar Scalar; + enum { Side = Lhs::IsVectorAtCompileTime ? OnTheLeft : OnTheRight }; + typedef internal::remove_all_t> MatrixType; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, + const Scalar& alpha) { + // Fallback to inner product if both the lhs and rhs is a runtime vector. + if (lhs.rows() == 1 && rhs.cols() == 1) { + dst.coeffRef(0, 0) += alpha * lhs.row(0).conjugate().dot(rhs.col(0)); + return; + } + LhsNested actual_lhs(lhs); + RhsNested actual_rhs(rhs); + internal::gemv_dense_selector::HasUsableDirectAccess)>::run(actual_lhs, + actual_rhs, dst, + alpha); + } +}; + +template +struct generic_product_impl { + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + // Same as: dst.noalias() = lhs.lazyProduct(rhs); + // but easier on the compiler side + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::assign_op()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + // dst.noalias() += lhs.lazyProduct(rhs); + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::add_assign_op()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) { + // dst.noalias() -= lhs.lazyProduct(rhs); + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::sub_assign_op()); + } + + // This is a special evaluation path called from generic_product_impl<...,GemmProduct> in file GeneralMatrixMatrix.h + // This variant tries to extract scalar multiples from both the LHS and RHS and factor them out. For instance: + // dst {,+,-}= (s1*A)*(B*s2) + // will be rewritten as: + // dst {,+,-}= (s1*s2) * (A.lazyProduct(B)) + // There are at least four benefits of doing so: + // 1 - huge performance gain for heap-allocated matrix types as it save costly allocations. + // 2 - it is faster than simply by-passing the heap allocation through stack allocation. + // 3 - it makes this fallback consistent with the heavy GEMM routine. + // 4 - it fully by-passes huge stack allocation attempts when multiplying huge fixed-size matrices. + // (see https://stackoverflow.com/questions/54738495) + // For small fixed sizes matrices, however, the gains are less obvious, it is sometimes x2 faster, but sometimes x3 + // slower, and the behavior depends also a lot on the compiler... This is why this re-writing strategy is currently + // enabled only when falling back from the main GEMM. + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void eval_dynamic(Dst& dst, const Lhs& lhs, const Rhs& rhs, + const Func& func) { + enum { + HasScalarFactor = blas_traits::HasScalarFactor || blas_traits::HasScalarFactor, + ConjLhs = blas_traits::NeedToConjugate, + ConjRhs = blas_traits::NeedToConjugate + }; + // FIXME: in c++11 this should be auto, and extractScalarFactor should also return auto + // this is important for real*complex_mat + Scalar actualAlpha = combine_scalar_factors(lhs, rhs); + + eval_dynamic_impl(dst, blas_traits::extract(lhs).template conjugateIf(), + blas_traits::extract(rhs).template conjugateIf(), func, actualAlpha, + bool_constant()); + } + + protected: + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void eval_dynamic_impl(Dst& dst, const LhsT& lhs, const RhsT& rhs, + const Func& func, const Scalar& s /* == 1 */, + false_type) { + EIGEN_UNUSED_VARIABLE(s); + eigen_internal_assert(numext::is_exactly_one(s)); + call_restricted_packet_assignment_no_alias(dst, lhs.lazyProduct(rhs), func); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void eval_dynamic_impl(Dst& dst, const LhsT& lhs, const RhsT& rhs, + const Func& func, const Scalar& s, true_type) { + call_restricted_packet_assignment_no_alias(dst, s * lhs.lazyProduct(rhs), func); + } +}; + +// This specialization enforces the use of a coefficient-based evaluation strategy +template +struct generic_product_impl + : generic_product_impl {}; + +// Case 2: Evaluate coeff by coeff +// +// This is mostly taken from CoeffBasedProduct.h +// The main difference is that we add an extra argument to the etor_product_*_impl::run() function +// for the inner dimension of the product, because evaluator object do not know their size. + +template +struct etor_product_coeff_impl; + +template +struct etor_product_packet_impl; + +template +struct product_evaluator, ProductTag, DenseShape, DenseShape> + : evaluator_base> { + typedef Product XprType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit product_evaluator(const XprType& xpr) + : m_lhs(xpr.lhs()), + m_rhs(xpr.rhs()), + m_lhsImpl(m_lhs), // FIXME the creation of the evaluator objects should result in a no-op, but check that! + m_rhsImpl(m_rhs), // Moreover, they are only useful for the packet path, so we could completely disable + // them when not needed, or perhaps declare them on the fly on the packet method... We + // have experiment to check what's best. + m_innerDim(xpr.lhs().cols()) { + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::MulCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::AddCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); +#if 0 + std::cerr << "LhsOuterStrideBytes= " << LhsOuterStrideBytes << "\n"; + std::cerr << "RhsOuterStrideBytes= " << RhsOuterStrideBytes << "\n"; + std::cerr << "LhsAlignment= " << LhsAlignment << "\n"; + std::cerr << "RhsAlignment= " << RhsAlignment << "\n"; + std::cerr << "CanVectorizeLhs= " << CanVectorizeLhs << "\n"; + std::cerr << "CanVectorizeRhs= " << CanVectorizeRhs << "\n"; + std::cerr << "CanVectorizeInner= " << CanVectorizeInner << "\n"; + std::cerr << "EvalToRowMajor= " << EvalToRowMajor << "\n"; + std::cerr << "Alignment= " << Alignment << "\n"; + std::cerr << "Flags= " << Flags << "\n"; +#endif + } + + // Everything below here is taken from CoeffBasedProduct.h + + typedef typename internal::nested_eval::type LhsNested; + typedef typename internal::nested_eval::type RhsNested; + + typedef internal::remove_all_t LhsNestedCleaned; + typedef internal::remove_all_t RhsNestedCleaned; + + typedef evaluator LhsEtorType; + typedef evaluator RhsEtorType; + + enum { + RowsAtCompileTime = LhsNestedCleaned::RowsAtCompileTime, + ColsAtCompileTime = RhsNestedCleaned::ColsAtCompileTime, + InnerSize = min_size_prefer_fixed(LhsNestedCleaned::ColsAtCompileTime, RhsNestedCleaned::RowsAtCompileTime), + MaxRowsAtCompileTime = LhsNestedCleaned::MaxRowsAtCompileTime, + MaxColsAtCompileTime = RhsNestedCleaned::MaxColsAtCompileTime + }; + + typedef typename find_best_packet::type LhsVecPacketType; + typedef typename find_best_packet::type RhsVecPacketType; + + enum { + + LhsCoeffReadCost = LhsEtorType::CoeffReadCost, + RhsCoeffReadCost = RhsEtorType::CoeffReadCost, + CoeffReadCost = InnerSize == 0 ? NumTraits::ReadCost + : InnerSize == Dynamic + ? HugeCost + : InnerSize * (NumTraits::MulCost + int(LhsCoeffReadCost) + int(RhsCoeffReadCost)) + + (InnerSize - 1) * NumTraits::AddCost, + + Unroll = CoeffReadCost <= EIGEN_UNROLLING_LIMIT, + + LhsFlags = LhsEtorType::Flags, + RhsFlags = RhsEtorType::Flags, + + LhsRowMajor = LhsFlags & RowMajorBit, + RhsRowMajor = RhsFlags & RowMajorBit, + + LhsVecPacketSize = unpacket_traits::size, + RhsVecPacketSize = unpacket_traits::size, + + // Here, we don't care about alignment larger than the usable packet size. + LhsAlignment = + plain_enum_min(LhsEtorType::Alignment, LhsVecPacketSize* int(sizeof(typename LhsNestedCleaned::Scalar))), + RhsAlignment = + plain_enum_min(RhsEtorType::Alignment, RhsVecPacketSize* int(sizeof(typename RhsNestedCleaned::Scalar))), + + SameType = is_same::value, + + CanVectorizeRhs = bool(RhsRowMajor) && (RhsFlags & PacketAccessBit) && (ColsAtCompileTime != 1), + CanVectorizeLhs = (!LhsRowMajor) && (LhsFlags & PacketAccessBit) && (RowsAtCompileTime != 1), + + EvalToRowMajor = (MaxRowsAtCompileTime == 1 && MaxColsAtCompileTime != 1) ? 1 + : (MaxColsAtCompileTime == 1 && MaxRowsAtCompileTime != 1) + ? 0 + : (bool(RhsRowMajor) && !CanVectorizeLhs), + + Flags = ((int(LhsFlags) | int(RhsFlags)) & HereditaryBits & ~RowMajorBit) | + (EvalToRowMajor ? RowMajorBit : 0) + // TODO enable vectorization for mixed types + | (SameType && (CanVectorizeLhs || CanVectorizeRhs) ? PacketAccessBit : 0) | + (XprType::IsVectorAtCompileTime ? LinearAccessBit : 0), + + LhsOuterStrideBytes = + int(LhsNestedCleaned::OuterStrideAtCompileTime) * int(sizeof(typename LhsNestedCleaned::Scalar)), + RhsOuterStrideBytes = + int(RhsNestedCleaned::OuterStrideAtCompileTime) * int(sizeof(typename RhsNestedCleaned::Scalar)), + + Alignment = bool(CanVectorizeLhs) + ? (LhsOuterStrideBytes <= 0 || (int(LhsOuterStrideBytes) % plain_enum_max(1, LhsAlignment)) != 0 + ? 0 + : LhsAlignment) + : bool(CanVectorizeRhs) + ? (RhsOuterStrideBytes <= 0 || (int(RhsOuterStrideBytes) % plain_enum_max(1, RhsAlignment)) != 0 + ? 0 + : RhsAlignment) + : 0, + + /* CanVectorizeInner deserves special explanation. It does not affect the product flags. It is not used outside + * of Product. If the Product itself is not a packet-access expression, there is still a chance that the inner + * loop of the product might be vectorized. This is the meaning of CanVectorizeInner. Since it doesn't affect + * the Flags, it is safe to make this value depend on ActualPacketAccessBit, that doesn't affect the ABI. + */ + CanVectorizeInner = SameType && LhsRowMajor && (!RhsRowMajor) && + (int(LhsFlags) & int(RhsFlags) & ActualPacketAccessBit) && + (int(InnerSize) % packet_traits::size == 0) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index row, Index col) const { + return (m_lhs.row(row).transpose().cwiseProduct(m_rhs.col(col))).sum(); + } + + /* Allow index-based non-packet access. It is impossible though to allow index-based packed access, + * which is why we don't set the LinearAccessBit. + * TODO: this seems possible when the result is a vector + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index index) const { + const Index row = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime == 1) ? 0 : index; + const Index col = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime == 1) ? index : 0; + return (m_lhs.row(row).transpose().cwiseProduct(m_rhs.col(col))).sum(); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const PacketType packet(Index row, Index col) const { + PacketType res; + typedef etor_product_packet_impl + PacketImpl; + PacketImpl::run(row, col, m_lhsImpl, m_rhsImpl, m_innerDim, res); + return res; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const PacketType packet(Index index) const { + const Index row = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime == 1) ? 0 : index; + const Index col = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime == 1) ? index : 0; + return packet(row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const PacketType packetSegment(Index row, Index col, Index begin, + Index count) const { + PacketType res; + typedef etor_product_packet_impl + PacketImpl; + PacketImpl::run_segment(row, col, m_lhsImpl, m_rhsImpl, m_innerDim, res, begin, count); + return res; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const PacketType packetSegment(Index index, Index begin, Index count) const { + const Index row = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime == 1) ? 0 : index; + const Index col = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime == 1) ? index : 0; + return packetSegment(row, col, begin, count); + } + + protected: + add_const_on_value_type_t m_lhs; + add_const_on_value_type_t m_rhs; + + LhsEtorType m_lhsImpl; + RhsEtorType m_rhsImpl; + + // TODO: Get rid of m_innerDim if known at compile time + Index m_innerDim; +}; + +template +struct product_evaluator, LazyCoeffBasedProductMode, DenseShape, DenseShape> + : product_evaluator, CoeffBasedProductMode, DenseShape, DenseShape> { + typedef Product XprType; + typedef Product BaseProduct; + typedef product_evaluator Base; + enum { Flags = Base::Flags | EvalBeforeNestingBit }; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit product_evaluator(const XprType& xpr) + : Base(BaseProduct(xpr.lhs(), xpr.rhs())) {} +}; + +/**************************************** +*** Coeff based product, Packet path *** +****************************************/ + +template +struct etor_product_packet_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index innerDim, Packet& res) { + etor_product_packet_impl::run(row, col, lhs, rhs, + innerDim, res); + res = pmadd(pset1(lhs.coeff(row, Index(UnrollingIndex - 1))), + rhs.template packet(Index(UnrollingIndex - 1), col), res); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run_segment(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index innerDim, Packet& res, Index begin, Index count) { + etor_product_packet_impl::run_segment( + row, col, lhs, rhs, innerDim, res, begin, count); + res = pmadd(pset1(lhs.coeff(row, Index(UnrollingIndex - 1))), + rhs.template packetSegment(Index(UnrollingIndex - 1), col, begin, count), res); + } +}; + +template +struct etor_product_packet_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index innerDim, Packet& res) { + etor_product_packet_impl::run(row, col, lhs, rhs, + innerDim, res); + res = pmadd(lhs.template packet(row, Index(UnrollingIndex - 1)), + pset1(rhs.coeff(Index(UnrollingIndex - 1), col)), res); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run_segment(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index innerDim, Packet& res, Index begin, Index count) { + etor_product_packet_impl::run_segment( + row, col, lhs, rhs, innerDim, res, begin, count); + res = pmadd(lhs.template packetSegment(row, Index(UnrollingIndex - 1), begin, count), + pset1(rhs.coeff(Index(UnrollingIndex - 1), col)), res); + } +}; + +template +struct etor_product_packet_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index /*innerDim*/, Packet& res) { + res = pmul(pset1(lhs.coeff(row, Index(0))), rhs.template packet(Index(0), col)); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run_segment(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index /*innerDim*/, Packet& res, Index begin, + Index count) { + res = pmul(pset1(lhs.coeff(row, Index(0))), + rhs.template packetSegment(Index(0), col, begin, count)); + } +}; + +template +struct etor_product_packet_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index /*innerDim*/, Packet& res) { + res = pmul(lhs.template packet(row, Index(0)), pset1(rhs.coeff(Index(0), col))); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run_segment(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index /*innerDim*/, Packet& res, Index begin, + Index count) { + res = pmul(lhs.template packetSegment(row, Index(0), begin, count), + pset1(rhs.coeff(Index(0), col))); + } +}; + +template +struct etor_product_packet_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index /*row*/, Index /*col*/, const Lhs& /*lhs*/, + const Rhs& /*rhs*/, Index /*innerDim*/, Packet& res) { + res = pset1(typename unpacket_traits::type(0)); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run_segment(Index /*row*/, Index /*col*/, const Lhs& /*lhs*/, + const Rhs& /*rhs*/, Index /*innerDim*/, Packet& res, + Index /*begin*/, Index /*count*/) { + res = pset1(typename unpacket_traits::type(0)); + } +}; + +template +struct etor_product_packet_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index /*row*/, Index /*col*/, const Lhs& /*lhs*/, + const Rhs& /*rhs*/, Index /*innerDim*/, Packet& res) { + res = pset1(typename unpacket_traits::type(0)); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run_segment(Index /*row*/, Index /*col*/, const Lhs& /*lhs*/, + const Rhs& /*rhs*/, Index /*innerDim*/, Packet& res, + Index /*begin*/, Index /*count*/) { + res = pset1(typename unpacket_traits::type(0)); + } +}; + +template +struct etor_product_packet_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index innerDim, Packet& res) { + res = pset1(typename unpacket_traits::type(0)); + for (Index i = 0; i < innerDim; ++i) + res = pmadd(pset1(lhs.coeff(row, i)), rhs.template packet(i, col), res); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run_segment(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index innerDim, Packet& res, Index begin, Index count) { + res = pset1(typename unpacket_traits::type(0)); + for (Index i = 0; i < innerDim; ++i) + res = pmadd(pset1(lhs.coeff(row, i)), rhs.template packetSegment(i, col, begin, count), + res); + } +}; + +template +struct etor_product_packet_impl { + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index innerDim, Packet& res) { + res = pset1(typename unpacket_traits::type(0)); + for (Index i = 0; i < innerDim; ++i) + res = pmadd(lhs.template packet(row, i), pset1(rhs.coeff(i, col)), res); + } + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run_segment(Index row, Index col, const Lhs& lhs, const Rhs& rhs, + Index innerDim, Packet& res, Index begin, Index count) { + res = pset1(typename unpacket_traits::type(0)); + for (Index i = 0; i < innerDim; ++i) + res = pmadd(lhs.template packetSegment(row, i, begin, count), pset1(rhs.coeff(i, col)), + res); + } +}; + +/*************************************************************************** + * Triangular products + ***************************************************************************/ +template +struct triangular_product_impl; + +template +struct generic_product_impl + : generic_product_impl_base> { + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) { + triangular_product_impl::run( + dst, lhs.nestedExpression(), rhs, alpha); + } +}; + +template +struct generic_product_impl + : generic_product_impl_base> { + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) { + triangular_product_impl::run( + dst, lhs, rhs.nestedExpression(), alpha); + } +}; + +/*************************************************************************** + * SelfAdjoint products + ***************************************************************************/ +template +struct selfadjoint_product_impl; + +template +struct generic_product_impl + : generic_product_impl_base> { + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) { + selfadjoint_product_impl::run( + dst, lhs.nestedExpression(), rhs, alpha); + } +}; + +template +struct generic_product_impl + : generic_product_impl_base> { + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) { + selfadjoint_product_impl::run( + dst, lhs, rhs.nestedExpression(), alpha); + } +}; + +/*************************************************************************** + * Diagonal products + ***************************************************************************/ + +template +struct diagonal_product_evaluator_base : evaluator_base { + typedef typename ScalarBinaryOpTraits::ReturnType Scalar; + + public: + enum { + CoeffReadCost = int(NumTraits::MulCost) + int(evaluator::CoeffReadCost) + + int(evaluator::CoeffReadCost), + + MatrixFlags = evaluator::Flags, + DiagFlags = evaluator::Flags, + + StorageOrder_ = (Derived::MaxRowsAtCompileTime == 1 && Derived::MaxColsAtCompileTime != 1) ? RowMajor + : (Derived::MaxColsAtCompileTime == 1 && Derived::MaxRowsAtCompileTime != 1) ? ColMajor + : MatrixFlags & RowMajorBit ? RowMajor + : ColMajor, + SameStorageOrder_ = int(StorageOrder_) == ((MatrixFlags & RowMajorBit) ? RowMajor : ColMajor), + + ScalarAccessOnDiag_ = !((int(StorageOrder_) == ColMajor && int(ProductOrder) == OnTheLeft) || + (int(StorageOrder_) == RowMajor && int(ProductOrder) == OnTheRight)), + SameTypes_ = is_same::value, + // FIXME currently we need same types, but in the future the next rule should be the one + // Vectorizable_ = bool(int(MatrixFlags)&PacketAccessBit) && ((!_PacketOnDiag) || (SameTypes_ && + // bool(int(DiagFlags)&PacketAccessBit))), + Vectorizable_ = bool(int(MatrixFlags) & PacketAccessBit) && SameTypes_ && + (SameStorageOrder_ || (MatrixFlags & LinearAccessBit) == LinearAccessBit) && + (ScalarAccessOnDiag_ || (bool(int(DiagFlags) & PacketAccessBit))), + LinearAccessMask_ = + (MatrixType::RowsAtCompileTime == 1 || MatrixType::ColsAtCompileTime == 1) ? LinearAccessBit : 0, + Flags = + ((HereditaryBits | LinearAccessMask_) & (unsigned int)(MatrixFlags)) | (Vectorizable_ ? PacketAccessBit : 0), + Alignment = evaluator::Alignment, + + AsScalarProduct = + (DiagonalType::SizeAtCompileTime == 1) || + (DiagonalType::SizeAtCompileTime == Dynamic && MatrixType::RowsAtCompileTime == 1 && + ProductOrder == OnTheLeft) || + (DiagonalType::SizeAtCompileTime == Dynamic && MatrixType::ColsAtCompileTime == 1 && ProductOrder == OnTheRight) + }; + + EIGEN_DEVICE_FUNC diagonal_product_evaluator_base(const MatrixType& mat, const DiagonalType& diag) + : m_diagImpl(diag), m_matImpl(mat) { + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::MulCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index idx) const { + if (AsScalarProduct) + return m_diagImpl.coeff(0) * m_matImpl.coeff(idx); + else + return m_diagImpl.coeff(idx) * m_matImpl.coeff(idx); + } + + protected: + template + EIGEN_STRONG_INLINE PacketType packet_impl(Index row, Index col, Index id, internal::true_type) const { + return internal::pmul(m_matImpl.template packet(row, col), + internal::pset1(m_diagImpl.coeff(id))); + } + + template + EIGEN_STRONG_INLINE PacketType packet_impl(Index row, Index col, Index id, internal::false_type) const { + enum { + InnerSize = (MatrixType::Flags & RowMajorBit) ? MatrixType::ColsAtCompileTime : MatrixType::RowsAtCompileTime, + DiagonalPacketLoadMode = plain_enum_min( + LoadMode, + ((InnerSize % 16) == 0) ? int(Aligned16) : int(evaluator::Alignment)) // FIXME hardcoded 16!! + }; + return internal::pmul(m_matImpl.template packet(row, col), + m_diagImpl.template packet(id)); + } + + template + EIGEN_STRONG_INLINE PacketType packet_segment_impl(Index row, Index col, Index id, Index begin, Index count, + internal::true_type) const { + return internal::pmul(m_matImpl.template packetSegment(row, col, begin, count), + internal::pset1(m_diagImpl.coeff(id))); + } + + template + EIGEN_STRONG_INLINE PacketType packet_segment_impl(Index row, Index col, Index id, Index begin, Index count, + internal::false_type) const { + enum { + InnerSize = (MatrixType::Flags & RowMajorBit) ? MatrixType::ColsAtCompileTime : MatrixType::RowsAtCompileTime, + DiagonalPacketLoadMode = plain_enum_min( + LoadMode, + ((InnerSize % 16) == 0) ? int(Aligned16) : int(evaluator::Alignment)) // FIXME hardcoded 16!! + }; + return internal::pmul(m_matImpl.template packetSegment(row, col, begin, count), + m_diagImpl.template packetSegment(id, begin, count)); + } + + evaluator m_diagImpl; + evaluator m_matImpl; +}; + +// diagonal * dense +template +struct product_evaluator, ProductTag, DiagonalShape, DenseShape> + : diagonal_product_evaluator_base, + OnTheLeft> { + typedef diagonal_product_evaluator_base, + OnTheLeft> + Base; + using Base::coeff; + using Base::m_diagImpl; + using Base::m_matImpl; + typedef typename Base::Scalar Scalar; + + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + typedef typename Lhs::DiagonalVectorType DiagonalType; + + static constexpr int StorageOrder = Base::StorageOrder_; + using IsRowMajor_t = bool_constant; + + EIGEN_DEVICE_FUNC explicit product_evaluator(const XprType& xpr) : Base(xpr.rhs(), xpr.lhs().diagonal()) {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index row, Index col) const { + return m_diagImpl.coeff(row) * m_matImpl.coeff(row, col); + } + +#ifndef EIGEN_GPUCC + template + EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + // FIXME: NVCC used to complain about the template keyword, but we have to check whether this is still the case. + // See also similar calls below. + return this->template packet_impl(row, col, row, IsRowMajor_t()); + } + + template + EIGEN_STRONG_INLINE PacketType packet(Index idx) const { + return packet(int(StorageOrder) == ColMajor ? idx : 0, + int(StorageOrder) == ColMajor ? 0 : idx); + } + + template + EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + // FIXME: NVCC used to complain about the template keyword, but we have to check whether this is still the case. + // See also similar calls below. + return this->template packet_segment_impl(row, col, row, begin, count, IsRowMajor_t()); + } + + template + EIGEN_STRONG_INLINE PacketType packetSegment(Index idx, Index begin, Index count) const { + return packetSegment(StorageOrder == ColMajor ? idx : 0, StorageOrder == ColMajor ? 0 : idx, + begin, count); + } +#endif +}; + +// dense * diagonal +template +struct product_evaluator, ProductTag, DenseShape, DiagonalShape> + : diagonal_product_evaluator_base, + OnTheRight> { + typedef diagonal_product_evaluator_base, + OnTheRight> + Base; + using Base::coeff; + using Base::m_diagImpl; + using Base::m_matImpl; + typedef typename Base::Scalar Scalar; + + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + + static constexpr int StorageOrder = Base::StorageOrder_; + using IsColMajor_t = bool_constant; + + EIGEN_DEVICE_FUNC explicit product_evaluator(const XprType& xpr) : Base(xpr.lhs(), xpr.rhs().diagonal()) {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index row, Index col) const { + return m_matImpl.coeff(row, col) * m_diagImpl.coeff(col); + } + +#ifndef EIGEN_GPUCC + template + EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + return this->template packet_impl(row, col, col, IsColMajor_t()); + } + + template + EIGEN_STRONG_INLINE PacketType packet(Index idx) const { + return packet(StorageOrder == ColMajor ? idx : 0, StorageOrder == ColMajor ? 0 : idx); + } + + template + EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + return this->template packet_segment_impl(row, col, col, begin, count, IsColMajor_t()); + } + + template + EIGEN_STRONG_INLINE PacketType packetSegment(Index idx, Index begin, Index count) const { + return packetSegment(StorageOrder == ColMajor ? idx : 0, StorageOrder == ColMajor ? 0 : idx, + begin, count); + } +#endif +}; + +/*************************************************************************** + * Products with permutation matrices + ***************************************************************************/ + +/** \internal + * \class permutation_matrix_product + * Internal helper class implementing the product between a permutation matrix and a matrix. + * This class is specialized for DenseShape below and for SparseShape in SparseCore/SparsePermutation.h + */ +template +struct permutation_matrix_product; + +template +struct permutation_matrix_product { + typedef typename nested_eval::type MatrixType; + typedef remove_all_t MatrixTypeCleaned; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Dest& dst, const PermutationType& perm, + const ExpressionType& xpr) { + MatrixType mat(xpr); + const Index n = Side == OnTheLeft ? mat.rows() : mat.cols(); + // FIXME we need an is_same for expression that is not sensitive to constness. For instance + // is_same_xpr, Block >::value should be true. + // if(is_same::value && extract_data(dst) == extract_data(mat)) + if (is_same_dense(dst, mat)) { + // apply the permutation inplace + Matrix mask(perm.size()); + mask.fill(false); + Index r = 0; + while (r < perm.size()) { + // search for the next seed + while (r < perm.size() && mask[r]) r++; + if (r >= perm.size()) break; + // we got one, let's follow it until we are back to the seed + Index k0 = r++; + Index kPrev = k0; + mask.coeffRef(k0) = true; + for (Index k = perm.indices().coeff(k0); k != k0; k = perm.indices().coeff(k)) { + Block(dst, k) + .swap(Block < Dest, Side == OnTheLeft ? 1 : Dest::RowsAtCompileTime, + Side == OnTheRight + ? 1 + : Dest::ColsAtCompileTime > (dst, ((Side == OnTheLeft) ^ Transposed) ? k0 : kPrev)); + + mask.coeffRef(k) = true; + kPrev = k; + } + } + } else { + for (Index i = 0; i < n; ++i) { + Block( + dst, ((Side == OnTheLeft) ^ Transposed) ? perm.indices().coeff(i) : i) + + = + + Block < const MatrixTypeCleaned, + Side == OnTheLeft ? 1 : MatrixTypeCleaned::RowsAtCompileTime, + Side == OnTheRight ? 1 + : MatrixTypeCleaned::ColsAtCompileTime > + (mat, ((Side == OnTheRight) ^ Transposed) ? perm.indices().coeff(i) : i); + } + } + } +}; + +template +struct generic_product_impl { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) { + permutation_matrix_product::run(dst, lhs, rhs); + } +}; + +template +struct generic_product_impl { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) { + permutation_matrix_product::run(dst, rhs, lhs); + } +}; + +template +struct generic_product_impl, Rhs, PermutationShape, MatrixShape, ProductTag> { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Inverse& lhs, const Rhs& rhs) { + permutation_matrix_product::run(dst, lhs.nestedExpression(), rhs); + } +}; + +template +struct generic_product_impl, MatrixShape, PermutationShape, ProductTag> { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Inverse& rhs) { + permutation_matrix_product::run(dst, rhs.nestedExpression(), lhs); + } +}; + +/*************************************************************************** + * Products with transpositions matrices + ***************************************************************************/ + +// FIXME could we unify Transpositions and Permutation into a single "shape"?? + +/** \internal + * \class transposition_matrix_product + * Internal helper class implementing the product between a permutation matrix and a matrix. + */ +template +struct transposition_matrix_product { + typedef typename nested_eval::type MatrixType; + typedef remove_all_t MatrixTypeCleaned; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Dest& dst, const TranspositionType& tr, + const ExpressionType& xpr) { + MatrixType mat(xpr); + typedef typename TranspositionType::StorageIndex StorageIndex; + const Index size = tr.size(); + StorageIndex j = 0; + + if (!is_same_dense(dst, mat)) dst = mat; + + for (Index k = (Transposed ? size - 1 : 0); Transposed ? k >= 0 : k < size; Transposed ? --k : ++k) + if (Index(j = tr.coeff(k)) != k) { + if (Side == OnTheLeft) + dst.row(k).swap(dst.row(j)); + else if (Side == OnTheRight) + dst.col(k).swap(dst.col(j)); + } + } +}; + +template +struct generic_product_impl { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) { + transposition_matrix_product::run(dst, lhs, rhs); + } +}; + +template +struct generic_product_impl { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) { + transposition_matrix_product::run(dst, rhs, lhs); + } +}; + +template +struct generic_product_impl, Rhs, TranspositionsShape, MatrixShape, ProductTag> { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Transpose& lhs, const Rhs& rhs) { + transposition_matrix_product::run(dst, lhs.nestedExpression(), rhs); + } +}; + +template +struct generic_product_impl, MatrixShape, TranspositionsShape, ProductTag> { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Transpose& rhs) { + transposition_matrix_product::run(dst, rhs.nestedExpression(), lhs); + } +}; + +/*************************************************************************** + * skew symmetric products + * for now we just call the generic implementation + ***************************************************************************/ +template +struct generic_product_impl { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) { + generic_product_impl::evalTo(dst, lhs, + rhs); + } +}; + +template +struct generic_product_impl { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) { + generic_product_impl::evalTo(dst, lhs, + rhs); + } +}; + +template +struct generic_product_impl { + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) { + generic_product_impl::evalTo(dst, lhs, rhs); + } +}; + +template +struct generic_product_impl + : generic_product_impl {}; + +template +struct generic_product_impl + : generic_product_impl {}; + +template +struct generic_product_impl + : generic_product_impl {}; + +template +struct generic_product_impl + : generic_product_impl {}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_EVALUATORS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Random.h b/src/3rdparty/eigen/Eigen/src/Core/Random.h new file mode 100644 index 0000000..f8a5435 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Random.h @@ -0,0 +1,207 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RANDOM_H +#define EIGEN_RANDOM_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct scalar_random_op { + inline const Scalar operator()() const { return random(); } +}; + +template +struct functor_traits > { + enum { Cost = 5 * NumTraits::MulCost, PacketAccess = false, IsRepeatable = false }; +}; + +} // end namespace internal + +/** \returns a random matrix expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * \not_reentrant + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Random() should be used + * instead. + * + * + * Example: \include MatrixBase_random_int_int.cpp + * Output: \verbinclude MatrixBase_random_int_int.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary matrix whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * See DenseBase::NullaryExpr(Index, const CustomNullaryOp&) for an example using C++11 random generators. + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index), DenseBase::Random() + */ +template +inline const typename DenseBase::RandomReturnType DenseBase::Random(Index rows, Index cols) { + return NullaryExpr(rows, cols, internal::scalar_random_op()); +} + +/** \returns a random vector expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * \not_reentrant + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Random() should be used + * instead. + * + * Example: \include MatrixBase_random_int.cpp + * Output: \verbinclude MatrixBase_random_int.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary vector whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index,Index), DenseBase::Random() + */ +template +inline const typename DenseBase::RandomReturnType DenseBase::Random(Index size) { + return NullaryExpr(size, internal::scalar_random_op()); +} + +/** \returns a fixed-size random matrix or vector expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_random.cpp + * Output: \verbinclude MatrixBase_random.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary matrix whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index,Index), DenseBase::Random(Index) + */ +template +inline const typename DenseBase::RandomReturnType DenseBase::Random() { + return NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, internal::scalar_random_op()); +} + +/** Sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * Example: \include MatrixBase_setRandom.cpp + * Output: \verbinclude MatrixBase_setRandom.out + * + * \sa class CwiseNullaryOp, setRandom(Index), setRandom(Index,Index) + */ +template +EIGEN_DEVICE_FUNC inline Derived& DenseBase::setRandom() { + return *this = Random(rows(), cols()); +} + +/** Resizes to the given \a newSize, and sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \only_for_vectors + * \not_reentrant + * + * Example: \include Matrix_setRandom_int.cpp + * Output: \verbinclude Matrix_setRandom_int.out + * + * \sa DenseBase::setRandom(), setRandom(Index,Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& PlainObjectBase::setRandom(Index newSize) { + resize(newSize); + return setRandom(); +} + +/** Resizes to the given size, and sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setRandom_int_int.cpp + * Output: \verbinclude Matrix_setRandom_int_int.out + * + * \sa DenseBase::setRandom(), setRandom(Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& PlainObjectBase::setRandom(Index rows, Index cols) { + resize(rows, cols); + return setRandom(); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to random values. For the parameter of type + * NoChange_t, just pass the special value \c NoChange. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), setRandom(Index), setRandom(Index, NoChange_t), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& PlainObjectBase::setRandom(NoChange_t, Index cols) { + return setRandom(rows(), cols); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to random values. For the parameter of type + * NoChange_t, just pass the special value \c NoChange. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), setRandom(Index), setRandom(NoChange_t, Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& PlainObjectBase::setRandom(Index rows, NoChange_t) { + return setRandom(rows, cols()); +} + +} // end namespace Eigen + +#endif // EIGEN_RANDOM_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/RandomImpl.h b/src/3rdparty/eigen/Eigen/src/Core/RandomImpl.h new file mode 100644 index 0000000..1a82e62 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/RandomImpl.h @@ -0,0 +1,262 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2024 Charles Schlosser +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RANDOM_IMPL_H +#define EIGEN_RANDOM_IMPL_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +/**************************************************************************** + * Implementation of random * + ****************************************************************************/ + +template +struct random_default_impl {}; + +template +struct random_impl : random_default_impl::IsComplex, NumTraits::IsInteger> {}; + +template +struct random_retval { + typedef Scalar type; +}; + +template +inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random(const Scalar& x, const Scalar& y) { + return EIGEN_MATHFUNC_IMPL(random, Scalar)::run(x, y); +} + +template +inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random() { + return EIGEN_MATHFUNC_IMPL(random, Scalar)::run(); +} + +// TODO: replace or provide alternatives to this, e.g. std::random_device +struct eigen_random_device { + using ReturnType = int; + static constexpr int Entropy = meta_floor_log2<(unsigned int)(RAND_MAX) + 1>::value; + static constexpr ReturnType Highest = RAND_MAX; + static EIGEN_DEVICE_FUNC inline ReturnType run() { return std::rand(); } +}; + +// Fill a built-in unsigned integer with numRandomBits beginning with the least significant bit +template +struct random_bits_impl { + EIGEN_STATIC_ASSERT(std::is_unsigned::value, SCALAR MUST BE A BUILT - IN UNSIGNED INTEGER) + using RandomDevice = eigen_random_device; + using RandomReturnType = typename RandomDevice::ReturnType; + static constexpr int kEntropy = RandomDevice::Entropy; + static constexpr int kTotalBits = sizeof(Scalar) * CHAR_BIT; + // return a Scalar filled with numRandomBits beginning from the least significant bit + static EIGEN_DEVICE_FUNC inline Scalar run(int numRandomBits) { + eigen_assert((numRandomBits >= 0) && (numRandomBits <= kTotalBits)); + const Scalar mask = Scalar(-1) >> ((kTotalBits - numRandomBits) & (kTotalBits - 1)); + Scalar randomBits = 0; + for (int shift = 0; shift < numRandomBits; shift += kEntropy) { + RandomReturnType r = RandomDevice::run(); + randomBits |= static_cast(r) << shift; + } + // clear the excess bits + randomBits &= mask; + return randomBits; + } +}; + +template +EIGEN_DEVICE_FUNC inline BitsType getRandomBits(int numRandomBits) { + return random_bits_impl::run(numRandomBits); +} + +// random implementation for a built-in floating point type +template ::value> +struct random_float_impl { + using BitsType = typename numext::get_integer_by_size::unsigned_type; + static constexpr EIGEN_DEVICE_FUNC inline int mantissaBits() { + const int digits = NumTraits::digits(); + return digits - 1; + } + static EIGEN_DEVICE_FUNC inline Scalar run(int numRandomBits) { + eigen_assert(numRandomBits >= 0 && numRandomBits <= mantissaBits()); + BitsType randomBits = getRandomBits(numRandomBits); + // if fewer than MantissaBits is requested, shift them to the left + randomBits <<= (mantissaBits() - numRandomBits); + // randomBits is in the half-open interval [2,4) + randomBits |= numext::bit_cast(Scalar(2)); + // result is in the half-open interval [-1,1) + Scalar result = numext::bit_cast(randomBits) - Scalar(3); + return result; + } +}; +// random implementation for a custom floating point type +// uses double as the implementation with a mantissa with a size equal to either the target scalar's mantissa or that of +// double, whichever is smaller +template +struct random_float_impl { + static EIGEN_DEVICE_FUNC inline int mantissaBits() { + const int digits = NumTraits::digits(); + constexpr int kDoubleDigits = NumTraits::digits(); + return numext::mini(digits, kDoubleDigits) - 1; + } + static EIGEN_DEVICE_FUNC inline Scalar run(int numRandomBits) { + eigen_assert(numRandomBits >= 0 && numRandomBits <= mantissaBits()); + Scalar result = static_cast(random_float_impl::run(numRandomBits)); + return result; + } +}; + +#if !EIGEN_COMP_NVCC +// random implementation for long double +// this specialization is not compatible with double-double scalars +template ::digits != (2 * std::numeric_limits::digits)))> +struct random_longdouble_impl { + static constexpr int Size = sizeof(long double); + static constexpr EIGEN_DEVICE_FUNC int mantissaBits() { return NumTraits::digits() - 1; } + static EIGEN_DEVICE_FUNC inline long double run(int numRandomBits) { + eigen_assert(numRandomBits >= 0 && numRandomBits <= mantissaBits()); + EIGEN_USING_STD(memcpy); + int numLowBits = numext::mini(numRandomBits, 64); + int numHighBits = numext::maxi(numRandomBits - 64, 0); + uint64_t randomBits[2]; + long double result = 2.0L; + memcpy(&randomBits, &result, Size); +#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__ + randomBits[0] |= getRandomBits(numLowBits); + randomBits[1] |= getRandomBits(numHighBits); +#elif __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__ + randomBits[0] |= getRandomBits(numHighBits); + randomBits[1] |= getRandomBits(numLowBits); +#else +#error Unexpected or undefined __BYTE_ORDER__ +#endif + memcpy(&result, &randomBits, Size); + result -= 3.0L; + return result; + } +}; +template <> +struct random_longdouble_impl { + static constexpr EIGEN_DEVICE_FUNC int mantissaBits() { return NumTraits::digits() - 1; } + static EIGEN_DEVICE_FUNC inline long double run(int numRandomBits) { + return static_cast(random_float_impl::run(numRandomBits)); + } +}; +template <> +struct random_float_impl : random_longdouble_impl<> {}; +#endif + +template +struct random_default_impl { + using Impl = random_float_impl; + static EIGEN_DEVICE_FUNC inline Scalar run(const Scalar& x, const Scalar& y, int numRandomBits) { + Scalar half_x = Scalar(0.5) * x; + Scalar half_y = Scalar(0.5) * y; + Scalar result = (half_x + half_y) + (half_y - half_x) * run(numRandomBits); + // result is in the half-open interval [x, y) -- provided that x < y + return result; + } + static EIGEN_DEVICE_FUNC inline Scalar run(const Scalar& x, const Scalar& y) { + return run(x, y, Impl::mantissaBits()); + } + static EIGEN_DEVICE_FUNC inline Scalar run(int numRandomBits) { return Impl::run(numRandomBits); } + static EIGEN_DEVICE_FUNC inline Scalar run() { return run(Impl::mantissaBits()); } +}; + +template ::IsSigned, bool BuiltIn = std::is_integral::value> +struct random_int_impl; + +// random implementation for a built-in unsigned integer type +template +struct random_int_impl { + static constexpr int kTotalBits = sizeof(Scalar) * CHAR_BIT; + static EIGEN_DEVICE_FUNC inline Scalar run(const Scalar& x, const Scalar& y) { + if (y <= x) return x; + Scalar range = y - x; + // handle edge case where [x,y] spans the entire range of Scalar + if (range == NumTraits::highest()) return run(); + Scalar count = range + 1; + // calculate the number of random bits needed to fill range + int numRandomBits = log2_ceil(count); + Scalar randomBits; + do { + randomBits = getRandomBits(numRandomBits); + // if the random draw is outside [0, range), try again (rejection sampling) + // in the worst-case scenario, the probability of rejection is: 1/2 - 1/2^numRandomBits < 50% + } while (randomBits >= count); + Scalar result = x + randomBits; + return result; + } + static EIGEN_DEVICE_FUNC inline Scalar run() { return getRandomBits(kTotalBits); } +}; + +// random implementation for a built-in signed integer type +template +struct random_int_impl { + static constexpr int kTotalBits = sizeof(Scalar) * CHAR_BIT; + using BitsType = typename make_unsigned::type; + static EIGEN_DEVICE_FUNC inline Scalar run(const Scalar& x, const Scalar& y) { + if (y <= x) return x; + // Avoid overflow by representing `range` as an unsigned type + BitsType range = static_cast(y) - static_cast(x); + BitsType randomBits = random_int_impl::run(0, range); + // Avoid overflow in the case where `x` is negative and there is a large range so + // `randomBits` would also be negative if cast to `Scalar` first. + Scalar result = static_cast(static_cast(x) + randomBits); + return result; + } + static EIGEN_DEVICE_FUNC inline Scalar run() { return static_cast(getRandomBits(kTotalBits)); } +}; + +// todo: custom integers +template +struct random_int_impl { + static EIGEN_DEVICE_FUNC inline Scalar run(const Scalar&, const Scalar&) { return run(); } + static EIGEN_DEVICE_FUNC inline Scalar run() { + eigen_assert(std::false_type::value && "RANDOM FOR CUSTOM INTEGERS NOT YET SUPPORTED"); + return Scalar(0); + } +}; + +template +struct random_default_impl : random_int_impl {}; + +template <> +struct random_impl { + static EIGEN_DEVICE_FUNC inline bool run(const bool& x, const bool& y) { + if (y <= x) return x; + return run(); + } + static EIGEN_DEVICE_FUNC inline bool run() { return getRandomBits(1) ? true : false; } +}; + +template +struct random_default_impl { + typedef typename NumTraits::Real RealScalar; + using Impl = random_impl; + static EIGEN_DEVICE_FUNC inline Scalar run(const Scalar& x, const Scalar& y, int numRandomBits) { + return Scalar(Impl::run(x.real(), y.real(), numRandomBits), Impl::run(x.imag(), y.imag(), numRandomBits)); + } + static EIGEN_DEVICE_FUNC inline Scalar run(const Scalar& x, const Scalar& y) { + return Scalar(Impl::run(x.real(), y.real()), Impl::run(x.imag(), y.imag())); + } + static EIGEN_DEVICE_FUNC inline Scalar run(int numRandomBits) { + return Scalar(Impl::run(numRandomBits), Impl::run(numRandomBits)); + } + static EIGEN_DEVICE_FUNC inline Scalar run() { return Scalar(Impl::run(), Impl::run()); } +}; + +} // namespace internal +} // namespace Eigen + +#endif // EIGEN_RANDOM_IMPL_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/RealView.h b/src/3rdparty/eigen/Eigen/src/Core/RealView.h new file mode 100644 index 0000000..7ba42f9 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/RealView.h @@ -0,0 +1,250 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2025 Charlie Schlosser +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REALVIEW_H +#define EIGEN_REALVIEW_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +// Vectorized assignment to RealView requires array-oriented access to the real and imaginary components. +// From https://en.cppreference.com/w/cpp/numeric/complex.html: +// For any pointer to an element of an array of std::complex named p and any valid array index i, +// reinterpret_cast(p)[2 * i] is the real part of the complex number p[i], and +// reinterpret_cast(p)[2 * i + 1] is the imaginary part of the complex number p[i]. + +template +struct complex_array_access : std::false_type {}; +template <> +struct complex_array_access> : std::true_type {}; +template <> +struct complex_array_access> : std::true_type {}; +template <> +struct complex_array_access> : std::true_type {}; + +template +struct traits> : public traits { + template + static constexpr int double_size(T size, bool times_two) { + int size_as_int = int(size); + if (size_as_int == Dynamic) return Dynamic; + return times_two ? (2 * size_as_int) : size_as_int; + } + using Base = traits; + using ComplexScalar = typename Base::Scalar; + using Scalar = typename NumTraits::Real; + static constexpr int ActualDirectAccessBit = complex_array_access::value ? DirectAccessBit : 0; + static constexpr int ActualPacketAccessBit = packet_traits::Vectorizable ? PacketAccessBit : 0; + static constexpr int FlagMask = + ActualDirectAccessBit | ActualPacketAccessBit | HereditaryBits | LinearAccessBit | LvalueBit; + static constexpr int BaseFlags = int(evaluator::Flags) | int(Base::Flags); + static constexpr int Flags = BaseFlags & FlagMask; + static constexpr bool IsRowMajor = Flags & RowMajorBit; + static constexpr int RowsAtCompileTime = double_size(Base::RowsAtCompileTime, !IsRowMajor); + static constexpr int ColsAtCompileTime = double_size(Base::ColsAtCompileTime, IsRowMajor); + static constexpr int SizeAtCompileTime = size_at_compile_time(RowsAtCompileTime, ColsAtCompileTime); + static constexpr int MaxRowsAtCompileTime = double_size(Base::MaxRowsAtCompileTime, !IsRowMajor); + static constexpr int MaxColsAtCompileTime = double_size(Base::MaxColsAtCompileTime, IsRowMajor); + static constexpr int MaxSizeAtCompileTime = size_at_compile_time(MaxRowsAtCompileTime, MaxColsAtCompileTime); + static constexpr int OuterStrideAtCompileTime = double_size(outer_stride_at_compile_time::ret, true); + static constexpr int InnerStrideAtCompileTime = inner_stride_at_compile_time::ret; +}; + +template +struct evaluator> : private evaluator { + using BaseEvaluator = evaluator; + using XprType = RealView; + using ExpressionTraits = traits; + using ComplexScalar = typename ExpressionTraits::ComplexScalar; + using ComplexCoeffReturnType = typename BaseEvaluator::CoeffReturnType; + using Scalar = typename ExpressionTraits::Scalar; + + static constexpr bool IsRowMajor = ExpressionTraits::IsRowMajor; + static constexpr int Flags = ExpressionTraits::Flags; + static constexpr int CoeffReadCost = BaseEvaluator::CoeffReadCost; + static constexpr int Alignment = BaseEvaluator::Alignment; + + EIGEN_DEVICE_FUNC explicit evaluator(XprType realView) : BaseEvaluator(realView.m_xpr) {} + + template ::value, typename = std::enable_if_t> + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index row, Index col) const { + ComplexCoeffReturnType cscalar = BaseEvaluator::coeff(IsRowMajor ? row : row / 2, IsRowMajor ? col / 2 : col); + Index p = (IsRowMajor ? col : row) & 1; + return p ? numext::real(cscalar) : numext::imag(cscalar); + } + + template ::value, typename = std::enable_if_t> + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar& coeff(Index row, Index col) const { + ComplexCoeffReturnType cscalar = BaseEvaluator::coeff(IsRowMajor ? row : row / 2, IsRowMajor ? col / 2 : col); + Index p = (IsRowMajor ? col : row) & 1; + return reinterpret_cast(cscalar)[p]; + } + + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) { + ComplexScalar& cscalar = BaseEvaluator::coeffRef(IsRowMajor ? row : row / 2, IsRowMajor ? col / 2 : col); + Index p = (IsRowMajor ? col : row) & 1; + return reinterpret_cast(cscalar)[p]; + } + + template ::value, typename = std::enable_if_t> + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index index) const { + ComplexCoeffReturnType cscalar = BaseEvaluator::coeff(index / 2); + Index p = index & 1; + return p ? numext::real(cscalar) : numext::imag(cscalar); + } + + template ::value, typename = std::enable_if_t> + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar& coeff(Index index) const { + ComplexCoeffReturnType cscalar = BaseEvaluator::coeff(index / 2); + Index p = index & 1; + return reinterpret_cast(cscalar)[p]; + } + + constexpr EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) { + ComplexScalar& cscalar = BaseEvaluator::coeffRef(index / 2); + Index p = index & 1; + return reinterpret_cast(cscalar)[p]; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const { + constexpr int RealPacketSize = unpacket_traits::size; + using ComplexPacket = typename find_packet_by_size::type; + EIGEN_STATIC_ASSERT((find_packet_by_size::value), + MISSING COMPATIBLE COMPLEX PACKET TYPE) + eigen_assert(((IsRowMajor ? col : row) % 2 == 0) && "the inner index must be even"); + + Index crow = IsRowMajor ? row : row / 2; + Index ccol = IsRowMajor ? col / 2 : col; + ComplexPacket cpacket = BaseEvaluator::template packet(crow, ccol); + return preinterpret(cpacket); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packet(Index index) const { + constexpr int RealPacketSize = unpacket_traits::size; + using ComplexPacket = typename find_packet_by_size::type; + EIGEN_STATIC_ASSERT((find_packet_by_size::value), + MISSING COMPATIBLE COMPLEX PACKET TYPE) + eigen_assert((index % 2 == 0) && "the index must be even"); + + Index cindex = index / 2; + ComplexPacket cpacket = BaseEvaluator::template packet(cindex); + return preinterpret(cpacket); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index row, Index col, Index begin, Index count) const { + constexpr int RealPacketSize = unpacket_traits::size; + using ComplexPacket = typename find_packet_by_size::type; + EIGEN_STATIC_ASSERT((find_packet_by_size::value), + MISSING COMPATIBLE COMPLEX PACKET TYPE) + eigen_assert(((IsRowMajor ? col : row) % 2 == 0) && "the inner index must be even"); + eigen_assert((begin % 2 == 0) && (count % 2 == 0) && "begin and count must be even"); + + Index crow = IsRowMajor ? row : row / 2; + Index ccol = IsRowMajor ? col / 2 : col; + Index cbegin = begin / 2; + Index ccount = count / 2; + ComplexPacket cpacket = BaseEvaluator::template packetSegment(crow, ccol, cbegin, ccount); + return preinterpret(cpacket); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegment(Index index, Index begin, Index count) const { + constexpr int RealPacketSize = unpacket_traits::size; + using ComplexPacket = typename find_packet_by_size::type; + EIGEN_STATIC_ASSERT((find_packet_by_size::value), + MISSING COMPATIBLE COMPLEX PACKET TYPE) + eigen_assert((index % 2 == 0) && "the index must be even"); + eigen_assert((begin % 2 == 0) && (count % 2 == 0) && "begin and count must be even"); + + Index cindex = index / 2; + Index cbegin = begin / 2; + Index ccount = count / 2; + ComplexPacket cpacket = BaseEvaluator::template packetSegment(cindex, cbegin, ccount); + return preinterpret(cpacket); + } +}; + +} // namespace internal + +template +class RealView : public internal::dense_xpr_base>::type { + using ExpressionTraits = internal::traits; + EIGEN_STATIC_ASSERT(NumTraits::IsComplex, SCALAR MUST BE COMPLEX) + public: + using Scalar = typename ExpressionTraits::Scalar; + using Nested = RealView; + + EIGEN_DEVICE_FUNC explicit RealView(Xpr& xpr) : m_xpr(xpr) {} + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return Xpr::IsRowMajor ? m_xpr.rows() : 2 * m_xpr.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return Xpr::IsRowMajor ? 2 * m_xpr.cols() : m_xpr.cols(); } + EIGEN_DEVICE_FUNC constexpr Index size() const noexcept { return 2 * m_xpr.size(); } + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return m_xpr.innerStride(); } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return 2 * m_xpr.outerStride(); } + EIGEN_DEVICE_FUNC void resize(Index rows, Index cols) { + m_xpr.resize(Xpr::IsRowMajor ? rows : rows / 2, Xpr::IsRowMajor ? cols / 2 : cols); + } + EIGEN_DEVICE_FUNC void resize(Index size) { m_xpr.resize(size / 2); } + EIGEN_DEVICE_FUNC Scalar* data() { return reinterpret_cast(m_xpr.data()); } + EIGEN_DEVICE_FUNC const Scalar* data() const { return reinterpret_cast(m_xpr.data()); } + + EIGEN_DEVICE_FUNC RealView(const RealView&) = default; + + EIGEN_DEVICE_FUNC RealView& operator=(const RealView& other); + + template + EIGEN_DEVICE_FUNC RealView& operator=(const RealView& other); + + template + EIGEN_DEVICE_FUNC RealView& operator=(const DenseBase& other); + + protected: + friend struct internal::evaluator>; + Xpr& m_xpr; +}; + +template +EIGEN_DEVICE_FUNC RealView& RealView::operator=(const RealView& other) { + internal::call_assignment(*this, other); + return *this; +} + +template +template +EIGEN_DEVICE_FUNC RealView& RealView::operator=(const RealView& other) { + internal::call_assignment(*this, other); + return *this; +} + +template +template +EIGEN_DEVICE_FUNC RealView& RealView::operator=(const DenseBase& other) { + internal::call_assignment(*this, other.derived()); + return *this; +} + +template +EIGEN_DEVICE_FUNC typename DenseBase::RealViewReturnType DenseBase::realView() { + return RealViewReturnType(derived()); +} + +template +EIGEN_DEVICE_FUNC typename DenseBase::ConstRealViewReturnType DenseBase::realView() const { + return ConstRealViewReturnType(derived()); +} + +} // namespace Eigen + +#endif // EIGEN_REALVIEW_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Redux.h b/src/3rdparty/eigen/Eigen/src/Core/Redux.h new file mode 100644 index 0000000..4e9ab0e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Redux.h @@ -0,0 +1,535 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REDUX_H +#define EIGEN_REDUX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +// TODO +// * implement other kind of vectorization +// * factorize code + +/*************************************************************************** + * Part 1 : the logic deciding a strategy for vectorization and unrolling + ***************************************************************************/ + +template +struct redux_traits { + public: + typedef typename find_best_packet::type PacketType; + enum { + PacketSize = unpacket_traits::size, + InnerMaxSize = int(Evaluator::IsRowMajor) ? Evaluator::MaxColsAtCompileTime : Evaluator::MaxRowsAtCompileTime, + OuterMaxSize = int(Evaluator::IsRowMajor) ? Evaluator::MaxRowsAtCompileTime : Evaluator::MaxColsAtCompileTime, + SliceVectorizedWork = int(InnerMaxSize) == Dynamic ? Dynamic + : int(OuterMaxSize) == Dynamic ? (int(InnerMaxSize) >= int(PacketSize) ? Dynamic : 0) + : (int(InnerMaxSize) / int(PacketSize)) * int(OuterMaxSize) + }; + + enum { + MayLinearize = (int(Evaluator::Flags) & LinearAccessBit), + MightVectorize = (int(Evaluator::Flags) & ActualPacketAccessBit) && (functor_traits::PacketAccess), + MayLinearVectorize = bool(MightVectorize) && bool(MayLinearize), + MaySliceVectorize = bool(MightVectorize) && (int(SliceVectorizedWork) == Dynamic || int(SliceVectorizedWork) >= 3) + }; + + public: + enum { + Traversal = int(MayLinearVectorize) ? int(LinearVectorizedTraversal) + : int(MaySliceVectorize) ? int(SliceVectorizedTraversal) + : int(MayLinearize) ? int(LinearTraversal) + : int(DefaultTraversal) + }; + + public: + enum { + Cost = Evaluator::SizeAtCompileTime == Dynamic + ? HugeCost + : int(Evaluator::SizeAtCompileTime) * int(Evaluator::CoeffReadCost) + + (Evaluator::SizeAtCompileTime - 1) * functor_traits::Cost, + UnrollingLimit = EIGEN_UNROLLING_LIMIT * (int(Traversal) == int(DefaultTraversal) ? 1 : int(PacketSize)) + }; + + public: + enum { Unrolling = Cost <= UnrollingLimit ? CompleteUnrolling : NoUnrolling }; + +#ifdef EIGEN_DEBUG_ASSIGN + static void debug() { + std::cerr << "Xpr: " << typeid(typename Evaluator::XprType).name() << std::endl; + std::cerr.setf(std::ios::hex, std::ios::basefield); + EIGEN_DEBUG_VAR(Evaluator::Flags) + std::cerr.unsetf(std::ios::hex); + EIGEN_DEBUG_VAR(InnerMaxSize) + EIGEN_DEBUG_VAR(OuterMaxSize) + EIGEN_DEBUG_VAR(SliceVectorizedWork) + EIGEN_DEBUG_VAR(PacketSize) + EIGEN_DEBUG_VAR(MightVectorize) + EIGEN_DEBUG_VAR(MayLinearVectorize) + EIGEN_DEBUG_VAR(MaySliceVectorize) + std::cerr << "Traversal" + << " = " << Traversal << " (" << demangle_traversal(Traversal) << ")" << std::endl; + EIGEN_DEBUG_VAR(UnrollingLimit) + std::cerr << "Unrolling" + << " = " << Unrolling << " (" << demangle_unrolling(Unrolling) << ")" << std::endl; + std::cerr << std::endl; + } +#endif +}; + +/*************************************************************************** + * Part 2 : unrollers + ***************************************************************************/ + +/*** no vectorization ***/ + +template +struct redux_novec_unroller { + static constexpr Index HalfLength = Length / 2; + + typedef typename Evaluator::Scalar Scalar; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func& func) { + return func(redux_novec_unroller::run(eval, func), + redux_novec_unroller::run(eval, func)); + } +}; + +template +struct redux_novec_unroller { + static constexpr Index outer = Start / Evaluator::InnerSizeAtCompileTime; + static constexpr Index inner = Start % Evaluator::InnerSizeAtCompileTime; + + typedef typename Evaluator::Scalar Scalar; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func&) { + return eval.coeffByOuterInner(outer, inner); + } +}; + +// This is actually dead code and will never be called. It is required +// to prevent false warnings regarding failed inlining though +// for 0 length run() will never be called at all. +template +struct redux_novec_unroller { + typedef typename Evaluator::Scalar Scalar; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator&, const Func&) { return Scalar(); } +}; + +template +struct redux_novec_linear_unroller { + static constexpr Index HalfLength = Length / 2; + + typedef typename Evaluator::Scalar Scalar; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func& func) { + return func(redux_novec_linear_unroller::run(eval, func), + redux_novec_linear_unroller::run(eval, func)); + } +}; + +template +struct redux_novec_linear_unroller { + typedef typename Evaluator::Scalar Scalar; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func&) { + return eval.coeff(Start); + } +}; + +// This is actually dead code and will never be called. It is required +// to prevent false warnings regarding failed inlining though +// for 0 length run() will never be called at all. +template +struct redux_novec_linear_unroller { + typedef typename Evaluator::Scalar Scalar; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator&, const Func&) { return Scalar(); } +}; + +/*** vectorization ***/ + +template +struct redux_vec_unroller { + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE PacketType run(const Evaluator& eval, const Func& func) { + constexpr Index HalfLength = Length / 2; + + return func.packetOp( + redux_vec_unroller::template run(eval, func), + redux_vec_unroller::template run(eval, + func)); + } +}; + +template +struct redux_vec_unroller { + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE PacketType run(const Evaluator& eval, const Func&) { + constexpr Index PacketSize = unpacket_traits::size; + constexpr Index index = Start * PacketSize; + constexpr Index outer = index / int(Evaluator::InnerSizeAtCompileTime); + constexpr Index inner = index % int(Evaluator::InnerSizeAtCompileTime); + constexpr int alignment = Evaluator::Alignment; + + return eval.template packetByOuterInner(outer, inner); + } +}; + +template +struct redux_vec_linear_unroller { + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE PacketType run(const Evaluator& eval, const Func& func) { + constexpr Index HalfLength = Length / 2; + + return func.packetOp( + redux_vec_linear_unroller::template run(eval, func), + redux_vec_linear_unroller::template run( + eval, func)); + } +}; + +template +struct redux_vec_linear_unroller { + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE PacketType run(const Evaluator& eval, const Func&) { + constexpr Index PacketSize = unpacket_traits::size; + constexpr Index index = (Start * PacketSize); + constexpr int alignment = Evaluator::Alignment; + return eval.template packet(index); + } +}; + +/*************************************************************************** + * Part 3 : implementation of all cases + ***************************************************************************/ + +template ::Traversal, + int Unrolling = redux_traits::Unrolling> +struct redux_impl; + +template +struct redux_impl { + typedef typename Evaluator::Scalar Scalar; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func& func, const XprType& xpr) { + eigen_assert(xpr.rows() > 0 && xpr.cols() > 0 && "you are using an empty matrix"); + Scalar res = eval.coeffByOuterInner(0, 0); + for (Index i = 1; i < xpr.innerSize(); ++i) res = func(res, eval.coeffByOuterInner(0, i)); + for (Index i = 1; i < xpr.outerSize(); ++i) + for (Index j = 0; j < xpr.innerSize(); ++j) res = func(res, eval.coeffByOuterInner(i, j)); + return res; + } +}; + +template +struct redux_impl { + typedef typename Evaluator::Scalar Scalar; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func& func, const XprType& xpr) { + eigen_assert(xpr.size() > 0 && "you are using an empty matrix"); + Scalar res = eval.coeff(0); + for (Index k = 1; k < xpr.size(); ++k) res = func(res, eval.coeff(k)); + return res; + } +}; + +template +struct redux_impl + : redux_novec_unroller { + typedef redux_novec_unroller Base; + typedef typename Evaluator::Scalar Scalar; + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func& func, + const XprType& /*xpr*/) { + return Base::run(eval, func); + } +}; + +template +struct redux_impl + : redux_novec_linear_unroller { + typedef redux_novec_linear_unroller Base; + typedef typename Evaluator::Scalar Scalar; + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func& func, + const XprType& /*xpr*/) { + return Base::run(eval, func); + } +}; + +template +struct redux_impl { + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketScalar; + + template + static Scalar run(const Evaluator& eval, const Func& func, const XprType& xpr) { + const Index size = xpr.size(); + + constexpr Index packetSize = redux_traits::PacketSize; + constexpr int packetAlignment = unpacket_traits::alignment; + constexpr int alignment0 = + (bool(Evaluator::Flags & DirectAccessBit) && bool(packet_traits::AlignedOnScalar)) + ? int(packetAlignment) + : int(Unaligned); + constexpr int alignment = plain_enum_max(alignment0, Evaluator::Alignment); + const Index alignedStart = internal::first_default_aligned(xpr); + const Index alignedSize2 = ((size - alignedStart) / (2 * packetSize)) * (2 * packetSize); + const Index alignedSize = ((size - alignedStart) / (packetSize)) * (packetSize); + const Index alignedEnd2 = alignedStart + alignedSize2; + const Index alignedEnd = alignedStart + alignedSize; + Scalar res; + if (alignedSize) { + PacketScalar packet_res0 = eval.template packet(alignedStart); + if (alignedSize > packetSize) // we have at least two packets to partly unroll the loop + { + PacketScalar packet_res1 = eval.template packet(alignedStart + packetSize); + for (Index index = alignedStart + 2 * packetSize; index < alignedEnd2; index += 2 * packetSize) { + packet_res0 = func.packetOp(packet_res0, eval.template packet(index)); + packet_res1 = func.packetOp(packet_res1, eval.template packet(index + packetSize)); + } + + packet_res0 = func.packetOp(packet_res0, packet_res1); + if (alignedEnd > alignedEnd2) + packet_res0 = func.packetOp(packet_res0, eval.template packet(alignedEnd2)); + } + res = func.predux(packet_res0); + + for (Index index = 0; index < alignedStart; ++index) res = func(res, eval.coeff(index)); + + for (Index index = alignedEnd; index < size; ++index) res = func(res, eval.coeff(index)); + } else // too small to vectorize anything. + // since this is dynamic-size hence inefficient anyway for such small sizes, don't try to optimize. + { + res = eval.coeff(0); + for (Index index = 1; index < size; ++index) res = func(res, eval.coeff(index)); + } + + return res; + } +}; + +// NOTE: for SliceVectorizedTraversal we simply bypass unrolling +template +struct redux_impl { + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketType; + + template + EIGEN_DEVICE_FUNC static Scalar run(const Evaluator& eval, const Func& func, const XprType& xpr) { + eigen_assert(xpr.rows() > 0 && xpr.cols() > 0 && "you are using an empty matrix"); + constexpr Index packetSize = redux_traits::PacketSize; + const Index innerSize = xpr.innerSize(); + const Index outerSize = xpr.outerSize(); + const Index packetedInnerSize = ((innerSize) / packetSize) * packetSize; + Scalar res; + if (packetedInnerSize) { + PacketType packet_res = eval.template packet(0, 0); + for (Index j = 0; j < outerSize; ++j) + for (Index i = (j == 0 ? packetSize : 0); i < packetedInnerSize; i += Index(packetSize)) + packet_res = func.packetOp(packet_res, eval.template packetByOuterInner(j, i)); + + res = func.predux(packet_res); + for (Index j = 0; j < outerSize; ++j) + for (Index i = packetedInnerSize; i < innerSize; ++i) res = func(res, eval.coeffByOuterInner(j, i)); + } else // too small to vectorize anything. + // since this is dynamic-size hence inefficient anyway for such small sizes, don't try to optimize. + { + res = redux_impl::run(eval, func, xpr); + } + + return res; + } +}; + +template +struct redux_impl { + typedef typename Evaluator::Scalar Scalar; + + typedef typename redux_traits::PacketType PacketType; + static constexpr Index PacketSize = redux_traits::PacketSize; + static constexpr Index Size = Evaluator::SizeAtCompileTime; + static constexpr Index VectorizedSize = (int(Size) / int(PacketSize)) * int(PacketSize); + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Scalar run(const Evaluator& eval, const Func& func, const XprType& xpr) { + EIGEN_ONLY_USED_FOR_DEBUG(xpr) + eigen_assert(xpr.rows() > 0 && xpr.cols() > 0 && "you are using an empty matrix"); + if (VectorizedSize > 0) { + Scalar res = func.predux( + redux_vec_linear_unroller::template run(eval, func)); + if (VectorizedSize != Size) + res = func( + res, redux_novec_linear_unroller::run(eval, func)); + return res; + } else { + return redux_novec_linear_unroller::run(eval, func); + } + } +}; + +// evaluator adaptor +template +class redux_evaluator : public internal::evaluator { + typedef internal::evaluator Base; + + public: + typedef XprType_ XprType; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit redux_evaluator(const XprType& xpr) : Base(xpr) {} + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + typedef typename XprType::PacketScalar PacketScalar; + + enum { + MaxRowsAtCompileTime = XprType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = XprType::MaxColsAtCompileTime, + // TODO we should not remove DirectAccessBit and rather find an elegant way to query the alignment offset at runtime + // from the evaluator + Flags = Base::Flags & ~DirectAccessBit, + IsRowMajor = XprType::IsRowMajor, + SizeAtCompileTime = XprType::SizeAtCompileTime, + InnerSizeAtCompileTime = XprType::InnerSizeAtCompileTime + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE CoeffReturnType coeffByOuterInner(Index outer, Index inner) const { + return Base::coeff(IsRowMajor ? outer : inner, IsRowMajor ? inner : outer); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetByOuterInner(Index outer, Index inner) const { + return Base::template packet(IsRowMajor ? outer : inner, IsRowMajor ? inner : outer); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE PacketType packetSegmentByOuterInner(Index outer, Index inner, Index begin, + Index count) const { + return Base::template packetSegment(IsRowMajor ? outer : inner, IsRowMajor ? inner : outer, + begin, count); + } +}; + +} // end namespace internal + +/*************************************************************************** + * Part 4 : public API + ***************************************************************************/ + +/** \returns the result of a full redux operation on the whole matrix or vector using \a func + * + * The template parameter \a BinaryOp is the type of the functor \a func which must be + * an associative operator. Both current C++98 and C++11 functor styles are handled. + * + * \warning the matrix must be not empty, otherwise an assertion is triggered. + * + * \sa DenseBase::sum(), DenseBase::minCoeff(), DenseBase::maxCoeff(), MatrixBase::colwise(), MatrixBase::rowwise() + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar DenseBase::redux( + const Func& func) const { + eigen_assert(this->rows() > 0 && this->cols() > 0 && "you are using an empty matrix"); + + typedef typename internal::redux_evaluator ThisEvaluator; + ThisEvaluator thisEval(derived()); + + // The initial expression is passed to the reducer as an additional argument instead of + // passing it as a member of redux_evaluator to help + return internal::redux_impl::run(thisEval, func, derived()); +} + +/** \returns the minimum of all coefficients of \c *this. + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is minimum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar DenseBase::minCoeff() const { + return derived().redux(Eigen::internal::scalar_min_op()); +} + +/** \returns the maximum of all coefficients of \c *this. + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is maximum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar DenseBase::maxCoeff() const { + return derived().redux(Eigen::internal::scalar_max_op()); +} + +/** \returns the sum of all coefficients of \c *this + * + * If \c *this is empty, then the value 0 is returned. + * + * \sa trace(), prod(), mean() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar DenseBase::sum() const { + if (SizeAtCompileTime == 0 || (SizeAtCompileTime == Dynamic && size() == 0)) return Scalar(0); + return derived().redux(Eigen::internal::scalar_sum_op()); +} + +/** \returns the mean of all coefficients of *this + * + * \sa trace(), prod(), sum() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar DenseBase::mean() const { +#ifdef __INTEL_COMPILER +#pragma warning push +#pragma warning(disable : 2259) +#endif + return Scalar(derived().redux(Eigen::internal::scalar_sum_op())) / Scalar(this->size()); +#ifdef __INTEL_COMPILER +#pragma warning pop +#endif +} + +/** \returns the product of all coefficients of *this + * + * Example: \include MatrixBase_prod.cpp + * Output: \verbinclude MatrixBase_prod.out + * + * \sa sum(), mean(), trace() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar DenseBase::prod() const { + if (SizeAtCompileTime == 0 || (SizeAtCompileTime == Dynamic && size() == 0)) return Scalar(1); + return derived().redux(Eigen::internal::scalar_product_op()); +} + +/** \returns the trace of \c *this, i.e. the sum of the coefficients on the main diagonal. + * + * \c *this can be any matrix, not necessarily square. + * + * \sa diagonal(), sum() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar MatrixBase::trace() const { + return derived().diagonal().sum(); +} + +} // end namespace Eigen + +#endif // EIGEN_REDUX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Ref.h b/src/3rdparty/eigen/Eigen/src/Core/Ref.h new file mode 100644 index 0000000..30ec277 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Ref.h @@ -0,0 +1,383 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2012 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REF_H +#define EIGEN_REF_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct traits > + : public traits > { + typedef PlainObjectType_ PlainObjectType; + typedef StrideType_ StrideType; + enum { + Options = Options_, + Flags = traits >::Flags | NestByRefBit, + Alignment = traits >::Alignment, + InnerStrideAtCompileTime = traits >::InnerStrideAtCompileTime, + OuterStrideAtCompileTime = traits >::OuterStrideAtCompileTime + }; + + template + struct match { + enum { + IsVectorAtCompileTime = PlainObjectType::IsVectorAtCompileTime || Derived::IsVectorAtCompileTime, + HasDirectAccess = internal::has_direct_access::ret, + StorageOrderMatch = + IsVectorAtCompileTime || ((PlainObjectType::Flags & RowMajorBit) == (Derived::Flags & RowMajorBit)), + InnerStrideMatch = int(InnerStrideAtCompileTime) == int(Dynamic) || + int(InnerStrideAtCompileTime) == int(Derived::InnerStrideAtCompileTime) || + (int(InnerStrideAtCompileTime) == 0 && int(Derived::InnerStrideAtCompileTime) == 1), + OuterStrideMatch = IsVectorAtCompileTime || int(OuterStrideAtCompileTime) == int(Dynamic) || + int(OuterStrideAtCompileTime) == int(Derived::OuterStrideAtCompileTime), + // NOTE, this indirection of evaluator::Alignment is needed + // to workaround a very strange bug in MSVC related to the instantiation + // of has_*ary_operator in evaluator. + // This line is surprisingly very sensitive. For instance, simply adding parenthesis + // as "DerivedAlignment = (int(evaluator::Alignment))," will make MSVC fail... + DerivedAlignment = int(evaluator::Alignment), + AlignmentMatch = (int(traits::Alignment) == int(Unaligned)) || + (DerivedAlignment >= int(Alignment)), // FIXME the first condition is not very clear, it should + // be replaced by the required alignment + ScalarTypeMatch = internal::is_same::value, + MatchAtCompileTime = HasDirectAccess && StorageOrderMatch && InnerStrideMatch && OuterStrideMatch && + AlignmentMatch && ScalarTypeMatch + }; + typedef std::conditional_t type; + }; +}; + +template +struct traits > : public traits {}; + +} // namespace internal + +template +class RefBase : public MapBase { + typedef typename internal::traits::PlainObjectType PlainObjectType; + typedef typename internal::traits::StrideType StrideType; + + public: + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(RefBase) + + EIGEN_DEVICE_FUNC constexpr Index innerStride() const { + return StrideType::InnerStrideAtCompileTime != 0 ? m_stride.inner() : 1; + } + + EIGEN_DEVICE_FUNC constexpr Index outerStride() const { + return StrideType::OuterStrideAtCompileTime != 0 ? m_stride.outer() + : IsVectorAtCompileTime ? this->size() + : int(Flags) & RowMajorBit ? this->cols() + : this->rows(); + } + + EIGEN_DEVICE_FUNC RefBase() + : Base(0, RowsAtCompileTime == Dynamic ? 0 : RowsAtCompileTime, + ColsAtCompileTime == Dynamic ? 0 : ColsAtCompileTime), + // Stride<> does not allow default ctor for Dynamic strides, so let' initialize it with dummy values: + m_stride(StrideType::OuterStrideAtCompileTime == Dynamic ? 0 : StrideType::OuterStrideAtCompileTime, + StrideType::InnerStrideAtCompileTime == Dynamic ? 0 : StrideType::InnerStrideAtCompileTime) {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(RefBase) + + protected: + typedef Stride StrideBase; + + // Resolves inner stride if default 0. + static EIGEN_DEVICE_FUNC constexpr Index resolveInnerStride(Index inner) { return inner == 0 ? 1 : inner; } + + // Resolves outer stride if default 0. + static EIGEN_DEVICE_FUNC constexpr Index resolveOuterStride(Index inner, Index outer, Index rows, Index cols, + bool isVectorAtCompileTime, bool isRowMajor) { + return outer == 0 ? isVectorAtCompileTime ? inner * rows * cols : isRowMajor ? inner * cols : inner * rows : outer; + } + + // Returns true if construction is valid, false if there is a stride mismatch, + // and fails if there is a size mismatch. + template + EIGEN_DEVICE_FUNC bool construct(Expression& expr) { + // Check matrix sizes. If this is a compile-time vector, we do allow + // implicitly transposing. + EIGEN_STATIC_ASSERT(EIGEN_PREDICATE_SAME_MATRIX_SIZE(PlainObjectType, Expression) + // If it is a vector, the transpose sizes might match. + || (PlainObjectType::IsVectorAtCompileTime && + ((int(PlainObjectType::RowsAtCompileTime) == Eigen::Dynamic || + int(Expression::ColsAtCompileTime) == Eigen::Dynamic || + int(PlainObjectType::RowsAtCompileTime) == int(Expression::ColsAtCompileTime)) && + (int(PlainObjectType::ColsAtCompileTime) == Eigen::Dynamic || + int(Expression::RowsAtCompileTime) == Eigen::Dynamic || + int(PlainObjectType::ColsAtCompileTime) == int(Expression::RowsAtCompileTime)))), + YOU_MIXED_MATRICES_OF_DIFFERENT_SIZES) + + // Determine runtime rows and columns. + Index rows = expr.rows(); + Index cols = expr.cols(); + if (PlainObjectType::RowsAtCompileTime == 1) { + eigen_assert(expr.rows() == 1 || expr.cols() == 1); + rows = 1; + cols = expr.size(); + } else if (PlainObjectType::ColsAtCompileTime == 1) { + eigen_assert(expr.rows() == 1 || expr.cols() == 1); + rows = expr.size(); + cols = 1; + } + // Verify that the sizes are valid. + eigen_assert((PlainObjectType::RowsAtCompileTime == Dynamic) || (PlainObjectType::RowsAtCompileTime == rows)); + eigen_assert((PlainObjectType::ColsAtCompileTime == Dynamic) || (PlainObjectType::ColsAtCompileTime == cols)); + + // If this is a vector, we might be transposing, which means that stride should swap. + const bool transpose = PlainObjectType::IsVectorAtCompileTime && (rows != expr.rows()); + // If the storage format differs, we also need to swap the stride. + const bool row_major = ((PlainObjectType::Flags)&RowMajorBit) != 0; + const bool expr_row_major = (Expression::Flags & RowMajorBit) != 0; + const bool storage_differs = (row_major != expr_row_major); + + const bool swap_stride = (transpose != storage_differs); + + // Determine expr's actual strides, resolving any defaults if zero. + const Index expr_inner_actual = resolveInnerStride(expr.innerStride()); + const Index expr_outer_actual = resolveOuterStride(expr_inner_actual, expr.outerStride(), expr.rows(), expr.cols(), + Expression::IsVectorAtCompileTime != 0, expr_row_major); + + // If this is a column-major row vector or row-major column vector, the inner-stride + // is arbitrary, so set it to either the compile-time inner stride or 1. + const bool row_vector = (rows == 1); + const bool col_vector = (cols == 1); + const Index inner_stride = + ((!row_major && row_vector) || (row_major && col_vector)) + ? (StrideType::InnerStrideAtCompileTime > 0 ? Index(StrideType::InnerStrideAtCompileTime) : 1) + : swap_stride ? expr_outer_actual + : expr_inner_actual; + + // If this is a column-major column vector or row-major row vector, the outer-stride + // is arbitrary, so set it to either the compile-time outer stride or vector size. + const Index outer_stride = + ((!row_major && col_vector) || (row_major && row_vector)) + ? (StrideType::OuterStrideAtCompileTime > 0 ? Index(StrideType::OuterStrideAtCompileTime) + : rows * cols * inner_stride) + : swap_stride ? expr_inner_actual + : expr_outer_actual; + + // Check if given inner/outer strides are compatible with compile-time strides. + const bool inner_valid = (StrideType::InnerStrideAtCompileTime == Dynamic) || + (resolveInnerStride(Index(StrideType::InnerStrideAtCompileTime)) == inner_stride); + if (!inner_valid) { + return false; + } + + const bool outer_valid = + (StrideType::OuterStrideAtCompileTime == Dynamic) || + (resolveOuterStride(inner_stride, Index(StrideType::OuterStrideAtCompileTime), rows, cols, + PlainObjectType::IsVectorAtCompileTime != 0, row_major) == outer_stride); + if (!outer_valid) { + return false; + } + + internal::construct_at(this, expr.data(), rows, cols); + internal::construct_at(&m_stride, (StrideType::OuterStrideAtCompileTime == 0) ? 0 : outer_stride, + (StrideType::InnerStrideAtCompileTime == 0) ? 0 : inner_stride); + return true; + } + + StrideBase m_stride; +}; + +/** \class Ref + * \ingroup Core_Module + * + * \brief A matrix or vector expression mapping an existing expression + * + * \tparam PlainObjectType the equivalent matrix type of the mapped data + * \tparam Options specifies the pointer alignment in bytes. It can be: \c #Aligned128, , \c #Aligned64, \c #Aligned32, + * \c #Aligned16, \c #Aligned8 or \c #Unaligned. The default is \c #Unaligned. \tparam StrideType optionally specifies + * strides. By default, Ref implies a contiguous storage along the inner dimension (inner stride==1), but accepts a + * variable outer stride (leading dimension). This can be overridden by specifying strides. The type passed here must be + * a specialization of the Stride template, see examples below. + * + * This class provides a way to write non-template functions taking Eigen objects as parameters while limiting the + * number of copies. A Ref<> object can represent either a const expression or a l-value: \code + * // in-out argument: + * void foo1(Ref x); + * + * // read-only const argument: + * void foo2(const Ref& x); + * \endcode + * + * In the in-out case, the input argument must satisfy the constraints of the actual Ref<> type, otherwise a compilation + * issue will be triggered. By default, a Ref can reference any dense vector expression of float having a + * contiguous memory layout. Likewise, a Ref can reference any column-major dense matrix expression of float + * whose column's elements are contiguously stored with the possibility to have a constant space in-between each column, + * i.e. the inner stride must be equal to 1, but the outer stride (or leading dimension) can be greater than the number + * of rows. + * + * In the const case, if the input expression does not match the above requirement, then it is evaluated into a + * temporary before being passed to the function. Here are some examples: \code MatrixXf A; VectorXf a; foo1(a.head()); + * // OK foo1(A.col()); // OK foo1(A.row()); // Compilation error because here innerstride!=1 + * foo2(A.row()); // Compilation error because A.row() is a 1xN object while foo2 is expecting a Nx1 object + * foo2(A.row().transpose()); // The row is copied into a contiguous temporary + * foo2(2*a); // The expression is evaluated into a temporary + * foo2(A.col().segment(2,4)); // No temporary + * \endcode + * + * The range of inputs that can be referenced without temporary can be enlarged using the last two template parameters. + * Here is an example accepting an innerstride!=1: + * \code + * // in-out argument: + * void foo3(Ref > x); + * foo3(A.row()); // OK + * \endcode + * The downside here is that the function foo3 might be significantly slower than foo1 because it won't be able to + * exploit vectorization, and will involve more expensive address computations even if the input is contiguously stored + * in memory. To overcome this issue, one might propose to overload internally calling a template function, e.g.: \code + * // in the .h: + * void foo(const Ref& A); + * void foo(const Ref >& A); + * + * // in the .cpp: + * template void foo_impl(const TypeOfA& A) { + * ... // crazy code goes here + * } + * void foo(const Ref& A) { foo_impl(A); } + * void foo(const Ref >& A) { foo_impl(A); } + * \endcode + * + * See also the following stackoverflow questions for further references: + * - Correct usage of the + * Eigen::Ref<> class + * + * \sa PlainObjectBase::Map(), \ref TopicStorageOrders + */ +template +class Ref : public RefBase > { + private: + typedef internal::traits Traits; + template + EIGEN_DEVICE_FUNC inline Ref( + const PlainObjectBase& expr, + std::enable_if_t::MatchAtCompileTime), Derived>* = 0); + + public: + typedef RefBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Ref) + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + EIGEN_DEVICE_FUNC inline Ref( + PlainObjectBase& expr, + std::enable_if_t::MatchAtCompileTime), Derived>* = 0) { + EIGEN_STATIC_ASSERT(bool(Traits::template match::MatchAtCompileTime), STORAGE_LAYOUT_DOES_NOT_MATCH); + // Construction must pass since we will not create temporary storage in the non-const case. + const bool success = Base::construct(expr.derived()); + EIGEN_UNUSED_VARIABLE(success) + eigen_assert(success); + } + template + EIGEN_DEVICE_FUNC inline Ref( + const DenseBase& expr, + std::enable_if_t::MatchAtCompileTime), Derived>* = 0) +#else + /** Implicit constructor from any dense expression */ + template + inline Ref(DenseBase& expr) +#endif + { + EIGEN_STATIC_ASSERT(bool(internal::is_lvalue::value), THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + EIGEN_STATIC_ASSERT(bool(Traits::template match::MatchAtCompileTime), STORAGE_LAYOUT_DOES_NOT_MATCH); + EIGEN_STATIC_ASSERT(!Derived::IsPlainObjectBase, THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + // Construction must pass since we will not create temporary storage in the non-const case. + const bool success = Base::construct(expr.const_cast_derived()); + EIGEN_UNUSED_VARIABLE(success) + eigen_assert(success); + } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Ref) +}; + +// this is the const ref version +template +class Ref + : public RefBase > { + typedef internal::traits Traits; + + static constexpr bool may_map_m_object_successfully = + (static_cast(StrideType::InnerStrideAtCompileTime) == 0 || + static_cast(StrideType::InnerStrideAtCompileTime) == 1 || + static_cast(StrideType::InnerStrideAtCompileTime) == Dynamic) && + (TPlainObjectType::IsVectorAtCompileTime || static_cast(StrideType::OuterStrideAtCompileTime) == 0 || + static_cast(StrideType::OuterStrideAtCompileTime) == Dynamic || + static_cast(StrideType::OuterStrideAtCompileTime) == + static_cast(TPlainObjectType::InnerSizeAtCompileTime) || + static_cast(TPlainObjectType::InnerSizeAtCompileTime) == Dynamic); + + public: + typedef RefBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Ref) + + template + EIGEN_DEVICE_FUNC inline Ref(const DenseBase& expr, + std::enable_if_t::ScalarTypeMatch), Derived>* = 0) { + // std::cout << match_helper::HasDirectAccess << "," << match_helper::OuterStrideMatch << "," + // << match_helper::InnerStrideMatch << "\n"; std::cout << int(StrideType::OuterStrideAtCompileTime) + // << " - " << int(Derived::OuterStrideAtCompileTime) << "\n"; std::cout << + // int(StrideType::InnerStrideAtCompileTime) << " - " << int(Derived::InnerStrideAtCompileTime) << "\n"; + EIGEN_STATIC_ASSERT(Traits::template match::type::value || may_map_m_object_successfully, + STORAGE_LAYOUT_DOES_NOT_MATCH); + construct(expr.derived(), typename Traits::template match::type()); + } + + EIGEN_DEVICE_FUNC inline Ref(const Ref& other) : Base(other) { + // copy constructor shall not copy the m_object, to avoid unnecessary malloc and copy + } + + EIGEN_DEVICE_FUNC inline Ref(Ref&& other) { + if (other.data() == other.m_object.data()) { + m_object = std::move(other.m_object); + Base::construct(m_object); + } else + Base::construct(other); + } + + template + EIGEN_DEVICE_FUNC inline Ref(const RefBase& other) { + EIGEN_STATIC_ASSERT(Traits::template match::type::value || may_map_m_object_successfully, + STORAGE_LAYOUT_DOES_NOT_MATCH); + construct(other.derived(), typename Traits::template match::type()); + } + + protected: + template + EIGEN_DEVICE_FUNC void construct(const Expression& expr, internal::true_type) { + // Check if we can use the underlying expr's storage directly, otherwise call the copy version. + if (!Base::construct(expr)) { + construct(expr, internal::false_type()); + } + } + + template + EIGEN_DEVICE_FUNC void construct(const Expression& expr, internal::false_type) { + internal::call_assignment_no_alias(m_object, expr, internal::assign_op()); + const bool success = Base::construct(m_object); + EIGEN_ONLY_USED_FOR_DEBUG(success) + eigen_assert(success); + } + + protected: + TPlainObjectType m_object; +}; + +} // end namespace Eigen + +#endif // EIGEN_REF_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Replicate.h b/src/3rdparty/eigen/Eigen/src/Core/Replicate.h new file mode 100644 index 0000000..3415045 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Replicate.h @@ -0,0 +1,130 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REPLICATE_H +#define EIGEN_REPLICATE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > : traits { + typedef typename MatrixType::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type MatrixTypeNested; + typedef std::remove_reference_t MatrixTypeNested_; + enum { + RowsAtCompileTime = RowFactor == Dynamic || int(MatrixType::RowsAtCompileTime) == Dynamic + ? Dynamic + : RowFactor * MatrixType::RowsAtCompileTime, + ColsAtCompileTime = ColFactor == Dynamic || int(MatrixType::ColsAtCompileTime) == Dynamic + ? Dynamic + : ColFactor * MatrixType::ColsAtCompileTime, + // FIXME we don't propagate the max sizes !!! + MaxRowsAtCompileTime = RowsAtCompileTime, + MaxColsAtCompileTime = ColsAtCompileTime, + IsRowMajor = MaxRowsAtCompileTime == 1 && MaxColsAtCompileTime != 1 ? 1 + : MaxColsAtCompileTime == 1 && MaxRowsAtCompileTime != 1 ? 0 + : (MatrixType::Flags & RowMajorBit) ? 1 + : 0, + + // FIXME enable DirectAccess with negative strides? + Flags = IsRowMajor ? RowMajorBit : 0 + }; +}; +} // namespace internal + +/** + * \class Replicate + * \ingroup Core_Module + * + * \brief Expression of the multiple replication of a matrix or vector + * + * \tparam MatrixType the type of the object we are replicating + * \tparam RowFactor number of repetitions at compile time along the vertical direction, can be Dynamic. + * \tparam ColFactor number of repetitions at compile time along the horizontal direction, can be Dynamic. + * + * This class represents an expression of the multiple replication of a matrix or vector. + * It is the return type of DenseBase::replicate() and most of the time + * this is the only way it is used. + * + * \sa DenseBase::replicate() + */ +template +class Replicate : public internal::dense_xpr_base >::type { + typedef typename internal::traits::MatrixTypeNested MatrixTypeNested; + typedef typename internal::traits::MatrixTypeNested_ MatrixTypeNested_; + + public: + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Replicate) + typedef internal::remove_all_t NestedExpression; + + template + EIGEN_DEVICE_FUNC inline explicit Replicate(const OriginalMatrixType& matrix) + : m_matrix(matrix), m_rowFactor(RowFactor), m_colFactor(ColFactor) { + EIGEN_STATIC_ASSERT((internal::is_same, OriginalMatrixType>::value), + THE_MATRIX_OR_EXPRESSION_THAT_YOU_PASSED_DOES_NOT_HAVE_THE_EXPECTED_TYPE) + eigen_assert(RowFactor != Dynamic && ColFactor != Dynamic); + } + + template + EIGEN_DEVICE_FUNC inline Replicate(const OriginalMatrixType& matrix, Index rowFactor, Index colFactor) + : m_matrix(matrix), m_rowFactor(rowFactor), m_colFactor(colFactor) { + EIGEN_STATIC_ASSERT((internal::is_same, OriginalMatrixType>::value), + THE_MATRIX_OR_EXPRESSION_THAT_YOU_PASSED_DOES_NOT_HAVE_THE_EXPECTED_TYPE) + } + + EIGEN_DEVICE_FUNC constexpr Index rows() const { return m_matrix.rows() * m_rowFactor.value(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const { return m_matrix.cols() * m_colFactor.value(); } + + EIGEN_DEVICE_FUNC const MatrixTypeNested_& nestedExpression() const { return m_matrix; } + + protected: + MatrixTypeNested m_matrix; + const internal::variable_if_dynamic m_rowFactor; + const internal::variable_if_dynamic m_colFactor; +}; + +/** + * \return an expression of the replication of \c *this + * + * Example: \include MatrixBase_replicate.cpp + * Output: \verbinclude MatrixBase_replicate.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(Index,Index), class Replicate + */ +template +template +EIGEN_DEVICE_FUNC const Replicate DenseBase::replicate() const { + return Replicate(derived()); +} + +/** + * \return an expression of the replication of each column (or row) of \c *this + * + * Example: \include DirectionWise_replicate_int.cpp + * Output: \verbinclude DirectionWise_replicate_int.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(), class Replicate + */ +template +EIGEN_DEVICE_FUNC const typename VectorwiseOp::ReplicateReturnType +VectorwiseOp::replicate(Index factor) const { + return typename VectorwiseOp::ReplicateReturnType( + _expression(), Direction == Vertical ? factor : 1, Direction == Horizontal ? factor : 1); +} + +} // end namespace Eigen + +#endif // EIGEN_REPLICATE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Reshaped.h b/src/3rdparty/eigen/Eigen/src/Core/Reshaped.h new file mode 100644 index 0000000..22acdc0 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Reshaped.h @@ -0,0 +1,398 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2017 Gael Guennebaud +// Copyright (C) 2014 yoco +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RESHAPED_H +#define EIGEN_RESHAPED_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class Reshaped + * \ingroup Core_Module + * + * \brief Expression of a fixed-size or dynamic-size reshape + * + * \tparam XprType the type of the expression in which we are taking a reshape + * \tparam Rows the number of rows of the reshape we are taking at compile time (optional) + * \tparam Cols the number of columns of the reshape we are taking at compile time (optional) + * \tparam Order can be ColMajor or RowMajor, default is ColMajor. + * + * This class represents an expression of either a fixed-size or dynamic-size reshape. + * It is the return type of DenseBase::reshaped(NRowsType,NColsType) and + * most of the time this is the only way it is used. + * + * If you want to directly manipulate reshaped expressions, + * for instance if you want to write a function returning such an expression, + * it is advised to use the \em auto keyword for such use cases. + * + * Here is an example illustrating the dynamic case: + * \include class_Reshaped.cpp + * Output: \verbinclude class_Reshaped.out + * + * Here is an example illustrating the fixed-size case: + * \include class_FixedReshaped.cpp + * Output: \verbinclude class_FixedReshaped.out + * + * \sa DenseBase::reshaped(NRowsType,NColsType) + */ + +namespace internal { + +template +struct traits > : traits { + typedef typename traits::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + enum { + MatrixRows = traits::RowsAtCompileTime, + MatrixCols = traits::ColsAtCompileTime, + RowsAtCompileTime = Rows, + ColsAtCompileTime = Cols, + MaxRowsAtCompileTime = Rows, + MaxColsAtCompileTime = Cols, + XpxStorageOrder = ((int(traits::Flags) & RowMajorBit) == RowMajorBit) ? RowMajor : ColMajor, + ReshapedStorageOrder = (RowsAtCompileTime == 1 && ColsAtCompileTime != 1) ? RowMajor + : (ColsAtCompileTime == 1 && RowsAtCompileTime != 1) ? ColMajor + : XpxStorageOrder, + HasSameStorageOrderAsXprType = (ReshapedStorageOrder == XpxStorageOrder), + InnerSize = (ReshapedStorageOrder == int(RowMajor)) ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsXprType ? int(inner_stride_at_compile_time::ret) : Dynamic, + OuterStrideAtCompileTime = Dynamic, + + HasDirectAccess = internal::has_direct_access::ret && (Order == int(XpxStorageOrder)) && + ((evaluator::Flags & LinearAccessBit) == LinearAccessBit), + + MaskPacketAccessBit = + (InnerSize == Dynamic || (InnerSize % packet_traits::size) == 0) && (InnerStrideAtCompileTime == 1) + ? PacketAccessBit + : 0, + // MaskAlignedBit = ((OuterStrideAtCompileTime!=Dynamic) && (((OuterStrideAtCompileTime * int(sizeof(Scalar))) % 16) + // == 0)) ? AlignedBit : 0, + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1) ? LinearAccessBit : 0, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsRowMajorBit = (ReshapedStorageOrder == int(RowMajor)) ? RowMajorBit : 0, + FlagsDirectAccessBit = HasDirectAccess ? DirectAccessBit : 0, + Flags0 = traits::Flags & ((HereditaryBits & ~RowMajorBit) | MaskPacketAccessBit), + + Flags = (Flags0 | FlagsLinearAccessBit | FlagsLvalueBit | FlagsRowMajorBit | FlagsDirectAccessBit) + }; +}; + +template +class ReshapedImpl_dense; + +} // end namespace internal + +template +class ReshapedImpl; + +template +class Reshaped : public ReshapedImpl::StorageKind> { + typedef ReshapedImpl::StorageKind> Impl; + + public: + // typedef typename Impl::Base Base; + typedef Impl Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Reshaped) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Reshaped) + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC inline Reshaped(XprType& xpr) : Impl(xpr) { + EIGEN_STATIC_ASSERT(RowsAtCompileTime != Dynamic && ColsAtCompileTime != Dynamic, + THIS_METHOD_IS_ONLY_FOR_FIXED_SIZE) + eigen_assert(Rows * Cols == xpr.rows() * xpr.cols()); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC inline Reshaped(XprType& xpr, Index reshapeRows, Index reshapeCols) + : Impl(xpr, reshapeRows, reshapeCols) { + eigen_assert((RowsAtCompileTime == Dynamic || RowsAtCompileTime == reshapeRows) && + (ColsAtCompileTime == Dynamic || ColsAtCompileTime == reshapeCols)); + eigen_assert(reshapeRows * reshapeCols == xpr.rows() * xpr.cols()); + } +}; + +// The generic default implementation for dense reshape simply forward to the internal::ReshapedImpl_dense +// that must be specialized for direct and non-direct access... +template +class ReshapedImpl + : public internal::ReshapedImpl_dense >::HasDirectAccess> { + typedef internal::ReshapedImpl_dense >::HasDirectAccess> + Impl; + + public: + typedef Impl Base; + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl) + EIGEN_DEVICE_FUNC inline ReshapedImpl(XprType& xpr) : Impl(xpr) {} + EIGEN_DEVICE_FUNC inline ReshapedImpl(XprType& xpr, Index reshapeRows, Index reshapeCols) + : Impl(xpr, reshapeRows, reshapeCols) {} +}; + +namespace internal { + +/** \internal Internal implementation of dense Reshaped in the general case. */ +template +class ReshapedImpl_dense + : public internal::dense_xpr_base >::type { + typedef Reshaped ReshapedType; + + public: + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReshapedType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl_dense) + + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef internal::remove_all_t NestedExpression; + + class InnerIterator; + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC inline ReshapedImpl_dense(XprType& xpr) : m_xpr(xpr), m_rows(Rows), m_cols(Cols) {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC inline ReshapedImpl_dense(XprType& xpr, Index nRows, Index nCols) + : m_xpr(xpr), m_rows(nRows), m_cols(nCols) {} + + EIGEN_DEVICE_FUNC Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC Index cols() const { return m_cols; } + +#ifdef EIGEN_PARSED_BY_DOXYGEN + /** \sa MapBase::data() */ + EIGEN_DEVICE_FUNC constexpr const Scalar* data() const; + EIGEN_DEVICE_FUNC inline Index innerStride() const; + EIGEN_DEVICE_FUNC inline Index outerStride() const; +#endif + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC const internal::remove_all_t& nestedExpression() const { return m_xpr; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC std::remove_reference_t& nestedExpression() { return m_xpr; } + + protected: + MatrixTypeNested m_xpr; + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; +}; + +/** \internal Internal implementation of dense Reshaped in the direct access case. */ +template +class ReshapedImpl_dense : public MapBase > { + typedef Reshaped ReshapedType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + + public: + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReshapedType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl_dense) + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC inline ReshapedImpl_dense(XprType& xpr) : Base(xpr.data()), m_xpr(xpr) {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC inline ReshapedImpl_dense(XprType& xpr, Index nRows, Index nCols) + : Base(xpr.data(), nRows, nCols), m_xpr(xpr) {} + + EIGEN_DEVICE_FUNC const internal::remove_all_t& nestedExpression() const { return m_xpr; } + + EIGEN_DEVICE_FUNC XprType& nestedExpression() { return m_xpr; } + + /** \sa MapBase::innerStride() */ + EIGEN_DEVICE_FUNC constexpr Index innerStride() const { return m_xpr.innerStride(); } + + /** \sa MapBase::outerStride() */ + EIGEN_DEVICE_FUNC constexpr Index outerStride() const { + return (((Flags & RowMajorBit) == RowMajorBit) ? this->cols() : this->rows()) * m_xpr.innerStride(); + } + + protected: + XprTypeNested m_xpr; +}; + +// Evaluators +template +struct reshaped_evaluator; + +template +struct evaluator > + : reshaped_evaluator >::HasDirectAccess> { + typedef Reshaped XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types + typedef typename packet_traits::type PacketScalar; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + HasDirectAccess = traits::HasDirectAccess, + + // RowsAtCompileTime = traits::RowsAtCompileTime, + // ColsAtCompileTime = traits::ColsAtCompileTime, + // MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + // MaxColsAtCompileTime = traits::MaxColsAtCompileTime, + // + // InnerStrideAtCompileTime = traits::HasSameStorageOrderAsXprType + // ? int(inner_stride_at_compile_time::ret) + // : Dynamic, + // OuterStrideAtCompileTime = Dynamic, + + FlagsLinearAccessBit = + (traits::RowsAtCompileTime == 1 || traits::ColsAtCompileTime == 1 || HasDirectAccess) + ? LinearAccessBit + : 0, + FlagsRowMajorBit = (traits::ReshapedStorageOrder == int(RowMajor)) ? RowMajorBit : 0, + FlagsDirectAccessBit = HasDirectAccess ? DirectAccessBit : 0, + Flags0 = evaluator::Flags & (HereditaryBits & ~RowMajorBit), + Flags = Flags0 | FlagsLinearAccessBit | FlagsRowMajorBit | FlagsDirectAccessBit, + + PacketAlignment = unpacket_traits::alignment, + Alignment = evaluator::Alignment + }; + typedef reshaped_evaluator reshaped_evaluator_type; + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) : reshaped_evaluator_type(xpr) { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } +}; + +template +struct reshaped_evaluator + : evaluator_base > { + typedef Reshaped XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost /* TODO + cost of index computations */, + + Flags = (evaluator::Flags & (HereditaryBits /*| LinearAccessBit | DirectAccessBit*/)), + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC explicit reshaped_evaluator(const XprType& xpr) : m_argImpl(xpr.nestedExpression()), m_xpr(xpr) { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + typedef std::pair RowCol; + + EIGEN_DEVICE_FUNC inline RowCol index_remap(Index rowId, Index colId) const { + if (Order == ColMajor) { + const Index nth_elem_idx = colId * m_xpr.rows() + rowId; + return RowCol(nth_elem_idx % m_xpr.nestedExpression().rows(), nth_elem_idx / m_xpr.nestedExpression().rows()); + } else { + const Index nth_elem_idx = colId + rowId * m_xpr.cols(); + return RowCol(nth_elem_idx / m_xpr.nestedExpression().cols(), nth_elem_idx % m_xpr.nestedExpression().cols()); + } + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index rowId, Index colId) { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index rowId, Index colId) const { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index rowId, Index colId) const { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeff(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index index) { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, Rows == 1 ? index : 0); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC inline const Scalar& coeffRef(Index index) const { + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, Rows == 1 ? index : 0); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC inline const CoeffReturnType coeff(Index index) const { + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, Rows == 1 ? index : 0); + return m_argImpl.coeff(row_col.first, row_col.second); + } +#if 0 + EIGEN_DEVICE_FUNC + template + inline PacketScalar packet(Index rowId, Index colId) const + { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.template packet(row_col.first, row_col.second); + + } + + template + EIGEN_DEVICE_FUNC + inline void writePacket(Index rowId, Index colId, const PacketScalar& val) + { + const RowCol row_col = index_remap(rowId, colId); + m_argImpl.const_cast_derived().template writePacket + (row_col.first, row_col.second, val); + } + + template + EIGEN_DEVICE_FUNC + inline PacketScalar packet(Index index) const + { + const RowCol row_col = index_remap(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0); + return m_argImpl.template packet(row_col.first, row_col.second); + } + + template + EIGEN_DEVICE_FUNC + inline void writePacket(Index index, const PacketScalar& val) + { + const RowCol row_col = index_remap(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0); + return m_argImpl.template packet(row_col.first, row_col.second, val); + } +#endif + protected: + evaluator m_argImpl; + const XprType& m_xpr; +}; + +template +struct reshaped_evaluator + : mapbase_evaluator, + typename Reshaped::PlainObject> { + typedef Reshaped XprType; + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC explicit reshaped_evaluator(const XprType& xpr) + : mapbase_evaluator(xpr) { + // TODO: for the 3.4 release, this should be turned to an internal assertion, but let's keep it as is for the beta + // lifetime + eigen_assert(((std::uintptr_t(xpr.data()) % plain_enum_max(1, evaluator::Alignment)) == 0) && + "data is not aligned"); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_RESHAPED_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ReturnByValue.h b/src/3rdparty/eigen/Eigen/src/Core/ReturnByValue.h new file mode 100644 index 0000000..892c193 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ReturnByValue.h @@ -0,0 +1,111 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// Copyright (C) 2009-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RETURNBYVALUE_H +#define EIGEN_RETURNBYVALUE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct traits > : public traits::ReturnType> { + enum { + // We're disabling the DirectAccess because e.g. the constructor of + // the Block-with-DirectAccess expression requires to have a coeffRef method. + // Also, we don't want to have to implement the stride stuff. + Flags = (traits::ReturnType>::Flags | EvalBeforeNestingBit) & ~DirectAccessBit + }; +}; + +/* The ReturnByValue object doesn't even have a coeff() method. + * So the only way that nesting it in an expression can work, is by evaluating it into a plain matrix. + * So internal::nested always gives the plain return matrix type. + * + * FIXME: I don't understand why we need this specialization: isn't this taken care of by the EvalBeforeNestingBit ?? + * Answer: EvalBeforeNestingBit should be deprecated since we have the evaluators + */ +template +struct nested_eval, n, PlainObject> { + typedef typename traits::ReturnType type; +}; + +} // end namespace internal + +/** \class ReturnByValue + * \ingroup Core_Module + * + */ +template +class ReturnByValue : public internal::dense_xpr_base >::type, internal::no_assignment_operator { + public: + typedef typename internal::traits::ReturnType ReturnType; + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReturnByValue) + + template + EIGEN_DEVICE_FUNC inline void evalTo(Dest& dst) const { + static_cast(this)->evalTo(dst); + } + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return static_cast(this)->rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return static_cast(this)->cols(); } + +#ifndef EIGEN_PARSED_BY_DOXYGEN +#define Unusable \ + YOU_ARE_TRYING_TO_ACCESS_A_SINGLE_COEFFICIENT_IN_A_SPECIAL_EXPRESSION_WHERE_THAT_IS_NOT_ALLOWED_BECAUSE_THAT_WOULD_BE_INEFFICIENT + class Unusable { + Unusable(const Unusable&) {} + Unusable& operator=(const Unusable&) { return *this; } + }; + const Unusable& coeff(Index) const { return *reinterpret_cast(this); } + const Unusable& coeff(Index, Index) const { return *reinterpret_cast(this); } + Unusable& coeffRef(Index) { return *reinterpret_cast(this); } + Unusable& coeffRef(Index, Index) { return *reinterpret_cast(this); } +#undef Unusable +#endif +}; + +template +template +EIGEN_DEVICE_FUNC Derived& DenseBase::operator=(const ReturnByValue& other) { + other.evalTo(derived()); + return derived(); +} + +namespace internal { + +// Expression is evaluated in a temporary; default implementation of Assignment is bypassed so that +// when a ReturnByValue expression is assigned, the evaluator is not constructed. +// TODO: Finalize port to new regime; ReturnByValue should not exist in the expression world + +template +struct evaluator > : public evaluator::ReturnType> { + typedef ReturnByValue XprType; + typedef typename internal::traits::ReturnType PlainObject; + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) : m_result(xpr.rows(), xpr.cols()) { + internal::construct_at(this, m_result); + xpr.evalTo(m_result); + } + + protected: + PlainObject m_result; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_RETURNBYVALUE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Reverse.h b/src/3rdparty/eigen/Eigen/src/Core/Reverse.h new file mode 100644 index 0000000..d11ba16 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Reverse.h @@ -0,0 +1,202 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2009 Ricard Marxer +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REVERSE_H +#define EIGEN_REVERSE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct traits > : traits { + typedef typename MatrixType::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type MatrixTypeNested; + typedef std::remove_reference_t MatrixTypeNested_; + enum { + RowsAtCompileTime = MatrixType::RowsAtCompileTime, + ColsAtCompileTime = MatrixType::ColsAtCompileTime, + MaxRowsAtCompileTime = MatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime, + Flags = MatrixTypeNested_::Flags & (RowMajorBit | LvalueBit) + }; +}; + +template +struct reverse_packet_cond { + static inline PacketType run(const PacketType& x) { return preverse(x); } +}; + +template +struct reverse_packet_cond { + static inline PacketType run(const PacketType& x) { return x; } +}; + +} // end namespace internal + +/** \class Reverse + * \ingroup Core_Module + * + * \brief Expression of the reverse of a vector or matrix + * + * \tparam MatrixType the type of the object of which we are taking the reverse + * \tparam Direction defines the direction of the reverse operation, can be Vertical, Horizontal, or BothDirections + * + * This class represents an expression of the reverse of a vector. + * It is the return type of MatrixBase::reverse() and VectorwiseOp::reverse() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::reverse(), VectorwiseOp::reverse() + */ +template +class Reverse : public internal::dense_xpr_base >::type { + public: + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Reverse) + typedef internal::remove_all_t NestedExpression; + using Base::IsRowMajor; + + protected: + enum { + PacketSize = internal::packet_traits::size, + IsColMajor = !IsRowMajor, + ReverseRow = (Direction == Vertical) || (Direction == BothDirections), + ReverseCol = (Direction == Horizontal) || (Direction == BothDirections), + OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1, + OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1, + ReversePacket = (Direction == BothDirections) || ((Direction == Vertical) && IsColMajor) || + ((Direction == Horizontal) && IsRowMajor) + }; + typedef internal::reverse_packet_cond reverse_packet; + + public: + EIGEN_DEVICE_FUNC explicit inline Reverse(const MatrixType& matrix) : m_matrix(matrix) {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Reverse) + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_matrix.cols(); } + + EIGEN_DEVICE_FUNC inline Index innerStride() const { return -m_matrix.innerStride(); } + + EIGEN_DEVICE_FUNC const internal::remove_all_t& nestedExpression() const { + return m_matrix; + } + + protected: + typename MatrixType::Nested m_matrix; +}; + +/** \returns an expression of the reverse of *this. + * + * Example: \include MatrixBase_reverse.cpp + * Output: \verbinclude MatrixBase_reverse.out + * + */ +template +EIGEN_DEVICE_FUNC inline typename DenseBase::ReverseReturnType DenseBase::reverse() { + return ReverseReturnType(derived()); +} + +// reverse const overload moved DenseBase.h due to a CUDA compiler bug + +/** This is the "in place" version of reverse: it reverses \c *this. + * + * In most cases it is probably better to simply use the reversed expression + * of a matrix. However, when reversing the matrix data itself is really needed, + * then this "in-place" version is probably the right choice because it provides + * the following additional benefits: + * - less error prone: doing the same operation with .reverse() requires special care: + * \code m = m.reverse().eval(); \endcode + * - this API enables reverse operations without the need for a temporary + * - it allows future optimizations (cache friendliness, etc.) + * + * \sa VectorwiseOp::reverseInPlace(), reverse() */ +template +EIGEN_DEVICE_FUNC inline void DenseBase::reverseInPlace() { + constexpr int HalfRowsAtCompileTime = RowsAtCompileTime == Dynamic ? Dynamic : RowsAtCompileTime / 2; + constexpr int HalfColsAtCompileTime = ColsAtCompileTime == Dynamic ? Dynamic : ColsAtCompileTime / 2; + if (cols() > rows()) { + Index half = cols() / 2; + this->template leftCols(half).swap( + this->template rightCols(half).reverse()); + if ((cols() % 2) == 1) { + Index half2 = rows() / 2; + col(half).template head(half2).swap( + col(half).template tail(half2).reverse()); + } + } else { + Index half = rows() / 2; + this->template topRows(half).swap( + this->template bottomRows(half).reverse()); + if ((rows() % 2) == 1) { + Index half2 = cols() / 2; + row(half).template head(half2).swap( + row(half).template tail(half2).reverse()); + } + } +} + +namespace internal { + +template +struct vectorwise_reverse_inplace_impl; + +template <> +struct vectorwise_reverse_inplace_impl { + template + static void run(ExpressionType& xpr) { + constexpr Index HalfAtCompileTime = + ExpressionType::RowsAtCompileTime == Dynamic ? Dynamic : ExpressionType::RowsAtCompileTime / 2; + Index half = xpr.rows() / 2; + xpr.template topRows(half).swap( + xpr.template bottomRows(half).colwise().reverse()); + } +}; + +template <> +struct vectorwise_reverse_inplace_impl { + template + static void run(ExpressionType& xpr) { + constexpr Index HalfAtCompileTime = + ExpressionType::ColsAtCompileTime == Dynamic ? Dynamic : ExpressionType::ColsAtCompileTime / 2; + Index half = xpr.cols() / 2; + xpr.template leftCols(half).swap( + xpr.template rightCols(half).rowwise().reverse()); + } +}; + +} // end namespace internal + +/** This is the "in place" version of VectorwiseOp::reverse: it reverses each column or row of \c *this. + * + * In most cases it is probably better to simply use the reversed expression + * of a matrix. However, when reversing the matrix data itself is really needed, + * then this "in-place" version is probably the right choice because it provides + * the following additional benefits: + * - less error prone: doing the same operation with .reverse() requires special care: + * \code m = m.reverse().eval(); \endcode + * - this API enables reverse operations without the need for a temporary + * + * \sa DenseBase::reverseInPlace(), reverse() */ +template +EIGEN_DEVICE_FUNC void VectorwiseOp::reverseInPlace() { + internal::vectorwise_reverse_inplace_impl::run(m_matrix); +} + +} // end namespace Eigen + +#endif // EIGEN_REVERSE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Select.h b/src/3rdparty/eigen/Eigen/src/Core/Select.h new file mode 100644 index 0000000..61a67c2 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Select.h @@ -0,0 +1,92 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SELECT_H +#define EIGEN_SELECT_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \typedef Select + * \ingroup Core_Module + * + * \brief Expression of a coefficient wise version of the C++ ternary operator ?: + * + * \tparam ConditionMatrixType the type of the \em condition expression which must be a boolean matrix + * \tparam ThenMatrixType the type of the \em then expression + * \tparam ElseMatrixType the type of the \em else expression + * + * This type represents an expression of a coefficient wise version of the C++ ternary operator ?:. + * It is the return type of DenseBase::select() and most of the time this is the only way it is used. + * + * \sa DenseBase::select(const DenseBase&, const DenseBase&) const + */ +template +using Select = CwiseTernaryOp::Scalar, + typename DenseBase::Scalar, + typename DenseBase::Scalar>, + ThenMatrixType, ElseMatrixType, ConditionMatrixType>; + +/** \returns a matrix where each coefficient (i,j) is equal to \a thenMatrix(i,j) + * if \c *this(i,j) != Scalar(0), and \a elseMatrix(i,j) otherwise. + * + * Example: \include MatrixBase_select.cpp + * Output: \verbinclude MatrixBase_select.out + * + * \sa typedef Select + */ +template +template +inline EIGEN_DEVICE_FUNC CwiseTernaryOp< + internal::scalar_boolean_select_op::Scalar, typename DenseBase::Scalar, + typename DenseBase::Scalar>, + ThenDerived, ElseDerived, Derived> +DenseBase::select(const DenseBase& thenMatrix, const DenseBase& elseMatrix) const { + return Select(thenMatrix.derived(), elseMatrix.derived(), derived()); +} +/** Version of DenseBase::select(const DenseBase&, const DenseBase&) with + * the \em else expression being a scalar value. + * + * \sa typedef Select + */ +template +template +inline EIGEN_DEVICE_FUNC CwiseTernaryOp< + internal::scalar_boolean_select_op::Scalar, typename DenseBase::Scalar, + typename DenseBase::Scalar>, + ThenDerived, typename DenseBase::ConstantReturnType, Derived> +DenseBase::select(const DenseBase& thenMatrix, + const typename DenseBase::Scalar& elseScalar) const { + using ElseConstantType = typename DenseBase::ConstantReturnType; + return Select(thenMatrix.derived(), + ElseConstantType(rows(), cols(), elseScalar), derived()); +} +/** Version of DenseBase::select(const DenseBase&, const DenseBase&) with + * the \em then expression being a scalar value. + * + * \sa typedef Select + */ +template +template +inline EIGEN_DEVICE_FUNC CwiseTernaryOp< + internal::scalar_boolean_select_op::Scalar, typename DenseBase::Scalar, + typename DenseBase::Scalar>, + typename DenseBase::ConstantReturnType, ElseDerived, Derived> +DenseBase::select(const typename DenseBase::Scalar& thenScalar, + const DenseBase& elseMatrix) const { + using ThenConstantType = typename DenseBase::ConstantReturnType; + return Select(ThenConstantType(rows(), cols(), thenScalar), + elseMatrix.derived(), derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_SELECT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/SelfAdjointView.h b/src/3rdparty/eigen/Eigen/src/Core/SelfAdjointView.h new file mode 100644 index 0000000..16f0e75 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/SelfAdjointView.h @@ -0,0 +1,329 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SELFADJOINTMATRIX_H +#define EIGEN_SELFADJOINTMATRIX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class SelfAdjointView + * \ingroup Core_Module + * + * + * \brief Expression of a selfadjoint matrix from a triangular part of a dense matrix + * + * \tparam MatrixType the type of the dense matrix storing the coefficients + * \tparam TriangularPart can be either \c #Lower or \c #Upper + * + * This class is an expression of a sefladjoint matrix from a triangular part of a matrix + * with given dense storage of the coefficients. It is the return type of MatrixBase::selfadjointView() + * and most of the time this is the only way that it is used. + * + * \sa class TriangularBase, MatrixBase::selfadjointView() + */ + +namespace internal { +template +struct traits > : traits { + typedef typename ref_selector::non_const_type MatrixTypeNested; + typedef remove_all_t MatrixTypeNestedCleaned; + typedef MatrixType ExpressionType; + typedef typename MatrixType::PlainObject FullMatrixType; + enum { + Mode = UpLo | SelfAdjoint, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags = MatrixTypeNestedCleaned::Flags & (HereditaryBits | FlagsLvalueBit) & + (~(PacketAccessBit | DirectAccessBit | LinearAccessBit)) // FIXME these flags should be preserved + }; +}; +} // namespace internal + +template +class SelfAdjointView : public TriangularBase > { + public: + EIGEN_STATIC_ASSERT(UpLo == Lower || UpLo == Upper, SELFADJOINTVIEW_ACCEPTS_UPPER_AND_LOWER_MODE_ONLY) + + typedef MatrixType_ MatrixType; + typedef TriangularBase Base; + typedef typename internal::traits::MatrixTypeNested MatrixTypeNested; + typedef typename internal::traits::MatrixTypeNestedCleaned MatrixTypeNestedCleaned; + typedef MatrixTypeNestedCleaned NestedExpression; + + /** \brief The type of coefficients in this matrix */ + typedef typename internal::traits::Scalar Scalar; + typedef typename MatrixType::StorageIndex StorageIndex; + typedef internal::remove_all_t MatrixConjugateReturnType; + typedef SelfAdjointView, UpLo> ConstSelfAdjointView; + + enum { + Mode = internal::traits::Mode, + Flags = internal::traits::Flags, + TransposeMode = ((int(Mode) & int(Upper)) ? Lower : 0) | ((int(Mode) & int(Lower)) ? Upper : 0) + }; + typedef typename MatrixType::PlainObject PlainObject; + + EIGEN_DEVICE_FUNC explicit inline SelfAdjointView(MatrixType& matrix) : m_matrix(matrix) {} + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_matrix.cols(); } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return m_matrix.outerStride(); } + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return m_matrix.innerStride(); } + + /** \sa MatrixBase::coeff() + * \warning the coordinates must fit into the referenced triangular part + */ + EIGEN_DEVICE_FUNC inline Scalar coeff(Index row, Index col) const { + Base::check_coordinates_internal(row, col); + return m_matrix.coeff(row, col); + } + + /** \sa MatrixBase::coeffRef() + * \warning the coordinates must fit into the referenced triangular part + */ + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index row, Index col) { + EIGEN_STATIC_ASSERT_LVALUE(SelfAdjointView); + Base::check_coordinates_internal(row, col); + return m_matrix.coeffRef(row, col); + } + + /** \internal */ + EIGEN_DEVICE_FUNC const MatrixTypeNestedCleaned& _expression() const { return m_matrix; } + + EIGEN_DEVICE_FUNC const MatrixTypeNestedCleaned& nestedExpression() const { return m_matrix; } + EIGEN_DEVICE_FUNC MatrixTypeNestedCleaned& nestedExpression() { return m_matrix; } + + /** Efficient triangular matrix times vector/matrix product */ + template + EIGEN_DEVICE_FUNC const Product operator*(const MatrixBase& rhs) const { + return Product(*this, rhs.derived()); + } + + /** Efficient vector/matrix times triangular matrix product */ + template + friend EIGEN_DEVICE_FUNC const Product operator*(const MatrixBase& lhs, + const SelfAdjointView& rhs) { + return Product(lhs.derived(), rhs); + } + + friend EIGEN_DEVICE_FUNC const + SelfAdjointView + operator*(const Scalar& s, const SelfAdjointView& mat) { + return (s * mat.nestedExpression()).template selfadjointView(); + } + + /** Perform a symmetric rank 2 update of the selfadjoint matrix \c *this: + * \f$ this = this + \alpha u v^* + conj(\alpha) v u^* \f$ + * \returns a reference to \c *this + * + * The vectors \a u and \c v \b must be column vectors, however they can be + * a adjoint expression without any overhead. Only the meaningful triangular + * part of the matrix is updated, the rest is left unchanged. + * + * \sa rankUpdate(const MatrixBase&, Scalar) + */ + template + EIGEN_DEVICE_FUNC SelfAdjointView& rankUpdate(const MatrixBase& u, const MatrixBase& v, + const Scalar& alpha = Scalar(1)); + + /** Perform a symmetric rank K update of the selfadjoint matrix \c *this: + * \f$ this = this + \alpha ( u u^* ) \f$ where \a u is a vector or matrix. + * + * \returns a reference to \c *this + * + * Note that to perform \f$ this = this + \alpha ( u^* u ) \f$ you can simply + * call this function with u.adjoint(). + * + * \sa rankUpdate(const MatrixBase&, const MatrixBase&, Scalar) + */ + template + EIGEN_DEVICE_FUNC SelfAdjointView& rankUpdate(const MatrixBase& u, const Scalar& alpha = Scalar(1)); + + /** \returns an expression of a triangular view extracted from the current selfadjoint view of a given triangular part + * + * The parameter \a TriMode can have the following values: \c #Upper, \c #StrictlyUpper, \c #UnitUpper, + * \c #Lower, \c #StrictlyLower, \c #UnitLower. + * + * If \c TriMode references the same triangular part than \c *this, then this method simply return a \c TriangularView + * of the nested expression, otherwise, the nested expression is first transposed, thus returning a \c + * TriangularView> object. + * + * \sa MatrixBase::triangularView(), class TriangularView + */ + template + EIGEN_DEVICE_FUNC + std::conditional_t<(TriMode & (Upper | Lower)) == (UpLo & (Upper | Lower)), TriangularView, + TriangularView > + triangularView() const { + std::conditional_t<(TriMode & (Upper | Lower)) == (UpLo & (Upper | Lower)), MatrixType&, + typename MatrixType::ConstTransposeReturnType> + tmp1(m_matrix); + std::conditional_t<(TriMode & (Upper | Lower)) == (UpLo & (Upper | Lower)), MatrixType&, + typename MatrixType::AdjointReturnType> + tmp2(tmp1); + return std::conditional_t<(TriMode & (Upper | Lower)) == (UpLo & (Upper | Lower)), + TriangularView, + TriangularView >(tmp2); + } + + typedef SelfAdjointView ConjugateReturnType; + /** \sa MatrixBase::conjugate() const */ + EIGEN_DEVICE_FUNC inline const ConjugateReturnType conjugate() const { + return ConjugateReturnType(m_matrix.conjugate()); + } + + /** \returns an expression of the complex conjugate of \c *this if Cond==true, + * returns \c *this otherwise. + */ + template + EIGEN_DEVICE_FUNC inline std::conditional_t conjugateIf() const { + typedef std::conditional_t ReturnType; + return ReturnType(m_matrix.template conjugateIf()); + } + + typedef SelfAdjointView AdjointReturnType; + /** \sa MatrixBase::adjoint() const */ + EIGEN_DEVICE_FUNC inline const AdjointReturnType adjoint() const { return AdjointReturnType(m_matrix.adjoint()); } + + typedef SelfAdjointView TransposeReturnType; + /** \sa MatrixBase::transpose() */ + template + EIGEN_DEVICE_FUNC inline TransposeReturnType transpose( + std::enable_if_t::value, Dummy*> = nullptr) { + typename MatrixType::TransposeReturnType tmp(m_matrix); + return TransposeReturnType(tmp); + } + + typedef SelfAdjointView ConstTransposeReturnType; + /** \sa MatrixBase::transpose() const */ + EIGEN_DEVICE_FUNC inline const ConstTransposeReturnType transpose() const { + return ConstTransposeReturnType(m_matrix.transpose()); + } + + /** \returns a const expression of the main diagonal of the matrix \c *this + * + * This method simply returns the diagonal of the nested expression, thus by-passing the SelfAdjointView decorator. + * + * \sa MatrixBase::diagonal(), class Diagonal */ + EIGEN_DEVICE_FUNC typename MatrixType::ConstDiagonalReturnType diagonal() const { + return typename MatrixType::ConstDiagonalReturnType(m_matrix); + } + + /////////// Cholesky module /////////// + + const LLT llt() const; + const LDLT ldlt() const; + + /////////// Eigenvalue module /////////// + + /** Real part of #Scalar */ + typedef typename NumTraits::Real RealScalar; + /** Return type of eigenvalues() */ + typedef Matrix::ColsAtCompileTime, 1> EigenvaluesReturnType; + + EIGEN_DEVICE_FUNC EigenvaluesReturnType eigenvalues() const; + EIGEN_DEVICE_FUNC RealScalar operatorNorm() const; + + protected: + MatrixTypeNested m_matrix; +}; + +// template +// internal::selfadjoint_matrix_product_returntype > +// operator*(const MatrixBase& lhs, const SelfAdjointView& rhs) +// { +// return internal::matrix_selfadjoint_product_returntype +// >(lhs.derived(),rhs); +// } + +// selfadjoint to dense matrix + +namespace internal { + +// TODO currently a selfadjoint expression has the form SelfAdjointView<.,.> +// in the future selfadjoint-ness should be defined by the expression traits +// such that Transpose > is valid. (currently TriangularBase::transpose() is overloaded to +// make it work) +template +struct evaluator_traits > { + typedef typename storage_kind_to_evaluator_kind::Kind Kind; + typedef SelfAdjointShape Shape; +}; + +template +class triangular_dense_assignment_kernel + : public generic_dense_assignment_kernel { + protected: + typedef generic_dense_assignment_kernel Base; + typedef typename Base::DstXprType DstXprType; + typedef typename Base::SrcXprType SrcXprType; + using Base::m_dst; + using Base::m_functor; + using Base::m_src; + + public: + typedef typename Base::DstEvaluatorType DstEvaluatorType; + typedef typename Base::SrcEvaluatorType SrcEvaluatorType; + typedef typename Base::Scalar Scalar; + typedef typename Base::AssignmentTraits AssignmentTraits; + + EIGEN_DEVICE_FUNC triangular_dense_assignment_kernel(DstEvaluatorType& dst, const SrcEvaluatorType& src, + const Functor& func, DstXprType& dstExpr) + : Base(dst, src, func, dstExpr) {} + + EIGEN_DEVICE_FUNC void assignCoeff(Index row, Index col) { + eigen_internal_assert(row != col); + Scalar tmp = m_src.coeff(row, col); + m_functor.assignCoeff(m_dst.coeffRef(row, col), tmp); + m_functor.assignCoeff(m_dst.coeffRef(col, row), numext::conj(tmp)); + } + + EIGEN_DEVICE_FUNC void assignDiagonalCoeff(Index id) { Base::assignCoeff(id, id); } + + EIGEN_DEVICE_FUNC void assignOppositeCoeff(Index, Index) { eigen_internal_assert(false && "should never be called"); } +}; + +} // end namespace internal + +/*************************************************************************** + * Implementation of MatrixBase methods + ***************************************************************************/ + +/** This is the const version of MatrixBase::selfadjointView() */ +template +template +EIGEN_DEVICE_FUNC typename MatrixBase::template ConstSelfAdjointViewReturnType::Type +MatrixBase::selfadjointView() const { + return typename ConstSelfAdjointViewReturnType::Type(derived()); +} + +/** \returns an expression of a symmetric/self-adjoint view extracted from the upper or lower triangular part of the + * current matrix + * + * The parameter \a UpLo can be either \c #Upper or \c #Lower + * + * Example: \include MatrixBase_selfadjointView.cpp + * Output: \verbinclude MatrixBase_selfadjointView.out + * + * \sa class SelfAdjointView + */ +template +template +EIGEN_DEVICE_FUNC typename MatrixBase::template SelfAdjointViewReturnType::Type +MatrixBase::selfadjointView() { + return typename SelfAdjointViewReturnType::Type(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_SELFADJOINTMATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/SelfCwiseBinaryOp.h b/src/3rdparty/eigen/Eigen/src/Core/SelfCwiseBinaryOp.h new file mode 100644 index 0000000..1bc0373 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/SelfCwiseBinaryOp.h @@ -0,0 +1,50 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SELFCWISEBINARYOP_H +#define EIGEN_SELFCWISEBINARYOP_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::operator*=(const Scalar& other) { + using ConstantExpr = typename internal::plain_constant_type::type; + using Op = internal::mul_assign_op; + internal::call_assignment(derived(), ConstantExpr(rows(), cols(), other), Op()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::operator*=(const RealScalar& other) { + realView() *= other; + return derived(); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::operator/=(const Scalar& other) { + using ConstantExpr = typename internal::plain_constant_type::type; + using Op = internal::div_assign_op; + internal::call_assignment(derived(), ConstantExpr(rows(), cols(), other), Op()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::operator/=(const RealScalar& other) { + realView() /= other; + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_SELFCWISEBINARYOP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/SkewSymmetricMatrix3.h b/src/3rdparty/eigen/Eigen/src/Core/SkewSymmetricMatrix3.h new file mode 100644 index 0000000..3545afc --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/SkewSymmetricMatrix3.h @@ -0,0 +1,382 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// Copyright (C) 2007-2009 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SKEWSYMMETRICMATRIX3_H +#define EIGEN_SKEWSYMMETRICMATRIX3_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class SkewSymmetricBase + * \ingroup Core_Module + * + * \brief Base class for skew symmetric matrices and expressions + * + * This is the base class that is inherited by SkewSymmetricMatrix3 and related expression + * types, which internally use a three vector for storing the entries. SkewSymmetric + * types always represent square three times three matrices. + * + * This implementations follows class DiagonalMatrix + * + * \tparam Derived is the derived type, a SkewSymmetricMatrix3 or SkewSymmetricWrapper. + * + * \sa class SkewSymmetricMatrix3, class SkewSymmetricWrapper + */ +template +class SkewSymmetricBase : public EigenBase { + public: + typedef typename internal::traits::SkewSymmetricVectorType SkewSymmetricVectorType; + typedef typename SkewSymmetricVectorType::Scalar Scalar; + typedef typename SkewSymmetricVectorType::RealScalar RealScalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + + enum { + RowsAtCompileTime = SkewSymmetricVectorType::SizeAtCompileTime, + ColsAtCompileTime = SkewSymmetricVectorType::SizeAtCompileTime, + MaxRowsAtCompileTime = SkewSymmetricVectorType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = SkewSymmetricVectorType::MaxSizeAtCompileTime, + IsVectorAtCompileTime = 0, + Flags = NoPreferredStorageOrderBit + }; + + typedef Matrix + DenseMatrixType; + typedef DenseMatrixType DenseType; + typedef SkewSymmetricMatrix3 PlainObject; + + /** \returns a reference to the derived object. */ + EIGEN_DEVICE_FUNC inline const Derived& derived() const { return *static_cast(this); } + /** \returns a const reference to the derived object. */ + EIGEN_DEVICE_FUNC inline Derived& derived() { return *static_cast(this); } + + /** + * Constructs a dense matrix from \c *this. Note, this directly returns a dense matrix type, + * not an expression. + * \returns A dense matrix, with its entries set from the the derived object. */ + EIGEN_DEVICE_FUNC DenseMatrixType toDenseMatrix() const { return derived(); } + + /** Determinant vanishes */ + EIGEN_DEVICE_FUNC constexpr Scalar determinant() const { return 0; } + + /** A.transpose() = -A */ + EIGEN_DEVICE_FUNC PlainObject transpose() const { return (-vector()).asSkewSymmetric(); } + + /** \returns the exponential of this matrix using Rodrigues’ formula */ + EIGEN_DEVICE_FUNC DenseMatrixType exponential() const { + DenseMatrixType retVal = DenseMatrixType::Identity(); + const SkewSymmetricVectorType& v = vector(); + if (v.isZero()) { + return retVal; + } + const Scalar norm2 = v.squaredNorm(); + const Scalar norm = numext::sqrt(norm2); + retVal += ((((1 - numext::cos(norm)) / norm2) * derived()) * derived()) + + (numext::sin(norm) / norm) * derived().toDenseMatrix(); + return retVal; + } + + /** \returns a reference to the derived object's vector of coefficients. */ + EIGEN_DEVICE_FUNC inline const SkewSymmetricVectorType& vector() const { return derived().vector(); } + /** \returns a const reference to the derived object's vector of coefficients. */ + EIGEN_DEVICE_FUNC inline SkewSymmetricVectorType& vector() { return derived().vector(); } + + /** \returns the number of rows. */ + EIGEN_DEVICE_FUNC constexpr Index rows() const { return 3; } + /** \returns the number of columns. */ + EIGEN_DEVICE_FUNC constexpr Index cols() const { return 3; } + + /** \returns the matrix product of \c *this by the dense matrix, \a matrix */ + template + EIGEN_DEVICE_FUNC Product operator*( + const MatrixBase& matrix) const { + return Product(derived(), matrix.derived()); + } + + /** \returns the matrix product of \c *this by the skew symmetric matrix, \a matrix */ + template + EIGEN_DEVICE_FUNC Product operator*( + const SkewSymmetricBase& matrix) const { + return Product(derived(), matrix.derived()); + } + + template + using SkewSymmetricProductReturnType = SkewSymmetricWrapper; + + /** \returns the wedge product of \c *this by the skew symmetric matrix \a other + * A wedge B = AB - BA */ + template + EIGEN_DEVICE_FUNC SkewSymmetricProductReturnType wedge( + const SkewSymmetricBase& other) const { + return vector().cross(other.vector()).asSkewSymmetric(); + } + + using SkewSymmetricScaleReturnType = + SkewSymmetricWrapper; + + /** \returns the product of \c *this by the scalar \a scalar */ + EIGEN_DEVICE_FUNC inline SkewSymmetricScaleReturnType operator*(const Scalar& scalar) const { + return (vector() * scalar).asSkewSymmetric(); + } + + using ScaleSkewSymmetricReturnType = + SkewSymmetricWrapper; + + /** \returns the product of a scalar and the skew symmetric matrix \a other */ + EIGEN_DEVICE_FUNC friend inline ScaleSkewSymmetricReturnType operator*(const Scalar& scalar, + const SkewSymmetricBase& other) { + return (scalar * other.vector()).asSkewSymmetric(); + } + + template + using SkewSymmetricSumReturnType = SkewSymmetricWrapper; + + /** \returns the sum of \c *this and the skew symmetric matrix \a other */ + template + EIGEN_DEVICE_FUNC inline SkewSymmetricSumReturnType operator+( + const SkewSymmetricBase& other) const { + return (vector() + other.vector()).asSkewSymmetric(); + } + + template + using SkewSymmetricDifferenceReturnType = SkewSymmetricWrapper; + + /** \returns the difference of \c *this and the skew symmetric matrix \a other */ + template + EIGEN_DEVICE_FUNC inline SkewSymmetricDifferenceReturnType operator-( + const SkewSymmetricBase& other) const { + return (vector() - other.vector()).asSkewSymmetric(); + } +}; + +/** \class SkewSymmetricMatrix3 + * \ingroup Core_Module + * + * \brief Represents a 3x3 skew symmetric matrix with its storage + * + * \tparam Scalar_ the type of coefficients + * + * \sa class SkewSymmetricBase, class SkewSymmetricWrapper + */ + +namespace internal { +template +struct traits> : traits> { + typedef Matrix SkewSymmetricVectorType; + typedef SkewSymmetricShape StorageKind; + enum { Flags = LvalueBit | NoPreferredStorageOrderBit | NestByRefBit }; +}; +} // namespace internal +template +class SkewSymmetricMatrix3 : public SkewSymmetricBase> { + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename internal::traits::SkewSymmetricVectorType SkewSymmetricVectorType; + typedef const SkewSymmetricMatrix3& Nested; + typedef Scalar_ Scalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; +#endif + + protected: + SkewSymmetricVectorType m_vector; + + public: + /** const version of vector(). */ + EIGEN_DEVICE_FUNC inline const SkewSymmetricVectorType& vector() const { return m_vector; } + /** \returns a reference to the stored vector of coefficients. */ + EIGEN_DEVICE_FUNC inline SkewSymmetricVectorType& vector() { return m_vector; } + + /** Default constructor without initialization */ + EIGEN_DEVICE_FUNC inline SkewSymmetricMatrix3() {} + + /** Constructor from three scalars */ + EIGEN_DEVICE_FUNC inline SkewSymmetricMatrix3(const Scalar& x, const Scalar& y, const Scalar& z) + : m_vector(x, y, z) {} + + /** \brief Constructs a SkewSymmetricMatrix3 from an r-value vector type */ + EIGEN_DEVICE_FUNC explicit inline SkewSymmetricMatrix3(SkewSymmetricVectorType&& vec) : m_vector(std::move(vec)) {} + + /** generic constructor from expression of the coefficients */ + template + EIGEN_DEVICE_FUNC explicit inline SkewSymmetricMatrix3(const MatrixBase& other) : m_vector(other) {} + + /** Copy constructor. */ + template + EIGEN_DEVICE_FUNC inline SkewSymmetricMatrix3(const SkewSymmetricBase& other) + : m_vector(other.vector()) {} + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** copy constructor. prevent a default copy constructor from hiding the other templated constructor */ + inline SkewSymmetricMatrix3(const SkewSymmetricMatrix3& other) : m_vector(other.vector()) {} +#endif + + /** Copy operator. */ + template + EIGEN_DEVICE_FUNC SkewSymmetricMatrix3& operator=(const SkewSymmetricBase& other) { + m_vector = other.vector(); + return *this; + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC SkewSymmetricMatrix3& operator=(const SkewSymmetricMatrix3& other) { + m_vector = other.vector(); + return *this; + } +#endif + + typedef SkewSymmetricWrapper, SkewSymmetricVectorType>> + InitializeReturnType; + + /** Initializes a skew symmetric matrix with coefficients set to zero */ + EIGEN_DEVICE_FUNC static InitializeReturnType Zero() { return SkewSymmetricVectorType::Zero().asSkewSymmetric(); } + + /** Sets all coefficients to zero. */ + EIGEN_DEVICE_FUNC inline void setZero() { m_vector.setZero(); } +}; + +/** \class SkewSymmetricWrapper + * \ingroup Core_Module + * + * \brief Expression of a skew symmetric matrix + * + * \tparam SkewSymmetricVectorType_ the type of the vector of coefficients + * + * This class is an expression of a skew symmetric matrix, but not storing its own vector of coefficients, + * instead wrapping an existing vector expression. It is the return type of MatrixBase::asSkewSymmetric() + * and most of the time this is the only way that it is used. + * + * \sa class SkewSymmetricMatrix3, class SkewSymmetricBase, MatrixBase::asSkewSymmetric() + */ + +namespace internal { +template +struct traits> { + typedef SkewSymmetricVectorType_ SkewSymmetricVectorType; + typedef typename SkewSymmetricVectorType::Scalar Scalar; + typedef typename SkewSymmetricVectorType::StorageIndex StorageIndex; + typedef SkewSymmetricShape StorageKind; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = SkewSymmetricVectorType::SizeAtCompileTime, + ColsAtCompileTime = SkewSymmetricVectorType::SizeAtCompileTime, + MaxRowsAtCompileTime = SkewSymmetricVectorType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = SkewSymmetricVectorType::MaxSizeAtCompileTime, + Flags = (traits::Flags & LvalueBit) | NoPreferredStorageOrderBit + }; +}; +} // namespace internal + +template +class SkewSymmetricWrapper : public SkewSymmetricBase>, + internal::no_assignment_operator { + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef SkewSymmetricVectorType_ SkewSymmetricVectorType; + typedef SkewSymmetricWrapper Nested; +#endif + + /** Constructor from expression of coefficients to wrap. */ + EIGEN_DEVICE_FUNC explicit inline SkewSymmetricWrapper(SkewSymmetricVectorType& a_vector) : m_vector(a_vector) {} + + /** \returns a const reference to the wrapped expression of coefficients. */ + EIGEN_DEVICE_FUNC const SkewSymmetricVectorType& vector() const { return m_vector; } + + protected: + typename SkewSymmetricVectorType::Nested m_vector; +}; + +/** \returns a pseudo-expression of a skew symmetric matrix with *this as vector of coefficients + * + * \only_for_vectors + * + * \sa class SkewSymmetricWrapper, class SkewSymmetricMatrix3, vector(), isSkewSymmetric() + **/ +template +EIGEN_DEVICE_FUNC inline const SkewSymmetricWrapper MatrixBase::asSkewSymmetric() const { + return SkewSymmetricWrapper(derived()); +} + +/** \returns true if *this is approximately equal to a skew symmetric matrix, + * within the precision given by \a prec. + */ +template +bool MatrixBase::isSkewSymmetric(const RealScalar& prec) const { + if (cols() != rows()) return false; + return (this->transpose() + *this).isZero(prec); +} + +/** \returns the matrix product of \c *this by the skew symmetric matrix \a skew. + */ +template +template +EIGEN_DEVICE_FUNC inline const Product MatrixBase::operator*( + const SkewSymmetricBase& skew) const { + return Product(derived(), skew.derived()); +} + +namespace internal { + +template <> +struct storage_kind_to_shape { + typedef SkewSymmetricShape Shape; +}; + +struct SkewSymmetric2Dense {}; + +template <> +struct AssignmentKind { + typedef SkewSymmetric2Dense Kind; +}; + +// SkewSymmetric matrix to Dense assignment +template +struct Assignment { + EIGEN_DEVICE_FUNC static void run( + DstXprType& dst, const SrcXprType& src, + const internal::assign_op& /*func*/) { + if ((dst.rows() != 3) || (dst.cols() != 3)) { + dst.resize(3, 3); + } + dst.diagonal().setZero(); + const typename SrcXprType::SkewSymmetricVectorType v = src.vector(); + dst(0, 1) = -v(2); + dst(1, 0) = v(2); + dst(0, 2) = v(1); + dst(2, 0) = -v(1); + dst(1, 2) = -v(0); + dst(2, 1) = v(0); + } + EIGEN_DEVICE_FUNC static void run( + DstXprType& dst, const SrcXprType& src, + const internal::add_assign_op& /*func*/) { + dst.vector() += src.vector(); + } + + EIGEN_DEVICE_FUNC static void run( + DstXprType& dst, const SrcXprType& src, + const internal::sub_assign_op& /*func*/) { + dst.vector() -= src.vector(); + } +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_SKEWSYMMETRICMATRIX3_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Solve.h b/src/3rdparty/eigen/Eigen/src/Core/Solve.h new file mode 100644 index 0000000..aa51410 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Solve.h @@ -0,0 +1,174 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2014 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SOLVE_H +#define EIGEN_SOLVE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +template +class SolveImpl; + +/** \class Solve + * \ingroup Core_Module + * + * \brief Pseudo expression representing a solving operation + * + * \tparam Decomposition the type of the matrix or decomposition object + * \tparam Rhstype the type of the right-hand side + * + * This class represents an expression of A.solve(B) + * and most of the time this is the only way it is used. + * + */ +namespace internal { + +// this solve_traits class permits to determine the evaluation type with respect to storage kind (Dense vs Sparse) +template +struct solve_traits; + +template +struct solve_traits { + typedef typename make_proper_matrix_type::type + PlainObject; +}; + +template +struct traits > + : traits< + typename solve_traits::StorageKind>::PlainObject> { + typedef typename solve_traits::StorageKind>::PlainObject + PlainObject; + typedef typename promote_index_type::type + StorageIndex; + typedef traits BaseTraits; + enum { Flags = BaseTraits::Flags & RowMajorBit, CoeffReadCost = HugeCost }; +}; + +} // namespace internal + +template +class Solve : public SolveImpl::StorageKind> { + public: + typedef typename internal::traits::PlainObject PlainObject; + typedef typename internal::traits::StorageIndex StorageIndex; + + Solve(const Decomposition &dec, const RhsType &rhs) : m_dec(dec), m_rhs(rhs) {} + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_dec.cols(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_rhs.cols(); } + + EIGEN_DEVICE_FUNC const Decomposition &dec() const { return m_dec; } + EIGEN_DEVICE_FUNC const RhsType &rhs() const { return m_rhs; } + + protected: + const Decomposition &m_dec; + const typename internal::ref_selector::type m_rhs; +}; + +// Specialization of the Solve expression for dense results +template +class SolveImpl : public MatrixBase > { + typedef Solve Derived; + + public: + typedef MatrixBase > Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Derived) + + private: + Scalar coeff(Index row, Index col) const; + Scalar coeff(Index i) const; +}; + +// Generic API dispatcher +template +class SolveImpl : public internal::generic_xpr_base, MatrixXpr, StorageKind>::type { + public: + typedef typename internal::generic_xpr_base, MatrixXpr, StorageKind>::type Base; +}; + +namespace internal { + +// Evaluator of Solve -> eval into a temporary +template +struct evaluator > + : public evaluator::PlainObject> { + typedef Solve SolveType; + typedef typename SolveType::PlainObject PlainObject; + typedef evaluator Base; + + enum { Flags = Base::Flags | EvalBeforeNestingBit }; + + EIGEN_DEVICE_FUNC explicit evaluator(const SolveType &solve) : m_result(solve.rows(), solve.cols()) { + internal::construct_at(this, m_result); + solve.dec()._solve_impl(solve.rhs(), m_result); + } + + protected: + PlainObject m_result; +}; + +// Specialization for "dst = dec.solve(rhs)" +// NOTE we need to specialize it for Dense2Dense to avoid ambiguous specialization error and a Sparse2Sparse +// specialization must exist somewhere +template +struct Assignment, internal::assign_op, Dense2Dense> { + typedef Solve SrcXprType; + static void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + + src.dec()._solve_impl(src.rhs(), dst); + } +}; + +// Specialization for "dst = dec.transpose().solve(rhs)" +template +struct Assignment, RhsType>, internal::assign_op, + Dense2Dense> { + typedef Solve, RhsType> SrcXprType; + static void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + + src.dec().nestedExpression().template _solve_impl_transposed(src.rhs(), dst); + } +}; + +// Specialization for "dst = dec.adjoint().solve(rhs)" +template +struct Assignment< + DstXprType, + Solve, const Transpose >, + RhsType>, + internal::assign_op, Dense2Dense> { + typedef Solve, const Transpose >, + RhsType> + SrcXprType; + static void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + + src.dec().nestedExpression().nestedExpression().template _solve_impl_transposed(src.rhs(), dst); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_SOLVE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/SolveTriangular.h b/src/3rdparty/eigen/Eigen/src/Core/SolveTriangular.h new file mode 100644 index 0000000..9d31874 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/SolveTriangular.h @@ -0,0 +1,237 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SOLVETRIANGULAR_H +#define EIGEN_SOLVETRIANGULAR_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +// Forward declarations: +// The following two routines are implemented in the products/TriangularSolver*.h files +template +struct triangular_solve_vector; + +template +struct triangular_solve_matrix; + +// small helper struct extracting some traits on the underlying solver operation +template +class trsolve_traits { + private: + enum { RhsIsVectorAtCompileTime = (Side == OnTheLeft ? Rhs::ColsAtCompileTime : Rhs::RowsAtCompileTime) == 1 }; + + public: + enum { + Unrolling = (RhsIsVectorAtCompileTime && Rhs::SizeAtCompileTime != Dynamic && Rhs::SizeAtCompileTime <= 8) + ? CompleteUnrolling + : NoUnrolling, + RhsVectors = RhsIsVectorAtCompileTime ? 1 : Dynamic + }; +}; + +template ::Unrolling, + int RhsVectors = trsolve_traits::RhsVectors> +struct triangular_solver_selector; + +template +struct triangular_solver_selector { + typedef typename Lhs::Scalar LhsScalar; + typedef typename Rhs::Scalar RhsScalar; + typedef blas_traits LhsProductTraits; + typedef typename LhsProductTraits::ExtractType ActualLhsType; + typedef Map, Aligned> MappedRhs; + static EIGEN_DEVICE_FUNC void run(const Lhs& lhs, Rhs& rhs) { + ActualLhsType actualLhs = LhsProductTraits::extract(lhs); + + // FIXME find a way to allow an inner stride if packet_traits::size==1 + + bool useRhsDirectly = Rhs::InnerStrideAtCompileTime == 1 || rhs.innerStride() == 1; + + ei_declare_aligned_stack_constructed_variable(RhsScalar, actualRhs, rhs.size(), (useRhsDirectly ? rhs.data() : 0)); + + if (!useRhsDirectly) MappedRhs(actualRhs, rhs.size()) = rhs; + + triangular_solve_vector::run(actualLhs.cols(), + actualLhs.data(), + actualLhs.outerStride(), + actualRhs); + + if (!useRhsDirectly) rhs = MappedRhs(actualRhs, rhs.size()); + } +}; + +// the rhs is a matrix +template +struct triangular_solver_selector { + typedef typename Rhs::Scalar Scalar; + typedef blas_traits LhsProductTraits; + typedef typename LhsProductTraits::DirectLinearAccessType ActualLhsType; + + static EIGEN_DEVICE_FUNC void run(const Lhs& lhs, Rhs& rhs) { + add_const_on_value_type_t actualLhs = LhsProductTraits::extract(lhs); + + const Index size = lhs.rows(); + const Index othersize = Side == OnTheLeft ? rhs.cols() : rhs.rows(); + + typedef internal::gemm_blocking_space<(Rhs::Flags & RowMajorBit) ? RowMajor : ColMajor, Scalar, Scalar, + Rhs::MaxRowsAtCompileTime, Rhs::MaxColsAtCompileTime, + Lhs::MaxRowsAtCompileTime, 4> + BlockingType; + + // Nothing to solve. + if (actualLhs.size() == 0 || rhs.size() == 0) { + return; + } + + BlockingType blocking(rhs.rows(), rhs.cols(), size, 1, false); + + triangular_solve_matrix::run(size, othersize, &actualLhs.coeffRef(0, 0), + actualLhs.outerStride(), &rhs.coeffRef(0, 0), + rhs.innerStride(), rhs.outerStride(), blocking); + } +}; + +/*************************************************************************** + * meta-unrolling implementation + ***************************************************************************/ + +template +struct triangular_solver_unroller; + +template +struct triangular_solver_unroller { + enum { + IsLower = ((Mode & Lower) == Lower), + DiagIndex = IsLower ? LoopIndex : Size - LoopIndex - 1, + StartIndex = IsLower ? 0 : DiagIndex + 1 + }; + static EIGEN_DEVICE_FUNC void run(const Lhs& lhs, Rhs& rhs) { + if (LoopIndex > 0) + rhs.coeffRef(DiagIndex) -= lhs.row(DiagIndex) + .template segment(StartIndex) + .transpose() + .cwiseProduct(rhs.template segment(StartIndex)) + .sum(); + + if (!(Mode & UnitDiag)) rhs.coeffRef(DiagIndex) /= lhs.coeff(DiagIndex, DiagIndex); + + triangular_solver_unroller::run(lhs, rhs); + } +}; + +template +struct triangular_solver_unroller { + static EIGEN_DEVICE_FUNC void run(const Lhs&, Rhs&) {} +}; + +template +struct triangular_solver_selector { + static EIGEN_DEVICE_FUNC void run(const Lhs& lhs, Rhs& rhs) { + triangular_solver_unroller::run(lhs, rhs); + } +}; + +template +struct triangular_solver_selector { + static EIGEN_DEVICE_FUNC void run(const Lhs& lhs, Rhs& rhs) { + Transpose trLhs(lhs); + Transpose trRhs(rhs); + + triangular_solver_unroller, Transpose, + ((Mode & Upper) == Upper ? Lower : Upper) | (Mode & UnitDiag), 0, + Rhs::SizeAtCompileTime>::run(trLhs, trRhs); + } +}; + +} // end namespace internal + +/*************************************************************************** + * TriangularView methods + ***************************************************************************/ + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +template +EIGEN_DEVICE_FUNC void TriangularViewImpl::solveInPlace( + const MatrixBase& _other) const { + OtherDerived& other = _other.const_cast_derived(); + eigen_assert(derived().cols() == derived().rows() && ((Side == OnTheLeft && derived().cols() == other.rows()) || + (Side == OnTheRight && derived().cols() == other.cols()))); + eigen_assert((!(int(Mode) & int(ZeroDiag))) && bool(int(Mode) & (int(Upper) | int(Lower)))); + // If solving for a 0x0 matrix, nothing to do, simply return. + if (derived().cols() == 0) return; + + enum { + copy = (internal::traits::Flags & RowMajorBit) && OtherDerived::IsVectorAtCompileTime && + OtherDerived::SizeAtCompileTime != 1 + }; + typedef std::conditional_t::type, OtherDerived&> + OtherCopy; + OtherCopy otherCopy(other); + + internal::triangular_solver_selector, Side, Mode>::run( + derived().nestedExpression(), otherCopy); + + if (copy) other = otherCopy; +} + +template +template +const internal::triangular_solve_retval, Other> +TriangularViewImpl::solve(const MatrixBase& other) const { + return internal::triangular_solve_retval(derived(), other.derived()); +} +#endif + +namespace internal { + +template +struct traits > { + typedef typename internal::plain_matrix_type_column_major::type ReturnType; +}; + +template +struct triangular_solve_retval : public ReturnByValue > { + typedef remove_all_t RhsNestedCleaned; + typedef ReturnByValue Base; + + triangular_solve_retval(const TriangularType& tri, const Rhs& rhs) : m_triangularMatrix(tri), m_rhs(rhs) {} + + constexpr Index rows() const noexcept { return m_rhs.rows(); } + constexpr Index cols() const noexcept { return m_rhs.cols(); } + + template + inline void evalTo(Dest& dst) const { + if (!is_same_dense(dst, m_rhs)) dst = m_rhs; + m_triangularMatrix.template solveInPlace(dst); + } + + protected: + const TriangularType& m_triangularMatrix; + typename Rhs::Nested m_rhs; +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_SOLVETRIANGULAR_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/SolverBase.h b/src/3rdparty/eigen/Eigen/src/Core/SolverBase.h new file mode 100644 index 0000000..5a6dfd4 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/SolverBase.h @@ -0,0 +1,167 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2015 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SOLVERBASE_H +#define EIGEN_SOLVERBASE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct solve_assertion { + template + static void run(const Derived& solver, const Rhs& b) { + solver.template _check_solve_assertion(b); + } +}; + +template +struct solve_assertion> { + typedef Transpose type; + + template + static void run(const type& transpose, const Rhs& b) { + internal::solve_assertion>::template run(transpose.nestedExpression(), b); + } +}; + +template +struct solve_assertion, const Transpose>> { + typedef CwiseUnaryOp, const Transpose> type; + + template + static void run(const type& adjoint, const Rhs& b) { + internal::solve_assertion>>::template run( + adjoint.nestedExpression(), b); + } +}; +} // end namespace internal + +/** \class SolverBase + * \brief A base class for matrix decomposition and solvers + * + * \tparam Derived the actual type of the decomposition/solver. + * + * Any matrix decomposition inheriting this base class provide the following API: + * + * \code + * MatrixType A, b, x; + * DecompositionType dec(A); + * x = dec.solve(b); // solve A * x = b + * x = dec.transpose().solve(b); // solve A^T * x = b + * x = dec.adjoint().solve(b); // solve A' * x = b + * \endcode + * + * \warning Currently, any other usage of transpose() and adjoint() are not supported and will produce compilation + * errors. + * + * \sa class PartialPivLU, class FullPivLU, class HouseholderQR, class ColPivHouseholderQR, class FullPivHouseholderQR, + * class CompleteOrthogonalDecomposition, class LLT, class LDLT, class SVDBase + */ +template +class SolverBase : public EigenBase { + public: + typedef EigenBase Base; + typedef typename internal::traits::Scalar Scalar; + typedef Scalar CoeffReturnType; + + template + friend struct internal::solve_assertion; + + ComputationInfo info() const { + // CRTP static dispatch: Calls the 'info()' method on the derived class. + // Derived must implement 'ComputationInfo info() const'. + // If not implemented, name lookup falls back to this base method, causing + // infinite recursion (detectable by -Winfinite-recursion). + return derived().info(); + } + + enum { + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + SizeAtCompileTime = (internal::size_of_xpr_at_compile_time::ret), + MaxRowsAtCompileTime = internal::traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = internal::traits::MaxColsAtCompileTime, + MaxSizeAtCompileTime = internal::size_at_compile_time(internal::traits::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime), + IsVectorAtCompileTime = + internal::traits::MaxRowsAtCompileTime == 1 || internal::traits::MaxColsAtCompileTime == 1, + NumDimensions = int(MaxSizeAtCompileTime) == 1 ? 0 + : bool(IsVectorAtCompileTime) ? 1 + : 2 + }; + + /** Default constructor */ + SolverBase() {} + + ~SolverBase() {} + + using Base::derived; + + /** \returns an expression of the solution x of \f$ A x = b \f$ using the current decomposition of A. + */ + template + inline const Solve solve(const MatrixBase& b) const { + internal::solve_assertion>::template run(derived(), b); + return Solve(derived(), b.derived()); + } + + /** \internal the return type of transpose() */ + typedef Transpose ConstTransposeReturnType; + /** \returns an expression of the transposed of the factored matrix. + * + * A typical usage is to solve for the transposed problem A^T x = b: + * \code x = dec.transpose().solve(b); \endcode + * + * \sa adjoint(), solve() + */ + inline const ConstTransposeReturnType transpose() const { return ConstTransposeReturnType(derived()); } + + /** \internal the return type of adjoint() */ + typedef std::conditional_t::IsComplex, + CwiseUnaryOp, const ConstTransposeReturnType>, + const ConstTransposeReturnType> + AdjointReturnType; + /** \returns an expression of the adjoint of the factored matrix + * + * A typical usage is to solve for the adjoint problem A' x = b: + * \code x = dec.adjoint().solve(b); \endcode + * + * For real scalar types, this function is equivalent to transpose(). + * + * \sa transpose(), solve() + */ + inline const AdjointReturnType adjoint() const { return AdjointReturnType(derived().transpose()); } + + protected: + template + void _check_solve_assertion(const Rhs& b) const { + EIGEN_ONLY_USED_FOR_DEBUG(b); + eigen_assert(derived().m_isInitialized && "Solver is not initialized."); + eigen_assert((Transpose_ ? derived().cols() : derived().rows()) == b.rows() && + "SolverBase::solve(): invalid number of rows of the right hand side matrix b"); + } +}; + +namespace internal { + +template +struct generic_xpr_base { + typedef SolverBase type; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_SOLVERBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/StableNorm.h b/src/3rdparty/eigen/Eigen/src/Core/StableNorm.h new file mode 100644 index 0000000..711ee3f --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/StableNorm.h @@ -0,0 +1,217 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STABLENORM_H +#define EIGEN_STABLENORM_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +inline void stable_norm_kernel(const ExpressionType& bl, Scalar& ssq, Scalar& scale, Scalar& invScale) { + Scalar maxCoeff = bl.cwiseAbs().maxCoeff(); + + if (maxCoeff > scale) { + ssq = ssq * numext::abs2(scale / maxCoeff); + Scalar tmp = Scalar(1) / maxCoeff; + if (tmp > NumTraits::highest()) { + invScale = NumTraits::highest(); + scale = Scalar(1) / invScale; + } else if (maxCoeff > NumTraits::highest()) // we got a INF + { + invScale = Scalar(1); + scale = maxCoeff; + } else { + scale = maxCoeff; + invScale = tmp; + } + } else if (maxCoeff != maxCoeff) // we got a NaN + { + scale = maxCoeff; + } + + // TODO if the maxCoeff is much much smaller than the current scale, + // then we can neglect this sub vector + if (scale > Scalar(0)) // if scale==0, then bl is 0 + ssq += (bl * invScale).squaredNorm(); +} + +template +void stable_norm_impl_inner_step(const VectorType& vec, RealScalar& ssq, RealScalar& scale, RealScalar& invScale) { + const Index blockSize = 4096; + + Index n = vec.size(); + Index blockEnd = numext::round_down(n, blockSize); + for (Index i = 0; i < blockEnd; i += blockSize) { + internal::stable_norm_kernel(vec.template segment(i), ssq, scale, invScale); + } + if (n > blockEnd) { + internal::stable_norm_kernel(vec.tail(n - blockEnd), ssq, scale, invScale); + } +} + +template +typename VectorType::RealScalar stable_norm_impl(const VectorType& vec, + std::enable_if_t* = 0) { + using std::abs; + using std::sqrt; + + Index n = vec.size(); + if (EIGEN_PREDICT_FALSE(n == 1)) return abs(vec.coeff(0)); + + typedef typename VectorType::RealScalar RealScalar; + RealScalar scale(0); + RealScalar invScale(1); + RealScalar ssq(0); // sum of squares + + stable_norm_impl_inner_step(vec, ssq, scale, invScale); + + return scale * sqrt(ssq); +} + +template +typename MatrixType::RealScalar stable_norm_impl(const MatrixType& mat, + std::enable_if_t* = 0) { + using std::sqrt; + + typedef typename MatrixType::RealScalar RealScalar; + RealScalar scale(0); + RealScalar invScale(1); + RealScalar ssq(0); // sum of squares + + for (Index j = 0; j < mat.outerSize(); ++j) stable_norm_impl_inner_step(mat.innerVector(j), ssq, scale, invScale); + return scale * sqrt(ssq); +} + +template +inline typename NumTraits::Scalar>::Real blueNorm_impl(const EigenBase& _vec) { + typedef typename Derived::RealScalar RealScalar; + using std::abs; + using std::pow; + using std::sqrt; + + // This program calculates the machine-dependent constants + // bl, b2, slm, s2m, relerr overfl + // from the "basic" machine-dependent numbers + // nbig, ibeta, it, iemin, iemax, rbig. + // The following define the basic machine-dependent constants. + // For portability, the PORT subprograms "ilmaeh" and "rlmach" + // are used. For any specific computer, each of the assignment + // statements can be replaced + static const int ibeta = std::numeric_limits::radix; // base for floating-point numbers + static const int it = NumTraits::digits(); // number of base-beta digits in mantissa + static const int iemin = NumTraits::min_exponent(); // minimum exponent + static const int iemax = NumTraits::max_exponent(); // maximum exponent + static const RealScalar rbig = NumTraits::highest(); // largest floating-point number + static const RealScalar b1 = + RealScalar(pow(RealScalar(ibeta), RealScalar(-((1 - iemin) / 2)))); // lower boundary of midrange + static const RealScalar b2 = + RealScalar(pow(RealScalar(ibeta), RealScalar((iemax + 1 - it) / 2))); // upper boundary of midrange + static const RealScalar s1m = + RealScalar(pow(RealScalar(ibeta), RealScalar((2 - iemin) / 2))); // scaling factor for lower range + static const RealScalar s2m = + RealScalar(pow(RealScalar(ibeta), RealScalar(-((iemax + it) / 2)))); // scaling factor for upper range + static const RealScalar eps = RealScalar(pow(double(ibeta), 1 - it)); + static const RealScalar relerr = sqrt(eps); // tolerance for neglecting asml + + const Derived& vec(_vec.derived()); + Index n = vec.size(); + RealScalar ab2 = b2 / RealScalar(n); + RealScalar asml = RealScalar(0); + RealScalar amed = RealScalar(0); + RealScalar abig = RealScalar(0); + + for (Index j = 0; j < vec.outerSize(); ++j) { + for (typename Derived::InnerIterator iter(vec, j); iter; ++iter) { + RealScalar ax = abs(iter.value()); + if (ax > ab2) + abig += numext::abs2(ax * s2m); + else if (ax < b1) + asml += numext::abs2(ax * s1m); + else + amed += numext::abs2(ax); + } + } + if (amed != amed) return amed; // we got a NaN + if (abig > RealScalar(0)) { + abig = sqrt(abig); + if (abig > rbig) // overflow, or *this contains INF values + return abig; // return INF + if (amed > RealScalar(0)) { + abig = abig / s2m; + amed = sqrt(amed); + } else + return abig / s2m; + } else if (asml > RealScalar(0)) { + if (amed > RealScalar(0)) { + abig = sqrt(amed); + amed = sqrt(asml) / s1m; + } else + return sqrt(asml) / s1m; + } else + return sqrt(amed); + asml = numext::mini(abig, amed); + abig = numext::maxi(abig, amed); + if (asml <= abig * relerr) + return abig; + else + return abig * sqrt(RealScalar(1) + numext::abs2(asml / abig)); +} + +} // end namespace internal + +/** \returns the \em l2 norm of \c *this avoiding underflow and overflow. + * This version use a blockwise two passes algorithm: + * 1 - find the absolute largest coefficient \c s + * 2 - compute \f$ s \Vert \frac{*this}{s} \Vert \f$ in a standard way + * + * For architecture/scalar types supporting vectorization, this version + * is faster than blueNorm(). Otherwise the blueNorm() is much faster. + * + * \sa norm(), blueNorm(), hypotNorm() + */ +template +inline typename NumTraits::Scalar>::Real MatrixBase::stableNorm() const { + return internal::stable_norm_impl(derived()); +} + +/** \returns the \em l2 norm of \c *this using the Blue's algorithm. + * A Portable Fortran Program to Find the Euclidean Norm of a Vector, + * ACM TOMS, Vol 4, Issue 1, 1978. + * + * For architecture/scalar types without vectorization, this version + * is much faster than stableNorm(). Otherwise the stableNorm() is faster. + * + * \sa norm(), stableNorm(), hypotNorm() + */ +template +inline typename NumTraits::Scalar>::Real MatrixBase::blueNorm() const { + return internal::blueNorm_impl(*this); +} + +/** \returns the \em l2 norm of \c *this avoiding underflow and overflow. + * This version use a concatenation of hypot() calls, and it is very slow. + * + * \sa norm(), stableNorm() + */ +template +inline typename NumTraits::Scalar>::Real MatrixBase::hypotNorm() const { + if (size() == 1) + return numext::abs(coeff(0, 0)); + else + return this->cwiseAbs().redux(internal::scalar_hypot_op()); +} + +} // end namespace Eigen + +#endif // EIGEN_STABLENORM_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/StlIterators.h b/src/3rdparty/eigen/Eigen/src/Core/StlIterators.h new file mode 100644 index 0000000..a24d4c2 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/StlIterators.h @@ -0,0 +1,619 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2018 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STLITERATORS_H +#define EIGEN_STLITERATORS_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct indexed_based_stl_iterator_traits; + +template +class indexed_based_stl_iterator_base { + protected: + typedef indexed_based_stl_iterator_traits traits; + typedef typename traits::XprType XprType; + typedef indexed_based_stl_iterator_base non_const_iterator; + typedef indexed_based_stl_iterator_base const_iterator; + typedef std::conditional_t::value, non_const_iterator, const_iterator> other_iterator; + // NOTE: in C++03 we cannot declare friend classes through typedefs because we need to write friend class: + friend class indexed_based_stl_iterator_base; + friend class indexed_based_stl_iterator_base; + + public: + typedef Index difference_type; + typedef std::random_access_iterator_tag iterator_category; + + indexed_based_stl_iterator_base() noexcept : mp_xpr(0), m_index(0) {} + indexed_based_stl_iterator_base(XprType& xpr, Index index) noexcept : mp_xpr(&xpr), m_index(index) {} + + indexed_based_stl_iterator_base(const non_const_iterator& other) noexcept + : mp_xpr(other.mp_xpr), m_index(other.m_index) {} + + indexed_based_stl_iterator_base& operator=(const non_const_iterator& other) { + mp_xpr = other.mp_xpr; + m_index = other.m_index; + return *this; + } + + Derived& operator++() { + ++m_index; + return derived(); + } + Derived& operator--() { + --m_index; + return derived(); + } + + Derived operator++(int) { + Derived prev(derived()); + operator++(); + return prev; + } + Derived operator--(int) { + Derived prev(derived()); + operator--(); + return prev; + } + + friend Derived operator+(const indexed_based_stl_iterator_base& a, Index b) { + Derived ret(a.derived()); + ret += b; + return ret; + } + friend Derived operator-(const indexed_based_stl_iterator_base& a, Index b) { + Derived ret(a.derived()); + ret -= b; + return ret; + } + friend Derived operator+(Index a, const indexed_based_stl_iterator_base& b) { + Derived ret(b.derived()); + ret += a; + return ret; + } + friend Derived operator-(Index a, const indexed_based_stl_iterator_base& b) { + Derived ret(b.derived()); + ret -= a; + return ret; + } + + Derived& operator+=(Index b) { + m_index += b; + return derived(); + } + Derived& operator-=(Index b) { + m_index -= b; + return derived(); + } + + difference_type operator-(const indexed_based_stl_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index - other.m_index; + } + + difference_type operator-(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index - other.m_index; + } + + bool operator==(const indexed_based_stl_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index == other.m_index; + } + bool operator!=(const indexed_based_stl_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index != other.m_index; + } + bool operator<(const indexed_based_stl_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index < other.m_index; + } + bool operator<=(const indexed_based_stl_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index <= other.m_index; + } + bool operator>(const indexed_based_stl_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index > other.m_index; + } + bool operator>=(const indexed_based_stl_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index >= other.m_index; + } + + bool operator==(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index == other.m_index; + } + bool operator!=(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index != other.m_index; + } + bool operator<(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index < other.m_index; + } + bool operator<=(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index <= other.m_index; + } + bool operator>(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index > other.m_index; + } + bool operator>=(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index >= other.m_index; + } + + protected: + Derived& derived() { return static_cast(*this); } + const Derived& derived() const { return static_cast(*this); } + + XprType* mp_xpr; + Index m_index; +}; + +template +class indexed_based_stl_reverse_iterator_base { + protected: + typedef indexed_based_stl_iterator_traits traits; + typedef typename traits::XprType XprType; + typedef indexed_based_stl_reverse_iterator_base non_const_iterator; + typedef indexed_based_stl_reverse_iterator_base const_iterator; + typedef std::conditional_t::value, non_const_iterator, const_iterator> other_iterator; + // NOTE: in C++03 we cannot declare friend classes through typedefs because we need to write friend class: + friend class indexed_based_stl_reverse_iterator_base; + friend class indexed_based_stl_reverse_iterator_base; + + public: + typedef Index difference_type; + typedef std::random_access_iterator_tag iterator_category; + + indexed_based_stl_reverse_iterator_base() : mp_xpr(0), m_index(0) {} + indexed_based_stl_reverse_iterator_base(XprType& xpr, Index index) : mp_xpr(&xpr), m_index(index) {} + + indexed_based_stl_reverse_iterator_base(const non_const_iterator& other) + : mp_xpr(other.mp_xpr), m_index(other.m_index) {} + + indexed_based_stl_reverse_iterator_base& operator=(const non_const_iterator& other) { + mp_xpr = other.mp_xpr; + m_index = other.m_index; + return *this; + } + + Derived& operator++() { + --m_index; + return derived(); + } + Derived& operator--() { + ++m_index; + return derived(); + } + + Derived operator++(int) { + Derived prev(derived()); + operator++(); + return prev; + } + Derived operator--(int) { + Derived prev(derived()); + operator--(); + return prev; + } + + friend Derived operator+(const indexed_based_stl_reverse_iterator_base& a, Index b) { + Derived ret(a.derived()); + ret += b; + return ret; + } + friend Derived operator-(const indexed_based_stl_reverse_iterator_base& a, Index b) { + Derived ret(a.derived()); + ret -= b; + return ret; + } + friend Derived operator+(Index a, const indexed_based_stl_reverse_iterator_base& b) { + Derived ret(b.derived()); + ret += a; + return ret; + } + friend Derived operator-(Index a, const indexed_based_stl_reverse_iterator_base& b) { + Derived ret(b.derived()); + ret -= a; + return ret; + } + + Derived& operator+=(Index b) { + m_index -= b; + return derived(); + } + Derived& operator-=(Index b) { + m_index += b; + return derived(); + } + + difference_type operator-(const indexed_based_stl_reverse_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return other.m_index - m_index; + } + + difference_type operator-(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return other.m_index - m_index; + } + + bool operator==(const indexed_based_stl_reverse_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index == other.m_index; + } + bool operator!=(const indexed_based_stl_reverse_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index != other.m_index; + } + bool operator<(const indexed_based_stl_reverse_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index > other.m_index; + } + bool operator<=(const indexed_based_stl_reverse_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index >= other.m_index; + } + bool operator>(const indexed_based_stl_reverse_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index < other.m_index; + } + bool operator>=(const indexed_based_stl_reverse_iterator_base& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index <= other.m_index; + } + + bool operator==(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index == other.m_index; + } + bool operator!=(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index != other.m_index; + } + bool operator<(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index > other.m_index; + } + bool operator<=(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index >= other.m_index; + } + bool operator>(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index < other.m_index; + } + bool operator>=(const other_iterator& other) const { + eigen_assert(mp_xpr == other.mp_xpr); + return m_index <= other.m_index; + } + + protected: + Derived& derived() { return static_cast(*this); } + const Derived& derived() const { return static_cast(*this); } + + XprType* mp_xpr; + Index m_index; +}; + +template +class pointer_based_stl_iterator { + enum { is_lvalue = internal::is_lvalue::value }; + typedef pointer_based_stl_iterator> non_const_iterator; + typedef pointer_based_stl_iterator> const_iterator; + typedef std::conditional_t::value, non_const_iterator, const_iterator> other_iterator; + // NOTE: in C++03 we cannot declare friend classes through typedefs because we need to write friend class: + friend class pointer_based_stl_iterator>; + friend class pointer_based_stl_iterator>; + + public: + typedef Index difference_type; + typedef typename XprType::Scalar value_type; +#if EIGEN_COMP_CXXVER >= 20 && defined(__cpp_lib_concepts) && __cpp_lib_concepts >= 202002L + typedef std::conditional_t + iterator_category; +#else + typedef std::random_access_iterator_tag iterator_category; +#endif + typedef std::conditional_t pointer; + typedef std::conditional_t reference; + + pointer_based_stl_iterator() noexcept : m_ptr(0) {} + pointer_based_stl_iterator(XprType& xpr, Index index) noexcept : m_incr(xpr.innerStride()) { + m_ptr = xpr.data() + index * m_incr.value(); + } + + pointer_based_stl_iterator(const non_const_iterator& other) noexcept : m_ptr(other.m_ptr), m_incr(other.m_incr) {} + + pointer_based_stl_iterator& operator=(const non_const_iterator& other) noexcept { + m_ptr = other.m_ptr; + m_incr.setValue(other.m_incr); + return *this; + } + + reference operator*() const { return *m_ptr; } + reference operator[](Index i) const { return *(m_ptr + i * m_incr.value()); } + pointer operator->() const { return m_ptr; } + + pointer_based_stl_iterator& operator++() { + m_ptr += m_incr.value(); + return *this; + } + pointer_based_stl_iterator& operator--() { + m_ptr -= m_incr.value(); + return *this; + } + + pointer_based_stl_iterator operator++(int) { + pointer_based_stl_iterator prev(*this); + operator++(); + return prev; + } + pointer_based_stl_iterator operator--(int) { + pointer_based_stl_iterator prev(*this); + operator--(); + return prev; + } + + friend pointer_based_stl_iterator operator+(const pointer_based_stl_iterator& a, Index b) { + pointer_based_stl_iterator ret(a); + ret += b; + return ret; + } + friend pointer_based_stl_iterator operator-(const pointer_based_stl_iterator& a, Index b) { + pointer_based_stl_iterator ret(a); + ret -= b; + return ret; + } + friend pointer_based_stl_iterator operator+(Index a, const pointer_based_stl_iterator& b) { + pointer_based_stl_iterator ret(b); + ret += a; + return ret; + } + friend pointer_based_stl_iterator operator-(Index a, const pointer_based_stl_iterator& b) { + pointer_based_stl_iterator ret(b); + ret -= a; + return ret; + } + + pointer_based_stl_iterator& operator+=(Index b) { + m_ptr += b * m_incr.value(); + return *this; + } + pointer_based_stl_iterator& operator-=(Index b) { + m_ptr -= b * m_incr.value(); + return *this; + } + + difference_type operator-(const pointer_based_stl_iterator& other) const { + return (m_ptr - other.m_ptr) / m_incr.value(); + } + + difference_type operator-(const other_iterator& other) const { return (m_ptr - other.m_ptr) / m_incr.value(); } + + bool operator==(const pointer_based_stl_iterator& other) const { return m_ptr == other.m_ptr; } + bool operator!=(const pointer_based_stl_iterator& other) const { return m_ptr != other.m_ptr; } + bool operator<(const pointer_based_stl_iterator& other) const { return m_ptr < other.m_ptr; } + bool operator<=(const pointer_based_stl_iterator& other) const { return m_ptr <= other.m_ptr; } + bool operator>(const pointer_based_stl_iterator& other) const { return m_ptr > other.m_ptr; } + bool operator>=(const pointer_based_stl_iterator& other) const { return m_ptr >= other.m_ptr; } + + bool operator==(const other_iterator& other) const { return m_ptr == other.m_ptr; } + bool operator!=(const other_iterator& other) const { return m_ptr != other.m_ptr; } + bool operator<(const other_iterator& other) const { return m_ptr < other.m_ptr; } + bool operator<=(const other_iterator& other) const { return m_ptr <= other.m_ptr; } + bool operator>(const other_iterator& other) const { return m_ptr > other.m_ptr; } + bool operator>=(const other_iterator& other) const { return m_ptr >= other.m_ptr; } + + protected: + pointer m_ptr; + internal::variable_if_dynamic m_incr; +}; + +template +struct indexed_based_stl_iterator_traits> { + typedef XprType_ XprType; + typedef generic_randaccess_stl_iterator> non_const_iterator; + typedef generic_randaccess_stl_iterator> const_iterator; +}; + +template +class generic_randaccess_stl_iterator + : public indexed_based_stl_iterator_base> { + public: + typedef typename XprType::Scalar value_type; + + protected: + enum { + has_direct_access = (internal::traits::Flags & DirectAccessBit) ? 1 : 0, + is_lvalue = internal::is_lvalue::value + }; + + typedef indexed_based_stl_iterator_base Base; + using Base::m_index; + using Base::mp_xpr; + + // TODO currently const Transpose/Reshape expressions never returns const references, + // so lets return by value too. + // typedef std::conditional_t read_only_ref_t; + typedef const value_type read_only_ref_t; + + public: + typedef std::conditional_t pointer; + typedef std::conditional_t reference; + + generic_randaccess_stl_iterator() : Base() {} + generic_randaccess_stl_iterator(XprType& xpr, Index index) : Base(xpr, index) {} + generic_randaccess_stl_iterator(const typename Base::non_const_iterator& other) : Base(other) {} + using Base::operator=; + + reference operator*() const { return (*mp_xpr)(m_index); } + reference operator[](Index i) const { return (*mp_xpr)(m_index + i); } + pointer operator->() const { return &((*mp_xpr)(m_index)); } +}; + +template +struct indexed_based_stl_iterator_traits> { + typedef XprType_ XprType; + typedef subvector_stl_iterator, Direction> non_const_iterator; + typedef subvector_stl_iterator, Direction> const_iterator; +}; + +template +class subvector_stl_iterator : public indexed_based_stl_iterator_base> { + protected: + enum { is_lvalue = internal::is_lvalue::value }; + + typedef indexed_based_stl_iterator_base Base; + using Base::m_index; + using Base::mp_xpr; + + typedef std::conditional_t SubVectorType; + typedef std::conditional_t + ConstSubVectorType; + + public: + typedef std::conditional_t reference; + typedef typename reference::PlainObject value_type; + + private: + class subvector_stl_iterator_ptr { + public: + subvector_stl_iterator_ptr(const reference& subvector) : m_subvector(subvector) {} + reference* operator->() { return &m_subvector; } + + private: + reference m_subvector; + }; + + public: + typedef subvector_stl_iterator_ptr pointer; + + subvector_stl_iterator() : Base() {} + subvector_stl_iterator(XprType& xpr, Index index) : Base(xpr, index) {} + + reference operator*() const { return (*mp_xpr).template subVector(m_index); } + reference operator[](Index i) const { return (*mp_xpr).template subVector(m_index + i); } + pointer operator->() const { return (*mp_xpr).template subVector(m_index); } +}; + +template +struct indexed_based_stl_iterator_traits> { + typedef XprType_ XprType; + typedef subvector_stl_reverse_iterator, Direction> non_const_iterator; + typedef subvector_stl_reverse_iterator, Direction> const_iterator; +}; + +template +class subvector_stl_reverse_iterator + : public indexed_based_stl_reverse_iterator_base> { + protected: + enum { is_lvalue = internal::is_lvalue::value }; + + typedef indexed_based_stl_reverse_iterator_base Base; + using Base::m_index; + using Base::mp_xpr; + + typedef std::conditional_t SubVectorType; + typedef std::conditional_t + ConstSubVectorType; + + public: + typedef std::conditional_t reference; + typedef typename reference::PlainObject value_type; + + private: + class subvector_stl_reverse_iterator_ptr { + public: + subvector_stl_reverse_iterator_ptr(const reference& subvector) : m_subvector(subvector) {} + reference* operator->() { return &m_subvector; } + + private: + reference m_subvector; + }; + + public: + typedef subvector_stl_reverse_iterator_ptr pointer; + + subvector_stl_reverse_iterator() : Base() {} + subvector_stl_reverse_iterator(XprType& xpr, Index index) : Base(xpr, index) {} + + reference operator*() const { return (*mp_xpr).template subVector(m_index); } + reference operator[](Index i) const { return (*mp_xpr).template subVector(m_index + i); } + pointer operator->() const { return (*mp_xpr).template subVector(m_index); } +}; + +} // namespace internal + +/** returns an iterator to the first element of the 1D vector or array + * \only_for_vectors + * \sa end(), cbegin() + */ +template +inline typename DenseBase::iterator DenseBase::begin() { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + return iterator(derived(), 0); +} + +/** const version of begin() */ +template +inline typename DenseBase::const_iterator DenseBase::begin() const { + return cbegin(); +} + +/** returns a read-only const_iterator to the first element of the 1D vector or array + * \only_for_vectors + * \sa cend(), begin() + */ +template +inline typename DenseBase::const_iterator DenseBase::cbegin() const { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + return const_iterator(derived(), 0); +} + +/** returns an iterator to the element following the last element of the 1D vector or array + * \only_for_vectors + * \sa begin(), cend() + */ +template +inline typename DenseBase::iterator DenseBase::end() { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + return iterator(derived(), size()); +} + +/** const version of end() */ +template +inline typename DenseBase::const_iterator DenseBase::end() const { + return cend(); +} + +/** returns a read-only const_iterator to the element following the last element of the 1D vector or array + * \only_for_vectors + * \sa begin(), cend() + */ +template +inline typename DenseBase::const_iterator DenseBase::cend() const { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + return const_iterator(derived(), size()); +} + +} // namespace Eigen + +#endif // EIGEN_STLITERATORS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Stride.h b/src/3rdparty/eigen/Eigen/src/Core/Stride.h new file mode 100644 index 0000000..692f0a1 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Stride.h @@ -0,0 +1,114 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STRIDE_H +#define EIGEN_STRIDE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class Stride + * \ingroup Core_Module + * + * \brief Holds strides information for Map + * + * This class holds the strides information for mapping arrays with strides with class Map. + * + * It holds two values: the inner stride and the outer stride. + * + * The inner stride is the pointer increment between two consecutive entries within a given row of a + * row-major matrix or within a given column of a column-major matrix. + * + * The outer stride is the pointer increment between two consecutive rows of a row-major matrix or + * between two consecutive columns of a column-major matrix. + * + * These two values can be passed either at compile-time as template parameters, or at runtime as + * arguments to the constructor. + * + * Indeed, this class takes two template parameters: + * \tparam OuterStrideAtCompileTime_ the outer stride, or Dynamic if you want to specify it at runtime. + * \tparam InnerStrideAtCompileTime_ the inner stride, or Dynamic if you want to specify it at runtime. + * + * Here is an example: + * \include Map_general_stride.cpp + * Output: \verbinclude Map_general_stride.out + * + * Both strides can be negative. However, a negative stride of -1 cannot be specified at compile time + * because of the ambiguity with Dynamic which is defined to -1 (historically, negative strides were + * not allowed). + * + * Note that for compile-time vectors (ColsAtCompileTime==1 or RowsAtCompile==1), + * the inner stride is the pointer increment between two consecutive elements, + * regardless of storage layout. + * + * \sa class InnerStride, class OuterStride, \ref TopicStorageOrders + */ +template +class Stride { + public: + typedef Eigen::Index Index; ///< \deprecated since Eigen 3.3 + enum { InnerStrideAtCompileTime = InnerStrideAtCompileTime_, OuterStrideAtCompileTime = OuterStrideAtCompileTime_ }; + + /** Default constructor, for use when strides are fixed at compile time */ + EIGEN_DEVICE_FUNC Stride() : m_outer(OuterStrideAtCompileTime), m_inner(InnerStrideAtCompileTime) { + // FIXME: for Eigen 4 we should use DynamicIndex instead of Dynamic. + // FIXME: for Eigen 4 we should also unify this API with fix<> + eigen_assert(InnerStrideAtCompileTime != Dynamic && OuterStrideAtCompileTime != Dynamic); + } + + /** Constructor allowing to pass the strides at runtime */ + EIGEN_DEVICE_FUNC Stride(Index outerStride, Index innerStride) : m_outer(outerStride), m_inner(innerStride) {} + + /** Copy constructor */ + EIGEN_DEVICE_FUNC Stride(const Stride& other) : m_outer(other.outer()), m_inner(other.inner()) {} + + /** Copy assignment operator */ + EIGEN_DEVICE_FUNC Stride& operator=(const Stride& other) { + m_outer.setValue(other.outer()); + m_inner.setValue(other.inner()); + return *this; + } + + /** \returns the outer stride */ + EIGEN_DEVICE_FUNC constexpr Index outer() const { return m_outer.value(); } + /** \returns the inner stride */ + EIGEN_DEVICE_FUNC constexpr Index inner() const { return m_inner.value(); } + + protected: + internal::variable_if_dynamic m_outer; + internal::variable_if_dynamic m_inner; +}; + +/** \brief Convenience specialization of Stride to specify only an inner stride + * See class Map for some examples */ +template +class InnerStride : public Stride<0, Value> { + typedef Stride<0, Value> Base; + + public: + EIGEN_DEVICE_FUNC InnerStride() : Base() {} + EIGEN_DEVICE_FUNC InnerStride(Index v) : Base(0, v) {} // FIXME making this explicit could break valid code +}; + +/** \brief Convenience specialization of Stride to specify only an outer stride + * See class Map for some examples */ +template +class OuterStride : public Stride { + typedef Stride Base; + + public: + EIGEN_DEVICE_FUNC OuterStride() : Base() {} + EIGEN_DEVICE_FUNC OuterStride(Index v) : Base(v, 0) {} // FIXME making this explicit could break valid code +}; + +} // end namespace Eigen + +#endif // EIGEN_STRIDE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Swap.h b/src/3rdparty/eigen/Eigen/src/Core/Swap.h new file mode 100644 index 0000000..dd825e9 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Swap.h @@ -0,0 +1,99 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SWAP_H +#define EIGEN_SWAP_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +// Overload default assignPacket behavior for swapping them +template +class generic_dense_assignment_kernel, Specialized> + : public generic_dense_assignment_kernel, BuiltIn> { + protected: + typedef generic_dense_assignment_kernel, BuiltIn> + Base; + using Base::m_dst; + using Base::m_functor; + using Base::m_src; + + public: + typedef typename Base::Scalar Scalar; + typedef typename Base::DstXprType DstXprType; + typedef swap_assign_op Functor; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE generic_dense_assignment_kernel(DstEvaluatorTypeT &dst, + const SrcEvaluatorTypeT &src, + const Functor &func, DstXprType &dstExpr) + : Base(dst, src, func, dstExpr) {} + + template + EIGEN_STRONG_INLINE void assignPacket(Index row, Index col) { + PacketType tmp = m_src.template packet(row, col); + const_cast(m_src).template writePacket( + row, col, m_dst.template packet(row, col)); + m_dst.template writePacket(row, col, tmp); + } + + template + EIGEN_STRONG_INLINE void assignPacket(Index index) { + PacketType tmp = m_src.template packet(index); + const_cast(m_src).template writePacket( + index, m_dst.template packet(index)); + m_dst.template writePacket(index, tmp); + } + + // TODO find a simple way not to have to copy/paste this function from generic_dense_assignment_kernel, by simple I + // mean no CRTP (Gael) + template + EIGEN_STRONG_INLINE void assignPacketByOuterInner(Index outer, Index inner) { + Index row = Base::rowIndexByOuterInner(outer, inner); + Index col = Base::colIndexByOuterInner(outer, inner); + assignPacket(row, col); + } + + template + EIGEN_STRONG_INLINE void assignPacketSegment(Index row, Index col, Index begin, Index count) { + PacketType tmp = m_src.template packetSegment(row, col, begin, count); + const_cast(m_src).template writePacketSegment( + row, col, m_dst.template packetSegment(row, col, begin, count), begin, count); + m_dst.template writePacketSegment(row, col, tmp, begin, count); + } + + template + EIGEN_STRONG_INLINE void assignPacketSegment(Index index, Index begin, Index count) { + PacketType tmp = m_src.template packetSegment(index, begin, count); + const_cast(m_src).template writePacketSegment( + index, m_dst.template packetSegment(index, begin, count), begin, count); + m_dst.template writePacketSegment(index, tmp, begin, count); + } + + // TODO find a simple way not to have to copy/paste this function from generic_dense_assignment_kernel, by simple I + // mean no CRTP (Gael) + template + EIGEN_STRONG_INLINE void assignPacketSegmentByOuterInner(Index outer, Index inner, Index begin, Index count) { + Index row = Base::rowIndexByOuterInner(outer, inner); + Index col = Base::colIndexByOuterInner(outer, inner); + assignPacketSegment(row, col, begin, count); + } +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_SWAP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Transpose.h b/src/3rdparty/eigen/Eigen/src/Core/Transpose.h new file mode 100644 index 0000000..0676a25 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Transpose.h @@ -0,0 +1,427 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2009-2014 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_TRANSPOSE_H +#define EIGEN_TRANSPOSE_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > : public traits { + typedef typename ref_selector::type MatrixTypeNested; + typedef std::remove_reference_t MatrixTypeNestedPlain; + enum { + RowsAtCompileTime = MatrixType::ColsAtCompileTime, + ColsAtCompileTime = MatrixType::RowsAtCompileTime, + MaxRowsAtCompileTime = MatrixType::MaxColsAtCompileTime, + MaxColsAtCompileTime = MatrixType::MaxRowsAtCompileTime, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags0 = traits::Flags & ~(LvalueBit | NestByRefBit), + Flags1 = Flags0 | FlagsLvalueBit, + Flags = Flags1 ^ RowMajorBit, + InnerStrideAtCompileTime = inner_stride_at_compile_time::ret, + OuterStrideAtCompileTime = outer_stride_at_compile_time::ret + }; +}; +} // namespace internal + +template +class TransposeImpl; + +/** \class Transpose + * \ingroup Core_Module + * + * \brief Expression of the transpose of a matrix + * + * \tparam MatrixType the type of the object of which we are taking the transpose + * + * This class represents an expression of the transpose of a matrix. + * It is the return type of MatrixBase::transpose() and MatrixBase::adjoint() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::transpose(), MatrixBase::adjoint() + */ +template +class Transpose : public TransposeImpl::StorageKind> { + public: + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + + typedef typename TransposeImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Transpose) + typedef internal::remove_all_t NestedExpression; + + EIGEN_DEVICE_FUNC explicit EIGEN_STRONG_INLINE Transpose(MatrixType& matrix) : m_matrix(matrix) {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Transpose) + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index rows() const noexcept { return m_matrix.cols(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr Index cols() const noexcept { return m_matrix.rows(); } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const internal::remove_all_t& nestedExpression() const { + return m_matrix; + } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE std::remove_reference_t& nestedExpression() { + return m_matrix; + } + + /** \internal */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void resize(Index nrows, Index ncols) { m_matrix.resize(ncols, nrows); } + + protected: + typename internal::ref_selector::non_const_type m_matrix; +}; + +namespace internal { + +template ::ret> +struct TransposeImpl_base { + typedef typename dense_xpr_base >::type type; +}; + +template +struct TransposeImpl_base { + typedef typename dense_xpr_base >::type type; +}; + +} // end namespace internal + +// Generic API dispatcher +template +class TransposeImpl : public internal::generic_xpr_base >::type { + public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +template +class TransposeImpl : public internal::TransposeImpl_base::type { + public: + typedef typename internal::TransposeImpl_base::type Base; + using Base::coeffRef; + EIGEN_DENSE_PUBLIC_INTERFACE(Transpose) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(TransposeImpl) + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index innerStride() const { return derived().nestedExpression().innerStride(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index outerStride() const { return derived().nestedExpression().outerStride(); } + + typedef std::conditional_t::value, Scalar, const Scalar> ScalarWithConstIfNotLvalue; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr ScalarWithConstIfNotLvalue* data() { + return derived().nestedExpression().data(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE constexpr const Scalar* data() const { + return derived().nestedExpression().data(); + } + + // FIXME: shall we keep the const version of coeffRef? + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar& coeffRef(Index rowId, Index colId) const { + return derived().nestedExpression().coeffRef(colId, rowId); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar& coeffRef(Index index) const { + return derived().nestedExpression().coeffRef(index); + } + + protected: + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(TransposeImpl) +}; + +/** \returns an expression of the transpose of *this. + * + * Example: \include MatrixBase_transpose.cpp + * Output: \verbinclude MatrixBase_transpose.out + * + * \warning If you want to replace a matrix by its own transpose, do \b NOT do this: + * \code + * m = m.transpose(); // bug!!! caused by aliasing effect + * \endcode + * Instead, use the transposeInPlace() method: + * \code + * m.transposeInPlace(); + * \endcode + * which gives Eigen good opportunities for optimization, or alternatively you can also do: + * \code + * m = m.transpose().eval(); + * \endcode + * + * \sa transposeInPlace(), adjoint() */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename DenseBase::TransposeReturnType DenseBase::transpose() { + return TransposeReturnType(derived()); +} + +/** This is the const version of transpose(). + * + * Make sure you read the warning for transpose() ! + * + * \sa transposeInPlace(), adjoint() */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstTransposeReturnType +DenseBase::transpose() const { + return ConstTransposeReturnType(derived()); +} + +/** \returns an expression of the adjoint (i.e. conjugate transpose) of *this. + * + * Example: \include MatrixBase_adjoint.cpp + * Output: \verbinclude MatrixBase_adjoint.out + * + * \warning If you want to replace a matrix by its own adjoint, do \b NOT do this: + * \code + * m = m.adjoint(); // bug!!! caused by aliasing effect + * \endcode + * Instead, use the adjointInPlace() method: + * \code + * m.adjointInPlace(); + * \endcode + * which gives Eigen good opportunities for optimization, or alternatively you can also do: + * \code + * m = m.adjoint().eval(); + * \endcode + * + * \sa adjointInPlace(), transpose(), conjugate(), class Transpose, class internal::scalar_conjugate_op */ +template +EIGEN_DEVICE_FUNC inline const typename MatrixBase::AdjointReturnType MatrixBase::adjoint() const { + return AdjointReturnType(this->transpose()); +} + +/*************************************************************************** + * "in place" transpose implementation + ***************************************************************************/ + +namespace internal { + +template ::size)) && + (internal::evaluator::Flags & PacketAccessBit)> +struct inplace_transpose_selector; + +template +struct inplace_transpose_selector { // square matrix + static void run(MatrixType& m) { + m.matrix().template triangularView().swap( + m.matrix().transpose().template triangularView()); + } +}; + +template +struct inplace_transpose_selector { // PacketSize x PacketSize + static void run(MatrixType& m) { + typedef typename MatrixType::Scalar Scalar; + typedef typename internal::packet_traits::type Packet; + const Index PacketSize = internal::packet_traits::size; + const Index Alignment = internal::evaluator::Alignment; + PacketBlock A; + for (Index i = 0; i < PacketSize; ++i) A.packet[i] = m.template packetByOuterInner(i, 0); + internal::ptranspose(A); + for (Index i = 0; i < PacketSize; ++i) + m.template writePacket(m.rowIndexByOuterInner(i, 0), m.colIndexByOuterInner(i, 0), A.packet[i]); + } +}; + +template +void BlockedInPlaceTranspose(MatrixType& m) { + typedef typename MatrixType::Scalar Scalar; + typedef typename internal::packet_traits::type Packet; + const Index PacketSize = internal::packet_traits::size; + eigen_assert(m.rows() == m.cols()); + int row_start = 0; + for (; row_start + PacketSize <= m.rows(); row_start += PacketSize) { + for (int col_start = row_start; col_start + PacketSize <= m.cols(); col_start += PacketSize) { + PacketBlock A; + if (row_start == col_start) { + for (Index i = 0; i < PacketSize; ++i) + A.packet[i] = m.template packetByOuterInner(row_start + i, col_start); + internal::ptranspose(A); + for (Index i = 0; i < PacketSize; ++i) + m.template writePacket(m.rowIndexByOuterInner(row_start + i, col_start), + m.colIndexByOuterInner(row_start + i, col_start), A.packet[i]); + } else { + PacketBlock B; + for (Index i = 0; i < PacketSize; ++i) { + A.packet[i] = m.template packetByOuterInner(row_start + i, col_start); + B.packet[i] = m.template packetByOuterInner(col_start + i, row_start); + } + internal::ptranspose(A); + internal::ptranspose(B); + for (Index i = 0; i < PacketSize; ++i) { + m.template writePacket(m.rowIndexByOuterInner(row_start + i, col_start), + m.colIndexByOuterInner(row_start + i, col_start), B.packet[i]); + m.template writePacket(m.rowIndexByOuterInner(col_start + i, row_start), + m.colIndexByOuterInner(col_start + i, row_start), A.packet[i]); + } + } + } + } + for (Index row = row_start; row < m.rows(); ++row) { + m.matrix().row(row).head(row).swap(m.matrix().col(row).head(row).transpose()); + } +} + +template +struct inplace_transpose_selector { // non square or dynamic matrix + static void run(MatrixType& m) { + typedef typename MatrixType::Scalar Scalar; + if (m.rows() == m.cols()) { + const Index PacketSize = internal::packet_traits::size; + if (!NumTraits::IsComplex && m.rows() >= PacketSize) { + if ((m.rows() % PacketSize) == 0) + BlockedInPlaceTranspose::Alignment>(m); + else + BlockedInPlaceTranspose(m); + } else { + m.matrix().template triangularView().swap( + m.matrix().transpose().template triangularView()); + } + } else { + m = m.transpose().eval(); + } + } +}; + +} // end namespace internal + +/** This is the "in place" version of transpose(): it replaces \c *this by its own transpose. + * Thus, doing + * \code + * m.transposeInPlace(); + * \endcode + * has the same effect on m as doing + * \code + * m = m.transpose().eval(); + * \endcode + * and is faster and also safer because in the latter line of code, forgetting the eval() results + * in a bug caused by \ref TopicAliasing "aliasing". + * + * Notice however that this method is only useful if you want to replace a matrix by its own transpose. + * If you just need the transpose of a matrix, use transpose(). + * + * \note if the matrix is not square, then \c *this must be a resizable matrix. + * This excludes (non-square) fixed-size matrices, block-expressions and maps. + * + * \sa transpose(), adjoint(), adjointInPlace() */ +template +EIGEN_DEVICE_FUNC inline void DenseBase::transposeInPlace() { + eigen_assert((rows() == cols() || (RowsAtCompileTime == Dynamic && ColsAtCompileTime == Dynamic)) && + "transposeInPlace() called on a non-square non-resizable matrix"); + internal::inplace_transpose_selector::run(derived()); +} + +/*************************************************************************** + * "in place" adjoint implementation + ***************************************************************************/ + +/** This is the "in place" version of adjoint(): it replaces \c *this by its own transpose. + * Thus, doing + * \code + * m.adjointInPlace(); + * \endcode + * has the same effect on m as doing + * \code + * m = m.adjoint().eval(); + * \endcode + * and is faster and also safer because in the latter line of code, forgetting the eval() results + * in a bug caused by aliasing. + * + * Notice however that this method is only useful if you want to replace a matrix by its own adjoint. + * If you just need the adjoint of a matrix, use adjoint(). + * + * \note if the matrix is not square, then \c *this must be a resizable matrix. + * This excludes (non-square) fixed-size matrices, block-expressions and maps. + * + * \sa transpose(), adjoint(), transposeInPlace() */ +template +EIGEN_DEVICE_FUNC inline void MatrixBase::adjointInPlace() { + derived() = adjoint().eval(); +} + +#ifndef EIGEN_NO_DEBUG + +// The following is to detect aliasing problems in most common cases. + +namespace internal { + +template +struct check_transpose_aliasing_compile_time_selector { + enum { ret = bool(blas_traits::IsTransposed) != DestIsTransposed }; +}; + +template +struct check_transpose_aliasing_compile_time_selector > { + enum { + ret = bool(blas_traits::IsTransposed) != DestIsTransposed || + bool(blas_traits::IsTransposed) != DestIsTransposed + }; +}; + +template +struct check_transpose_aliasing_run_time_selector { + EIGEN_DEVICE_FUNC static bool run(const Scalar* dest, const OtherDerived& src) { + return (bool(blas_traits::IsTransposed) != DestIsTransposed) && + (dest != 0 && dest == (const Scalar*)extract_data(src)); + } +}; + +template +struct check_transpose_aliasing_run_time_selector > { + EIGEN_DEVICE_FUNC static bool run(const Scalar* dest, const CwiseBinaryOp& src) { + return ((blas_traits::IsTransposed != DestIsTransposed) && + (dest != 0 && dest == (const Scalar*)extract_data(src.lhs()))) || + ((blas_traits::IsTransposed != DestIsTransposed) && + (dest != 0 && dest == (const Scalar*)extract_data(src.rhs()))); + } +}; + +// the following selector, checkTransposeAliasing_impl, based on MightHaveTransposeAliasing, +// is because when the condition controlling the assert is known at compile time, ICC emits a warning. +// This is actually a good warning: in expressions that don't have any transposing, the condition is +// known at compile time to be false, and using that, we can avoid generating the code of the assert again +// and again for all these expressions that don't need it. + +template ::IsTransposed, OtherDerived>::ret> +struct checkTransposeAliasing_impl { + EIGEN_DEVICE_FUNC static void run(const Derived& dst, const OtherDerived& other) { + eigen_assert( + (!check_transpose_aliasing_run_time_selector::IsTransposed, + OtherDerived>::run(extract_data(dst), other)) && + "aliasing detected during transposition, use transposeInPlace() " + "or evaluate the rhs into a temporary using .eval()"); + } +}; + +template +struct checkTransposeAliasing_impl { + EIGEN_DEVICE_FUNC static void run(const Derived&, const OtherDerived&) {} +}; + +template +EIGEN_DEVICE_FUNC inline void check_for_aliasing(const Dst& dst, const Src& src) { + if ((!Dst::IsVectorAtCompileTime) && dst.rows() > 1 && dst.cols() > 1) + internal::checkTransposeAliasing_impl::run(dst, src); +} + +} // end namespace internal + +#endif // EIGEN_NO_DEBUG + +} // end namespace Eigen + +#endif // EIGEN_TRANSPOSE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Transpositions.h b/src/3rdparty/eigen/Eigen/src/Core/Transpositions.h new file mode 100644 index 0000000..f6dd258 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Transpositions.h @@ -0,0 +1,323 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2010-2011 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_TRANSPOSITIONS_H +#define EIGEN_TRANSPOSITIONS_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +template +class TranspositionsBase { + typedef internal::traits Traits; + + public: + typedef typename Traits::IndicesType IndicesType; + typedef typename IndicesType::Scalar StorageIndex; + typedef Eigen::Index Index; ///< \deprecated since Eigen 3.3 + + EIGEN_DEVICE_FUNC Derived& derived() { return *static_cast(this); } + EIGEN_DEVICE_FUNC const Derived& derived() const { return *static_cast(this); } + + /** Copies the \a other transpositions into \c *this */ + template + Derived& operator=(const TranspositionsBase& other) { + indices() = other.indices(); + return derived(); + } + + /** \returns the number of transpositions */ + EIGEN_DEVICE_FUNC Index size() const { return indices().size(); } + /** \returns the number of rows of the equivalent permutation matrix */ + EIGEN_DEVICE_FUNC Index rows() const { return indices().size(); } + /** \returns the number of columns of the equivalent permutation matrix */ + EIGEN_DEVICE_FUNC Index cols() const { return indices().size(); } + + /** Direct access to the underlying index vector */ + EIGEN_DEVICE_FUNC inline const StorageIndex& coeff(Index i) const { return indices().coeff(i); } + /** Direct access to the underlying index vector */ + inline StorageIndex& coeffRef(Index i) { return indices().coeffRef(i); } + /** Direct access to the underlying index vector */ + inline const StorageIndex& operator()(Index i) const { return indices()(i); } + /** Direct access to the underlying index vector */ + inline StorageIndex& operator()(Index i) { return indices()(i); } + /** Direct access to the underlying index vector */ + inline const StorageIndex& operator[](Index i) const { return indices()(i); } + /** Direct access to the underlying index vector */ + inline StorageIndex& operator[](Index i) { return indices()(i); } + + /** const version of indices(). */ + EIGEN_DEVICE_FUNC const IndicesType& indices() const { return derived().indices(); } + /** \returns a reference to the stored array representing the transpositions. */ + EIGEN_DEVICE_FUNC IndicesType& indices() { return derived().indices(); } + + /** Resizes to given size. */ + inline void resize(Index newSize) { indices().resize(newSize); } + + /** Sets \c *this to represents an identity transformation */ + void setIdentity() { + for (StorageIndex i = 0; i < indices().size(); ++i) coeffRef(i) = i; + } + + // FIXME: do we want such methods ? + // might be useful when the target matrix expression is complex, e.g.: + // object.matrix().block(..,..,..,..) = trans * object.matrix().block(..,..,..,..); + /* + template + void applyForwardToRows(MatrixType& mat) const + { + for(Index k=0 ; k + void applyBackwardToRows(MatrixType& mat) const + { + for(Index k=size()-1 ; k>=0 ; --k) + if(m_indices(k)!=k) + mat.row(k).swap(mat.row(m_indices(k))); + } + */ + + /** \returns the inverse transformation */ + inline Transpose inverse() const { return Transpose(derived()); } + + /** \returns the transpose transformation */ + inline Transpose transpose() const { return Transpose(derived()); } + + protected: +}; + +namespace internal { +template +struct traits > + : traits > { + typedef Matrix IndicesType; + typedef TranspositionsStorage StorageKind; +}; +} // namespace internal + +/** \class Transpositions + * \ingroup Core_Module + * + * \brief Represents a sequence of transpositions (row/column interchange) + * + * \tparam SizeAtCompileTime the number of transpositions, or Dynamic + * \tparam MaxSizeAtCompileTime the maximum number of transpositions, or Dynamic. This optional parameter defaults to + * SizeAtCompileTime. Most of the time, you should not have to specify it. + * + * This class represents a permutation transformation as a sequence of \em n transpositions + * \f$[T_{n-1} \ldots T_{i} \ldots T_{0}]\f$. It is internally stored as a vector of integers \c indices. + * Each transposition \f$ T_{i} \f$ applied on the left of a matrix (\f$ T_{i} M\f$) interchanges + * the rows \c i and \c indices[i] of the matrix \c M. + * A transposition applied on the right (e.g., \f$ M T_{i}\f$) yields a column interchange. + * + * Compared to the class PermutationMatrix, such a sequence of transpositions is what is + * computed during a decomposition with pivoting, and it is faster when applying the permutation in-place. + * + * To apply a sequence of transpositions to a matrix, simply use the operator * as in the following example: + * \code + * Transpositions tr; + * MatrixXf mat; + * mat = tr * mat; + * \endcode + * In this example, we detect that the matrix appears on both side, and so the transpositions + * are applied in-place without any temporary or extra copy. + * + * \sa class PermutationMatrix + */ + +template +class Transpositions + : public TranspositionsBase > { + typedef internal::traits Traits; + + public: + typedef TranspositionsBase Base; + typedef typename Traits::IndicesType IndicesType; + typedef typename IndicesType::Scalar StorageIndex; + + inline Transpositions() {} + + /** Copy constructor. */ + template + inline Transpositions(const TranspositionsBase& other) : m_indices(other.indices()) {} + + /** Generic constructor from expression of the transposition indices. */ + template + explicit inline Transpositions(const MatrixBase& indices) : m_indices(indices) {} + + /** Copies the \a other transpositions into \c *this */ + template + Transpositions& operator=(const TranspositionsBase& other) { + return Base::operator=(other); + } + + /** Constructs an uninitialized permutation matrix of given size. + */ + inline Transpositions(Index size) : m_indices(size) {} + + /** const version of indices(). */ + EIGEN_DEVICE_FUNC const IndicesType& indices() const { return m_indices; } + /** \returns a reference to the stored array representing the transpositions. */ + EIGEN_DEVICE_FUNC IndicesType& indices() { return m_indices; } + + protected: + IndicesType m_indices; +}; + +namespace internal { +template +struct traits, PacketAccess_> > + : traits > { + typedef Map, PacketAccess_> IndicesType; + typedef StorageIndex_ StorageIndex; + typedef TranspositionsStorage StorageKind; +}; +} // namespace internal + +template +class Map, PacketAccess> + : public TranspositionsBase< + Map, PacketAccess> > { + typedef internal::traits Traits; + + public: + typedef TranspositionsBase Base; + typedef typename Traits::IndicesType IndicesType; + typedef typename IndicesType::Scalar StorageIndex; + + explicit inline Map(const StorageIndex* indicesPtr) : m_indices(indicesPtr) {} + + inline Map(const StorageIndex* indicesPtr, Index size) : m_indices(indicesPtr, size) {} + + /** Copies the \a other transpositions into \c *this */ + template + Map& operator=(const TranspositionsBase& other) { + return Base::operator=(other); + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + Map& operator=(const Map& other) { + m_indices = other.m_indices; + return *this; + } +#endif + + /** const version of indices(). */ + EIGEN_DEVICE_FUNC const IndicesType& indices() const { return m_indices; } + + /** \returns a reference to the stored array representing the transpositions. */ + EIGEN_DEVICE_FUNC IndicesType& indices() { return m_indices; } + + protected: + IndicesType m_indices; +}; + +namespace internal { +template +struct traits > : traits > { + typedef TranspositionsStorage StorageKind; +}; +} // namespace internal + +template +class TranspositionsWrapper : public TranspositionsBase > { + typedef internal::traits Traits; + + public: + typedef TranspositionsBase Base; + typedef typename Traits::IndicesType IndicesType; + typedef typename IndicesType::Scalar StorageIndex; + + explicit inline TranspositionsWrapper(IndicesType& indices) : m_indices(indices) {} + + /** Copies the \a other transpositions into \c *this */ + template + TranspositionsWrapper& operator=(const TranspositionsBase& other) { + return Base::operator=(other); + } + + /** const version of indices(). */ + EIGEN_DEVICE_FUNC const IndicesType& indices() const { return m_indices; } + + /** \returns a reference to the stored array representing the transpositions. */ + EIGEN_DEVICE_FUNC IndicesType& indices() { return m_indices; } + + protected: + typename IndicesType::Nested m_indices; +}; + +/** \returns the \a matrix with the \a transpositions applied to the columns. + */ +template +EIGEN_DEVICE_FUNC const Product operator*( + const MatrixBase& matrix, const TranspositionsBase& transpositions) { + return Product(matrix.derived(), transpositions.derived()); +} + +/** \returns the \a matrix with the \a transpositions applied to the rows. + */ +template +EIGEN_DEVICE_FUNC const Product operator*( + const TranspositionsBase& transpositions, const MatrixBase& matrix) { + return Product(transpositions.derived(), matrix.derived()); +} + +// Template partial specialization for transposed/inverse transpositions + +namespace internal { + +template +struct traits > > : traits {}; + +} // end namespace internal + +template +class Transpose > { + typedef TranspositionsDerived TranspositionType; + typedef typename TranspositionType::IndicesType IndicesType; + + public: + explicit Transpose(const TranspositionType& t) : m_transpositions(t) {} + + EIGEN_DEVICE_FUNC constexpr Index size() const noexcept { return m_transpositions.size(); } + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_transpositions.size(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_transpositions.size(); } + + /** \returns the \a matrix with the inverse transpositions applied to the columns. + */ + template + friend const Product operator*(const MatrixBase& matrix, + const Transpose& trt) { + return Product(matrix.derived(), trt); + } + + /** \returns the \a matrix with the inverse transpositions applied to the rows. + */ + template + const Product operator*(const MatrixBase& matrix) const { + return Product(*this, matrix.derived()); + } + + EIGEN_DEVICE_FUNC const TranspositionType& nestedExpression() const { return m_transpositions; } + + protected: + const TranspositionType& m_transpositions; +}; + +} // end namespace Eigen + +#endif // EIGEN_TRANSPOSITIONS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/TriangularMatrix.h b/src/3rdparty/eigen/Eigen/src/Core/TriangularMatrix.h new file mode 100644 index 0000000..27ad78e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/TriangularMatrix.h @@ -0,0 +1,900 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Benoit Jacob +// Copyright (C) 2008-2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_TRIANGULARMATRIX_H +#define EIGEN_TRIANGULARMATRIX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { + +template +struct triangular_solve_retval; + +} + +/** \class TriangularBase + * \ingroup Core_Module + * + * \brief Base class for triangular part in a matrix + */ +template +class TriangularBase : public EigenBase { + public: + enum { + Mode = internal::traits::Mode, + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + MaxRowsAtCompileTime = internal::traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = internal::traits::MaxColsAtCompileTime, + + SizeAtCompileTime = (internal::size_of_xpr_at_compile_time::ret), + /**< This is equal to the number of coefficients, i.e. the number of + * rows times the number of columns, or to \a Dynamic if this is not + * known at compile-time. \sa RowsAtCompileTime, ColsAtCompileTime */ + + MaxSizeAtCompileTime = internal::size_at_compile_time(internal::traits::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime) + + }; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + typedef typename internal::traits::FullMatrixType DenseMatrixType; + typedef DenseMatrixType DenseType; + typedef Derived const& Nested; + + EIGEN_DEVICE_FUNC inline TriangularBase() { + eigen_assert(!((int(Mode) & int(UnitDiag)) && (int(Mode) & int(ZeroDiag)))); + } + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return derived().rows(); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return derived().cols(); } + EIGEN_DEVICE_FUNC constexpr Index outerStride() const noexcept { return derived().outerStride(); } + EIGEN_DEVICE_FUNC constexpr Index innerStride() const noexcept { return derived().innerStride(); } + + // dummy resize function + EIGEN_DEVICE_FUNC void resize(Index rows, Index cols) { + EIGEN_UNUSED_VARIABLE(rows); + EIGEN_UNUSED_VARIABLE(cols); + eigen_assert(rows == this->rows() && cols == this->cols()); + } + + EIGEN_DEVICE_FUNC inline Scalar coeff(Index row, Index col) const { return derived().coeff(row, col); } + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index row, Index col) { return derived().coeffRef(row, col); } + + /** \see MatrixBase::copyCoeff(row,col) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void copyCoeff(Index row, Index col, Other& other) { + derived().coeffRef(row, col) = other.coeff(row, col); + } + + EIGEN_DEVICE_FUNC inline Scalar operator()(Index row, Index col) const { + check_coordinates(row, col); + return coeff(row, col); + } + EIGEN_DEVICE_FUNC inline Scalar& operator()(Index row, Index col) { + check_coordinates(row, col); + return coeffRef(row, col); + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + EIGEN_DEVICE_FUNC inline const Derived& derived() const { return *static_cast(this); } + EIGEN_DEVICE_FUNC inline Derived& derived() { return *static_cast(this); } +#endif // not EIGEN_PARSED_BY_DOXYGEN + + template + EIGEN_DEVICE_FUNC void evalTo(MatrixBase& other) const; + template + EIGEN_DEVICE_FUNC void evalToLazy(MatrixBase& other) const; + + EIGEN_DEVICE_FUNC DenseMatrixType toDenseMatrix() const { + DenseMatrixType res(rows(), cols()); + evalToLazy(res); + return res; + } + + protected: + void check_coordinates(Index row, Index col) const { + EIGEN_ONLY_USED_FOR_DEBUG(row); + EIGEN_ONLY_USED_FOR_DEBUG(col); + eigen_assert(col >= 0 && col < cols() && row >= 0 && row < rows()); + const int mode = int(Mode) & ~SelfAdjoint; + EIGEN_ONLY_USED_FOR_DEBUG(mode); + eigen_assert((mode == Upper && col >= row) || (mode == Lower && col <= row) || + ((mode == StrictlyUpper || mode == UnitUpper) && col > row) || + ((mode == StrictlyLower || mode == UnitLower) && col < row)); + } + +#ifdef EIGEN_INTERNAL_DEBUGGING + void check_coordinates_internal(Index row, Index col) const { check_coordinates(row, col); } +#else + void check_coordinates_internal(Index, Index) const {} +#endif +}; + +/** \class TriangularView + * \ingroup Core_Module + * + * \brief Expression of a triangular part in a matrix + * + * \tparam MatrixType the type of the object in which we are taking the triangular part + * \tparam Mode the kind of triangular matrix expression to construct. Can be #Upper, + * #Lower, #UnitUpper, #UnitLower, #StrictlyUpper, or #StrictlyLower. + * This is in fact a bit field; it must have either #Upper or #Lower, + * and additionally it may have #UnitDiag or #ZeroDiag or neither. + * + * This class represents a triangular part of a matrix, not necessarily square. Strictly speaking, for rectangular + * matrices one should speak of "trapezoid" parts. This class is the return type + * of MatrixBase::triangularView() and SparseMatrixBase::triangularView(), and most of the time this is the only way it + * is used. + * + * \sa MatrixBase::triangularView() + */ +namespace internal { +template +struct traits> : traits { + typedef typename ref_selector::non_const_type MatrixTypeNested; + typedef std::remove_reference_t MatrixTypeNestedNonRef; + typedef remove_all_t MatrixTypeNestedCleaned; + typedef typename MatrixType::PlainObject FullMatrixType; + typedef MatrixType ExpressionType; + enum { + Mode = Mode_, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags = (MatrixTypeNestedCleaned::Flags & (HereditaryBits | FlagsLvalueBit) & + (~(PacketAccessBit | DirectAccessBit | LinearAccessBit))) + }; +}; +} // namespace internal + +template +class TriangularViewImpl; + +template +class TriangularView + : public TriangularViewImpl::StorageKind> { + public: + typedef TriangularViewImpl::StorageKind> Base; + typedef typename internal::traits::Scalar Scalar; + typedef MatrixType_ MatrixType; + + protected: + typedef typename internal::traits::MatrixTypeNested MatrixTypeNested; + typedef typename internal::traits::MatrixTypeNestedNonRef MatrixTypeNestedNonRef; + + typedef internal::remove_all_t MatrixConjugateReturnType; + typedef TriangularView, Mode_> ConstTriangularView; + + public: + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::MatrixTypeNestedCleaned NestedExpression; + + enum { + Mode = Mode_, + Flags = internal::traits::Flags, + TransposeMode = (int(Mode) & int(Upper) ? Lower : 0) | (int(Mode) & int(Lower) ? Upper : 0) | + (int(Mode) & int(UnitDiag)) | (int(Mode) & int(ZeroDiag)), + IsVectorAtCompileTime = false + }; + + EIGEN_DEVICE_FUNC explicit inline TriangularView(MatrixType& matrix) : m_matrix(matrix) {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(TriangularView) + + /** \copydoc EigenBase::rows() */ + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return m_matrix.rows(); } + /** \copydoc EigenBase::cols() */ + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return m_matrix.cols(); } + + /** \returns a const reference to the nested expression */ + EIGEN_DEVICE_FUNC const NestedExpression& nestedExpression() const { return m_matrix; } + + /** \returns a reference to the nested expression */ + EIGEN_DEVICE_FUNC NestedExpression& nestedExpression() { return m_matrix; } + + typedef TriangularView ConjugateReturnType; + /** \sa MatrixBase::conjugate() const */ + EIGEN_DEVICE_FUNC inline const ConjugateReturnType conjugate() const { + return ConjugateReturnType(m_matrix.conjugate()); + } + + /** \returns an expression of the complex conjugate of \c *this if Cond==true, + * returns \c *this otherwise. + */ + template + EIGEN_DEVICE_FUNC inline std::conditional_t conjugateIf() const { + typedef std::conditional_t ReturnType; + return ReturnType(m_matrix.template conjugateIf()); + } + + typedef TriangularView AdjointReturnType; + /** \sa MatrixBase::adjoint() const */ + EIGEN_DEVICE_FUNC inline const AdjointReturnType adjoint() const { return AdjointReturnType(m_matrix.adjoint()); } + + typedef TriangularView TransposeReturnType; + /** \sa MatrixBase::transpose() */ + template + EIGEN_DEVICE_FUNC inline TransposeReturnType transpose( + std::enable_if_t::value, Dummy*> = nullptr) { + typename MatrixType::TransposeReturnType tmp(m_matrix); + return TransposeReturnType(tmp); + } + + typedef TriangularView ConstTransposeReturnType; + /** \sa MatrixBase::transpose() const */ + EIGEN_DEVICE_FUNC inline const ConstTransposeReturnType transpose() const { + return ConstTransposeReturnType(m_matrix.transpose()); + } + + template + EIGEN_DEVICE_FUNC inline const Solve solve(const MatrixBase& other) const { + return Solve(*this, other.derived()); + } + +// workaround MSVC ICE +#if EIGEN_COMP_MSVC + template + EIGEN_DEVICE_FUNC inline const internal::triangular_solve_retval solve( + const MatrixBase& other) const { + return Base::template solve(other); + } +#else + using Base::solve; +#endif + + /** \returns a selfadjoint view of the referenced triangular part which must be either \c #Upper or \c #Lower. + * + * This is a shortcut for \code this->nestedExpression().selfadjointView<(*this)::Mode>() \endcode + * \sa MatrixBase::selfadjointView() */ + EIGEN_DEVICE_FUNC SelfAdjointView selfadjointView() { + EIGEN_STATIC_ASSERT((Mode & (UnitDiag | ZeroDiag)) == 0, PROGRAMMING_ERROR); + return SelfAdjointView(m_matrix); + } + + /** This is the const version of selfadjointView() */ + EIGEN_DEVICE_FUNC const SelfAdjointView selfadjointView() const { + EIGEN_STATIC_ASSERT((Mode & (UnitDiag | ZeroDiag)) == 0, PROGRAMMING_ERROR); + return SelfAdjointView(m_matrix); + } + + /** \returns the determinant of the triangular matrix + * \sa MatrixBase::determinant() */ + EIGEN_DEVICE_FUNC Scalar determinant() const { + if (Mode & UnitDiag) + return 1; + else if (Mode & ZeroDiag) + return 0; + else + return m_matrix.diagonal().prod(); + } + + protected: + MatrixTypeNested m_matrix; +}; + +/** \ingroup Core_Module + * + * \brief Base class for a triangular part in a \b dense matrix + * + * This class is an abstract base class of class TriangularView, and objects of type TriangularViewImpl cannot be + * instantiated. It extends class TriangularView with additional methods which available for dense expressions only. + * + * \sa class TriangularView, MatrixBase::triangularView() + */ +template +class TriangularViewImpl : public TriangularBase> { + public: + typedef TriangularView TriangularViewType; + + typedef TriangularBase Base; + typedef typename internal::traits::Scalar Scalar; + + typedef MatrixType_ MatrixType; + typedef typename MatrixType::PlainObject DenseMatrixType; + typedef DenseMatrixType PlainObject; + + public: + using Base::derived; + using Base::evalToLazy; + + typedef typename internal::traits::StorageKind StorageKind; + + enum { Mode = Mode_, Flags = internal::traits::Flags }; + + /** \returns the outer-stride of the underlying dense matrix + * \sa DenseCoeffsBase::outerStride() */ + EIGEN_DEVICE_FUNC inline Index outerStride() const { return derived().nestedExpression().outerStride(); } + /** \returns the inner-stride of the underlying dense matrix + * \sa DenseCoeffsBase::innerStride() */ + EIGEN_DEVICE_FUNC inline Index innerStride() const { return derived().nestedExpression().innerStride(); } + + /** \sa MatrixBase::operator+=() */ + template + EIGEN_DEVICE_FUNC TriangularViewType& operator+=(const DenseBase& other) { + internal::call_assignment_no_alias(derived(), other.derived(), + internal::add_assign_op()); + return derived(); + } + /** \sa MatrixBase::operator-=() */ + template + EIGEN_DEVICE_FUNC TriangularViewType& operator-=(const DenseBase& other) { + internal::call_assignment_no_alias(derived(), other.derived(), + internal::sub_assign_op()); + return derived(); + } + + /** \sa MatrixBase::operator*=() */ + EIGEN_DEVICE_FUNC TriangularViewType& operator*=(const typename internal::traits::Scalar& other) { + return *this = derived().nestedExpression() * other; + } + /** \sa DenseBase::operator/=() */ + EIGEN_DEVICE_FUNC TriangularViewType& operator/=(const typename internal::traits::Scalar& other) { + return *this = derived().nestedExpression() / other; + } + + /** \sa MatrixBase::fill() */ + EIGEN_DEVICE_FUNC void fill(const Scalar& value) { setConstant(value); } + /** \sa MatrixBase::setConstant() */ + EIGEN_DEVICE_FUNC TriangularViewType& setConstant(const Scalar& value) { + return *this = MatrixType::Constant(derived().rows(), derived().cols(), value); + } + /** \sa MatrixBase::setZero() */ + EIGEN_DEVICE_FUNC TriangularViewType& setZero() { return setConstant(Scalar(0)); } + /** \sa MatrixBase::setOnes() */ + EIGEN_DEVICE_FUNC TriangularViewType& setOnes() { return setConstant(Scalar(1)); } + + /** \sa MatrixBase::coeff() + * \warning the coordinates must fit into the referenced triangular part + */ + EIGEN_DEVICE_FUNC inline Scalar coeff(Index row, Index col) const { + Base::check_coordinates_internal(row, col); + return derived().nestedExpression().coeff(row, col); + } + + /** \sa MatrixBase::coeffRef() + * \warning the coordinates must fit into the referenced triangular part + */ + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index row, Index col) { + EIGEN_STATIC_ASSERT_LVALUE(TriangularViewType); + Base::check_coordinates_internal(row, col); + return derived().nestedExpression().coeffRef(row, col); + } + + /** Assigns a triangular matrix to a triangular part of a dense matrix */ + template + EIGEN_DEVICE_FUNC TriangularViewType& operator=(const TriangularBase& other); + + /** Shortcut for\code *this = other.other.triangularView<(*this)::Mode>() \endcode */ + template + EIGEN_DEVICE_FUNC TriangularViewType& operator=(const MatrixBase& other); + +#ifndef EIGEN_PARSED_BY_DOXYGEN + EIGEN_DEVICE_FUNC TriangularViewType& operator=(const TriangularViewImpl& other) { + return *this = other.derived().nestedExpression(); + } + + template + /** \deprecated */ + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC void lazyAssign(const TriangularBase& other); + + template + /** \deprecated */ + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC void lazyAssign(const MatrixBase& other); +#endif + + /** Efficient triangular matrix times vector/matrix product */ + template + EIGEN_DEVICE_FUNC const Product operator*( + const MatrixBase& rhs) const { + return Product(derived(), rhs.derived()); + } + + /** Efficient vector/matrix times triangular matrix product */ + template + friend EIGEN_DEVICE_FUNC const Product operator*( + const MatrixBase& lhs, const TriangularViewImpl& rhs) { + return Product(lhs.derived(), rhs.derived()); + } + + /** \returns the product of the inverse of \c *this with \a other, \a *this being triangular. + * + * This function computes the inverse-matrix matrix product inverse(\c *this) * \a other if + * \a Side==OnTheLeft (the default), or the right-inverse-multiply \a other * inverse(\c *this) if + * \a Side==OnTheRight. + * + * Note that the template parameter \c Side can be omitted, in which case \c Side==OnTheLeft + * + * The matrix \c *this must be triangular and invertible (i.e., all the coefficients of the + * diagonal must be non zero). It works as a forward (resp. backward) substitution if \c *this + * is an upper (resp. lower) triangular matrix. + * + * Example: \include Triangular_solve.cpp + * Output: \verbinclude Triangular_solve.out + * + * This function returns an expression of the inverse-multiply and can works in-place if it is assigned + * to the same matrix or vector \a other. + * + * For users coming from BLAS, this function (and more specifically solveInPlace()) offer + * all the operations supported by the \c *TRSV and \c *TRSM BLAS routines. + * + * \sa TriangularView::solveInPlace() + */ + template + inline const internal::triangular_solve_retval solve( + const MatrixBase& other) const; + + /** "in-place" version of TriangularView::solve() where the result is written in \a other + * + * \warning The parameter is only marked 'const' to make the C++ compiler accept a temporary expression here. + * This function will const_cast it, so constness isn't honored here. + * + * Note that the template parameter \c Side can be omitted, in which case \c Side==OnTheLeft + * + * See TriangularView:solve() for the details. + */ + template + EIGEN_DEVICE_FUNC void solveInPlace(const MatrixBase& other) const; + + template + EIGEN_DEVICE_FUNC void solveInPlace(const MatrixBase& other) const { + return solveInPlace(other); + } + + /** Swaps the coefficients of the common triangular parts of two matrices */ + template + EIGEN_DEVICE_FUNC +#ifdef EIGEN_PARSED_BY_DOXYGEN + void + swap(TriangularBase& other) +#else + void + swap(TriangularBase const& other) +#endif + { + EIGEN_STATIC_ASSERT_LVALUE(OtherDerived); + call_assignment(derived(), other.const_cast_derived(), internal::swap_assign_op()); + } + + /** Shortcut for \code (*this).swap(other.triangularView<(*this)::Mode>()) \endcode */ + template + /** \deprecated */ + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC void swap(MatrixBase const& other) { + EIGEN_STATIC_ASSERT_LVALUE(OtherDerived); + call_assignment(derived(), other.const_cast_derived(), internal::swap_assign_op()); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void _solve_impl(const RhsType& rhs, DstType& dst) const { + if (!internal::is_same_dense(dst, rhs)) dst = rhs; + this->solveInPlace(dst); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TriangularViewType& _assignProduct(const ProductType& prod, const Scalar& alpha, + bool beta); + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(TriangularViewImpl) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(TriangularViewImpl) +}; + +/*************************************************************************** + * Implementation of triangular evaluation/assignment + ***************************************************************************/ + +#ifndef EIGEN_PARSED_BY_DOXYGEN +// FIXME should we keep that possibility +template +template +EIGEN_DEVICE_FUNC inline TriangularView& TriangularViewImpl::operator=( + const MatrixBase& other) { + internal::call_assignment_no_alias(derived(), other.derived(), + internal::assign_op()); + return derived(); +} + +// FIXME should we keep that possibility +template +template +EIGEN_DEVICE_FUNC void TriangularViewImpl::lazyAssign(const MatrixBase& other) { + internal::call_assignment_no_alias(derived(), other.template triangularView()); +} + +template +template +EIGEN_DEVICE_FUNC inline TriangularView& TriangularViewImpl::operator=( + const TriangularBase& other) { + eigen_assert(Mode == int(OtherDerived::Mode)); + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC void TriangularViewImpl::lazyAssign( + const TriangularBase& other) { + eigen_assert(Mode == int(OtherDerived::Mode)); + internal::call_assignment_no_alias(derived(), other.derived()); +} +#endif + +/*************************************************************************** + * Implementation of TriangularBase methods + ***************************************************************************/ + +/** Assigns a triangular or selfadjoint matrix to a dense matrix. + * If the matrix is triangular, the opposite part is set to zero. */ +template +template +EIGEN_DEVICE_FUNC void TriangularBase::evalTo(MatrixBase& other) const { + evalToLazy(other.derived()); +} + +/*************************************************************************** + * Implementation of TriangularView methods + ***************************************************************************/ + +/*************************************************************************** + * Implementation of MatrixBase methods + ***************************************************************************/ + +/** + * \returns an expression of a triangular view extracted from the current matrix + * + * The parameter \a Mode can have the following values: \c #Upper, \c #StrictlyUpper, \c #UnitUpper, + * \c #Lower, \c #StrictlyLower, \c #UnitLower. + * + * Example: \include MatrixBase_triangularView.cpp + * Output: \verbinclude MatrixBase_triangularView.out + * + * \sa class TriangularView + */ +template +template +EIGEN_DEVICE_FUNC typename MatrixBase::template TriangularViewReturnType::Type +MatrixBase::triangularView() { + return typename TriangularViewReturnType::Type(derived()); +} + +/** This is the const version of MatrixBase::triangularView() */ +template +template +EIGEN_DEVICE_FUNC typename MatrixBase::template ConstTriangularViewReturnType::Type +MatrixBase::triangularView() const { + return typename ConstTriangularViewReturnType::Type(derived()); +} + +/** \returns true if *this is approximately equal to an upper triangular matrix, + * within the precision given by \a prec. + * + * \sa isLowerTriangular() + */ +template +bool MatrixBase::isUpperTriangular(const RealScalar& prec) const { + RealScalar maxAbsOnUpperPart = static_cast(-1); + for (Index j = 0; j < cols(); ++j) { + Index maxi = numext::mini(j, rows() - 1); + for (Index i = 0; i <= maxi; ++i) { + RealScalar absValue = numext::abs(coeff(i, j)); + if (absValue > maxAbsOnUpperPart) maxAbsOnUpperPart = absValue; + } + } + RealScalar threshold = maxAbsOnUpperPart * prec; + for (Index j = 0; j < cols(); ++j) + for (Index i = j + 1; i < rows(); ++i) + if (numext::abs(coeff(i, j)) > threshold) return false; + return true; +} + +/** \returns true if *this is approximately equal to a lower triangular matrix, + * within the precision given by \a prec. + * + * \sa isUpperTriangular() + */ +template +bool MatrixBase::isLowerTriangular(const RealScalar& prec) const { + RealScalar maxAbsOnLowerPart = static_cast(-1); + for (Index j = 0; j < cols(); ++j) + for (Index i = j; i < rows(); ++i) { + RealScalar absValue = numext::abs(coeff(i, j)); + if (absValue > maxAbsOnLowerPart) maxAbsOnLowerPart = absValue; + } + RealScalar threshold = maxAbsOnLowerPart * prec; + for (Index j = 1; j < cols(); ++j) { + Index maxi = numext::mini(j, rows() - 1); + for (Index i = 0; i < maxi; ++i) + if (numext::abs(coeff(i, j)) > threshold) return false; + } + return true; +} + +/*************************************************************************** +**************************************************************************** +* Evaluators and Assignment of triangular expressions +*************************************************************************** +***************************************************************************/ + +namespace internal { + +// TODO currently a triangular expression has the form TriangularView<.,.> +// in the future triangular-ness should be defined by the expression traits +// such that Transpose > is valid. (currently TriangularBase::transpose() is overloaded to make +// it work) +template +struct evaluator_traits> { + typedef typename storage_kind_to_evaluator_kind::Kind Kind; + typedef typename glue_shapes::Shape, TriangularShape>::type Shape; +}; + +template +struct unary_evaluator, IndexBased> : evaluator> { + typedef TriangularView XprType; + typedef evaluator> Base; + EIGEN_DEVICE_FUNC unary_evaluator(const XprType& xpr) : Base(xpr.nestedExpression()) {} +}; + +// Additional assignment kinds: +struct Triangular2Triangular {}; +struct Triangular2Dense {}; +struct Dense2Triangular {}; + +template +struct triangular_assignment_loop; + +/** \internal Specialization of the dense assignment kernel for triangular matrices. + * The main difference is that the triangular, diagonal, and opposite parts are processed through three different + * functions. \tparam UpLo must be either Lower or Upper \tparam Mode must be either 0, UnitDiag, ZeroDiag, or + * SelfAdjoint + */ +template +class triangular_dense_assignment_kernel + : public generic_dense_assignment_kernel { + protected: + typedef generic_dense_assignment_kernel Base; + typedef typename Base::DstXprType DstXprType; + typedef typename Base::SrcXprType SrcXprType; + using Base::m_dst; + using Base::m_functor; + using Base::m_src; + + public: + typedef typename Base::DstEvaluatorType DstEvaluatorType; + typedef typename Base::SrcEvaluatorType SrcEvaluatorType; + typedef typename Base::Scalar Scalar; + typedef typename Base::AssignmentTraits AssignmentTraits; + + EIGEN_DEVICE_FUNC triangular_dense_assignment_kernel(DstEvaluatorType& dst, const SrcEvaluatorType& src, + const Functor& func, DstXprType& dstExpr) + : Base(dst, src, func, dstExpr) {} + +#ifdef EIGEN_INTERNAL_DEBUGGING + EIGEN_DEVICE_FUNC void assignCoeff(Index row, Index col) { + eigen_internal_assert(row != col); + Base::assignCoeff(row, col); + } +#else + using Base::assignCoeff; +#endif + + EIGEN_DEVICE_FUNC void assignDiagonalCoeff(Index id) { + if (Mode == UnitDiag && SetOpposite) + m_functor.assignCoeff(m_dst.coeffRef(id, id), Scalar(1)); + else if (Mode == ZeroDiag && SetOpposite) + m_functor.assignCoeff(m_dst.coeffRef(id, id), Scalar(0)); + else if (Mode == 0) + Base::assignCoeff(id, id); + } + + EIGEN_DEVICE_FUNC void assignOppositeCoeff(Index row, Index col) { + eigen_internal_assert(row != col); + if (SetOpposite) m_functor.assignCoeff(m_dst.coeffRef(row, col), Scalar(0)); + } +}; + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_triangular_assignment_loop(DstXprType& dst, const SrcXprType& src, + const Functor& func) { + typedef evaluator DstEvaluatorType; + typedef evaluator SrcEvaluatorType; + + SrcEvaluatorType srcEvaluator(src); + + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + DstEvaluatorType dstEvaluator(dst); + + typedef triangular_dense_assignment_kernel + Kernel; + Kernel kernel(dstEvaluator, srcEvaluator, func, dst.const_cast_derived()); + + enum { + unroll = DstXprType::SizeAtCompileTime != Dynamic && SrcEvaluatorType::CoeffReadCost < HugeCost && + DstXprType::SizeAtCompileTime * + (int(DstEvaluatorType::CoeffReadCost) + int(SrcEvaluatorType::CoeffReadCost)) / 2 <= + EIGEN_UNROLLING_LIMIT + }; + + triangular_assignment_loop::run( + kernel); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_triangular_assignment_loop(DstXprType& dst, const SrcXprType& src) { + call_triangular_assignment_loop( + dst, src, internal::assign_op()); +} + +template <> +struct AssignmentKind { + typedef Triangular2Triangular Kind; +}; +template <> +struct AssignmentKind { + typedef Triangular2Dense Kind; +}; +template <> +struct AssignmentKind { + typedef Dense2Triangular Kind; +}; + +template +struct Assignment { + EIGEN_DEVICE_FUNC static void run(DstXprType& dst, const SrcXprType& src, const Functor& func) { + eigen_assert(int(DstXprType::Mode) == int(SrcXprType::Mode)); + + call_triangular_assignment_loop(dst, src, func); + } +}; + +template +struct Assignment { + EIGEN_DEVICE_FUNC static void run(DstXprType& dst, const SrcXprType& src, const Functor& func) { + call_triangular_assignment_loop(dst, src, func); + } +}; + +template +struct Assignment { + EIGEN_DEVICE_FUNC static void run(DstXprType& dst, const SrcXprType& src, const Functor& func) { + call_triangular_assignment_loop(dst, src, func); + } +}; + +template +struct triangular_assignment_loop { + // FIXME: this is not very clean, perhaps this information should be provided by the kernel? + typedef typename Kernel::DstEvaluatorType DstEvaluatorType; + typedef typename DstEvaluatorType::XprType DstXprType; + + enum { + col = (UnrollCount - 1) / DstXprType::RowsAtCompileTime, + row = (UnrollCount - 1) % DstXprType::RowsAtCompileTime + }; + + typedef typename Kernel::Scalar Scalar; + + EIGEN_DEVICE_FUNC static inline void run(Kernel& kernel) { + triangular_assignment_loop::run(kernel); + + if (row == col) + kernel.assignDiagonalCoeff(row); + else if (((Mode & Lower) && row > col) || ((Mode & Upper) && row < col)) + kernel.assignCoeff(row, col); + else if (SetOpposite) + kernel.assignOppositeCoeff(row, col); + } +}; + +// prevent buggy user code from causing an infinite recursion +template +struct triangular_assignment_loop { + EIGEN_DEVICE_FUNC static inline void run(Kernel&) {} +}; + +// TODO: experiment with a recursive assignment procedure splitting the current +// triangular part into one rectangular and two triangular parts. + +template +struct triangular_assignment_loop { + typedef typename Kernel::Scalar Scalar; + EIGEN_DEVICE_FUNC static inline void run(Kernel& kernel) { + for (Index j = 0; j < kernel.cols(); ++j) { + Index maxi = numext::mini(j, kernel.rows()); + Index i = 0; + if (((Mode & Lower) && SetOpposite) || (Mode & Upper)) { + for (; i < maxi; ++i) + if (Mode & Upper) + kernel.assignCoeff(i, j); + else + kernel.assignOppositeCoeff(i, j); + } else + i = maxi; + + if (i < kernel.rows()) // then i==j + kernel.assignDiagonalCoeff(i++); + + if (((Mode & Upper) && SetOpposite) || (Mode & Lower)) { + for (; i < kernel.rows(); ++i) + if (Mode & Lower) + kernel.assignCoeff(i, j); + else + kernel.assignOppositeCoeff(i, j); + } + } + } +}; + +} // end namespace internal + +/** Assigns a triangular or selfadjoint matrix to a dense matrix. + * If the matrix is triangular, the opposite part is set to zero. */ +template +template +EIGEN_DEVICE_FUNC void TriangularBase::evalToLazy(MatrixBase& other) const { + other.derived().resize(this->rows(), this->cols()); + internal::call_triangular_assignment_loop( + other.derived(), derived().nestedExpression()); +} + +namespace internal { + +// Triangular = Product +template +struct Assignment, + internal::assign_op::Scalar>, Dense2Triangular> { + typedef Product SrcXprType; + static void run(DstXprType& dst, const SrcXprType& src, + const internal::assign_op&) { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if ((dst.rows() != dstRows) || (dst.cols() != dstCols)) dst.resize(dstRows, dstCols); + + dst._assignProduct(src, Scalar(1), false); + } +}; + +// Triangular += Product +template +struct Assignment, + internal::add_assign_op::Scalar>, + Dense2Triangular> { + typedef Product SrcXprType; + static void run(DstXprType& dst, const SrcXprType& src, + const internal::add_assign_op&) { + dst._assignProduct(src, Scalar(1), true); + } +}; + +// Triangular -= Product +template +struct Assignment, + internal::sub_assign_op::Scalar>, + Dense2Triangular> { + typedef Product SrcXprType; + static void run(DstXprType& dst, const SrcXprType& src, + const internal::sub_assign_op&) { + dst._assignProduct(src, Scalar(-1), true); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_TRIANGULARMATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/VectorBlock.h b/src/3rdparty/eigen/Eigen/src/Core/VectorBlock.h new file mode 100644 index 0000000..5ac13eb --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/VectorBlock.h @@ -0,0 +1,83 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_VECTORBLOCK_H +#define EIGEN_VECTORBLOCK_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +namespace internal { +template +struct traits > + : public traits::Flags & RowMajorBit ? 1 : Size, + traits::Flags & RowMajorBit ? Size : 1> > {}; +} // namespace internal + +/** \class VectorBlock + * \ingroup Core_Module + * + * \brief Expression of a fixed-size or dynamic-size sub-vector + * + * \tparam VectorType the type of the object in which we are taking a sub-vector + * \tparam Size size of the sub-vector we are taking at compile time (optional) + * + * This class represents an expression of either a fixed-size or dynamic-size sub-vector. + * It is the return type of DenseBase::segment(Index,Index) and DenseBase::segment(Index) and + * most of the time this is the only way it is used. + * + * However, if you want to directly manipulate sub-vector expressions, + * for instance if you want to write a function returning such an expression, you + * will need to use this class. + * + * Here is an example illustrating the dynamic case: + * \include class_VectorBlock.cpp + * Output: \verbinclude class_VectorBlock.out + * + * \note Even though this expression has dynamic size, in the case where \a VectorType + * has fixed size, this expression inherits a fixed maximal size which means that evaluating + * it does not cause a dynamic memory allocation. + * + * Here is an example illustrating the fixed-size case: + * \include class_FixedVectorBlock.cpp + * Output: \verbinclude class_FixedVectorBlock.out + * + * \sa class Block, DenseBase::segment(Index,Index,Index,Index), DenseBase::segment(Index,Index) + */ +template +class VectorBlock : public Block::Flags & RowMajorBit ? 1 : Size, + internal::traits::Flags & RowMajorBit ? Size : 1> { + typedef Block::Flags & RowMajorBit ? 1 : Size, + internal::traits::Flags & RowMajorBit ? Size : 1> + Base; + enum { IsColVector = !(internal::traits::Flags & RowMajorBit) }; + + public: + EIGEN_DENSE_PUBLIC_INTERFACE(VectorBlock) + EIGEN_STATIC_ASSERT_VECTOR_ONLY(VectorBlock) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(VectorBlock) + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE VectorBlock(VectorType& vector, Index start, Index size) + : Base(vector, IsColVector ? start : 0, IsColVector ? 0 : start, IsColVector ? size : 1, IsColVector ? 1 : size) { + } + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE VectorBlock(VectorType& vector, Index start) + : Base(vector, IsColVector ? start : 0, IsColVector ? 0 : start) {} +}; + +} // end namespace Eigen + +#endif // EIGEN_VECTORBLOCK_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/VectorwiseOp.h b/src/3rdparty/eigen/Eigen/src/Core/VectorwiseOp.h new file mode 100644 index 0000000..688b49b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/VectorwiseOp.h @@ -0,0 +1,733 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2019 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PARTIAL_REDUX_H +#define EIGEN_PARTIAL_REDUX_H + +// IWYU pragma: private +#include "./InternalHeaderCheck.h" + +namespace Eigen { + +/** \class PartialReduxExpr + * \ingroup Core_Module + * + * \brief Generic expression of a partially reduxed matrix + * + * \tparam MatrixType the type of the matrix we are applying the redux operation + * \tparam MemberOp type of the member functor + * \tparam Direction indicates the direction of the redux (#Vertical or #Horizontal) + * + * This class represents an expression of a partial redux operator of a matrix. + * It is the return type of some VectorwiseOp functions, + * and most of the time this is the only way it is used. + * + * \sa class VectorwiseOp + */ + +template +class PartialReduxExpr; + +namespace internal { + +template +struct traits > : traits { + typedef typename MemberOp::result_type Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename MatrixType::Scalar InputScalar; + enum { + RowsAtCompileTime = Direction == Vertical ? 1 : MatrixType::RowsAtCompileTime, + ColsAtCompileTime = Direction == Horizontal ? 1 : MatrixType::ColsAtCompileTime, + MaxRowsAtCompileTime = Direction == Vertical ? 1 : MatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = Direction == Horizontal ? 1 : MatrixType::MaxColsAtCompileTime, + Flags = RowsAtCompileTime == 1 ? RowMajorBit : 0, + TraversalSize = Direction == Vertical ? MatrixType::RowsAtCompileTime : MatrixType::ColsAtCompileTime + }; +}; +} // namespace internal + +template +class PartialReduxExpr : public internal::dense_xpr_base >::type, + internal::no_assignment_operator { + public: + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(PartialReduxExpr) + + EIGEN_DEVICE_FUNC explicit PartialReduxExpr(const MatrixType& mat, const MemberOp& func = MemberOp()) + : m_matrix(mat), m_functor(func) {} + + EIGEN_DEVICE_FUNC constexpr Index rows() const noexcept { return (Direction == Vertical ? 1 : m_matrix.rows()); } + EIGEN_DEVICE_FUNC constexpr Index cols() const noexcept { return (Direction == Horizontal ? 1 : m_matrix.cols()); } + + EIGEN_DEVICE_FUNC typename MatrixType::Nested nestedExpression() const { return m_matrix; } + + EIGEN_DEVICE_FUNC const MemberOp& functor() const { return m_functor; } + + protected: + typename MatrixType::Nested m_matrix; + const MemberOp m_functor; +}; + +template +struct partial_redux_dummy_func; + +#define EIGEN_MAKE_PARTIAL_REDUX_FUNCTOR(MEMBER, COST, VECTORIZABLE, BINARYOP) \ + template \ + struct member_##MEMBER { \ + typedef ResultType result_type; \ + typedef BINARYOP BinaryOp; \ + template \ + struct Cost { \ + enum { value = COST }; \ + }; \ + enum { Vectorizable = VECTORIZABLE }; \ + template \ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ResultType operator()(const XprType& mat) const { \ + return mat.MEMBER(); \ + } \ + BinaryOp binaryFunc() const { return BinaryOp(); } \ + } + +#define EIGEN_MEMBER_FUNCTOR(MEMBER, COST) EIGEN_MAKE_PARTIAL_REDUX_FUNCTOR(MEMBER, COST, 0, partial_redux_dummy_func) + +namespace internal { + +EIGEN_MEMBER_FUNCTOR(norm, (Size + 5) * NumTraits::MulCost + (Size - 1) * NumTraits::AddCost); +EIGEN_MEMBER_FUNCTOR(stableNorm, (Size + 5) * NumTraits::MulCost + (Size - 1) * NumTraits::AddCost); +EIGEN_MEMBER_FUNCTOR(blueNorm, (Size + 5) * NumTraits::MulCost + (Size - 1) * NumTraits::AddCost); +EIGEN_MEMBER_FUNCTOR(hypotNorm, (Size - 1) * functor_traits >::Cost); +EIGEN_MEMBER_FUNCTOR(all, (Size - 1) * NumTraits::AddCost); +EIGEN_MEMBER_FUNCTOR(any, (Size - 1) * NumTraits::AddCost); +EIGEN_MEMBER_FUNCTOR(count, (Size - 1) * NumTraits::AddCost); + +EIGEN_MAKE_PARTIAL_REDUX_FUNCTOR(sum, (Size - 1) * NumTraits::AddCost, 1, internal::scalar_sum_op); +EIGEN_MAKE_PARTIAL_REDUX_FUNCTOR(minCoeff, (Size - 1) * NumTraits::AddCost, 1, internal::scalar_min_op); +EIGEN_MAKE_PARTIAL_REDUX_FUNCTOR(maxCoeff, (Size - 1) * NumTraits::AddCost, 1, internal::scalar_max_op); +EIGEN_MAKE_PARTIAL_REDUX_FUNCTOR(prod, (Size - 1) * NumTraits::MulCost, 1, internal::scalar_product_op); + +template +struct member_lpnorm { + typedef ResultType result_type; + enum { Vectorizable = 0 }; + template + struct Cost { + enum { value = (Size + 5) * NumTraits::MulCost + (Size - 1) * NumTraits::AddCost }; + }; + EIGEN_DEVICE_FUNC member_lpnorm() {} + template + EIGEN_DEVICE_FUNC inline ResultType operator()(const XprType& mat) const { + return mat.template lpNorm

(); + } +}; + +template +struct member_redux { + typedef BinaryOpT BinaryOp; + typedef typename result_of::type result_type; + + enum { Vectorizable = functor_traits::PacketAccess }; + template + struct Cost { + enum { value = (Size - 1) * functor_traits::Cost }; + }; + EIGEN_DEVICE_FUNC explicit member_redux(const BinaryOp func) : m_functor(func) {} + template + EIGEN_DEVICE_FUNC inline result_type operator()(const DenseBase& mat) const { + return mat.redux(m_functor); + } + const BinaryOp& binaryFunc() const { return m_functor; } + const BinaryOp m_functor; +}; + +template +struct scalar_replace_zero_with_one_op { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const Scalar& x) const { + return numext::is_exactly_zero(x) ? Scalar(1) : x; + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet packetOp(const Packet& x) const { + return pselect(pcmp_eq(x, pzero(x)), pset1(Scalar(1)), x); + } +}; +template +struct functor_traits> { + enum { Cost = 1, PacketAccess = packet_traits::HasCmp }; +}; + +} // namespace internal + +/** \class VectorwiseOp + * \ingroup Core_Module + * + * \brief Pseudo expression providing broadcasting and partial reduction operations + * + * \tparam ExpressionType the type of the object on which to do partial reductions + * \tparam Direction indicates whether to operate on columns (#Vertical) or rows (#Horizontal) + * + * This class represents a pseudo expression with broadcasting and partial reduction features. + * It is the return type of DenseBase::colwise() and DenseBase::rowwise() + * and most of the time this is the only way it is explicitly used. + * + * To understand the logic of rowwise/colwise expression, let's consider a generic case `A.colwise().foo()` + * where `foo` is any method of `VectorwiseOp`. This expression is equivalent to applying `foo()` to each + * column of `A` and then re-assemble the outputs in a matrix expression: + * \code [A.col(0).foo(), A.col(1).foo(), ..., A.col(A.cols()-1).foo()] \endcode + * + * Example: \include MatrixBase_colwise.cpp + * Output: \verbinclude MatrixBase_colwise.out + * + * The begin() and end() methods are obviously exceptions to the previous rule as they + * return STL-compatible begin/end iterators to the rows or columns of the nested expression. + * Typical use cases include for-range-loop and calls to STL algorithms: + * + * Example: \include MatrixBase_colwise_iterator_cxx11.cpp + * Output: \verbinclude MatrixBase_colwise_iterator_cxx11.out + * + * For a partial reduction on an empty input, some rules apply. + * For the sake of clarity, let's consider a vertical reduction: + * - If the number of columns is zero, then a 1x0 row-major vector expression is returned. + * - Otherwise, if the number of rows is zero, then + * - a row vector of zeros is returned for sum-like reductions (sum, squaredNorm, norm, etc.) + * - a row vector of ones is returned for a product reduction (e.g., MatrixXd(n,0).colwise().prod()) + * - an assert is triggered for all other reductions (minCoeff,maxCoeff,redux(bin_op)) + * + * \sa DenseBase::colwise(), DenseBase::rowwise(), class PartialReduxExpr + */ +template +class VectorwiseOp { + public: + typedef typename ExpressionType::Scalar Scalar; + typedef typename ExpressionType::RealScalar RealScalar; + typedef internal::remove_all_t ExpressionTypeCleaned; + + template

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 ARsaA1 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/recorder/doc/images/qmlrecorder.jpg b/examples/multimedia/video/recorder/doc/images/qmlrecorder.jpg new file mode 100644 index 0000000000000000000000000000000000000000..1ef0e4447ad5133b35698bc27a27e12888f6edc2 GIT binary patch literal 95965 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�s^Ve_UC|8I;^Ax{e| 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/recorder/doc/src/recorder.qdoc b/examples/multimedia/video/recorder/doc/src/recorder.qdoc new file mode 100644 index 0000000..cf048d9 --- /dev/null +++ b/examples/multimedia/video/recorder/doc/src/recorder.qdoc @@ -0,0 +1,105 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example video/recorder + \title QML Video Recorder + \ingroup multimedia_examples + \ingroup video_examples_qml + \ingroup camera_examples_qml + \examplecategory {Multimedia} + \brief Recording audio and video using Qt Quick. + \meta {tag} {quick} + + \image qmlrecorder.jpg + {Media recorder interface with live preview and recording controls} + + \e{QML Recorder} demonstrates a simple application that can record + audio and video separate or together, using a microphone, a camera, or + with screen capturing. + + \include examples-run.qdocinc + + \section1 Overview + At its core, this is a QML application, see + \l{Getting started with Qt Quick applications}. This documentation is + focused on how this example uses the \l{Qt Multimedia QML Types}. + + \image qml-recorder-overview.gif + {Animation cycling through QML objects declared in Main.qml} + + The example uses the QML \l Camera and \l AudioInput types connected to a + \l CaptureSession. A \l MediaRecorder object is then used to record the + captured audio and video. + + In addition to QtMultimedia, features of Qt Quick Windows, Controls, and + Layouts are used to implement the graphic user interface and functionality. + Playback won't be covered here, for that see the \l{QML Media Player Example}. + + The example demonstrates the following: + \list + \li Input devices can be selected. + \li An input type switched off. + \li Settings for capturing such as quality, codec choice, file format, + and assigning metadata. + \li Captured files are stored and can be played back. + \endlist + + \section1 Recording + + The application implements recording. + + \section2 captureSession + + In \c Main.qml, \c captureSession is declared like so: + + \quotefromfile video/recorder/Main.qml + \skipto CaptureSession + \printto MediaRecorder + + \section2 recorder + + In \c Main.qml, the \l MediaRecorder \c recorder handles recording media + as well as capturing a thumbnail for the file and appending it to a ListModel, + \c mediaList. + \printto Playback + + \c mediaList is declared in the \l Frame \c mediaListFrame + \quotefromfile video/recorder/Main.qml + \skipto Frame + \printuntil playback: playback + + \section2 controls + + \image qml-recorder-control-bar-overview.gif + {Animation cycling through column layouts in control panel} + + These are defined in \c Controls.qml and declared in Main.qml. + + Its root is a \l Row that contains the \l{Column}{Columns} \c inputControls, + \c recordButton, \c optionButtons, each defined in their own .qml files. + + \section3 Selecting a video source + + Defined in \c VideoSourceSelect.qml, \c VideoSourceSlect is comprised of a + \l Switch and a \l ComboBox and enables the user to select from available + cameras. + + \quotefromfile video/recorder/VideoSourceSelect.qml + \skipto Row + \printto ComboBox + + \c comboBox, declared in the above snippet, assigns the current video source. + + \printuntil camera.cameraDevice = currentValue.camera + + \section3 Selecting an audio input + + Implemented in the same way as \l{Selecting a video source} and defined in + \c AudioInputSelect.qml like so: + + \quotefromfile video/recorder/AudioInputSelect.qml + \skipto Row + \printto audioInput.device = currentValue + +*/ diff --git a/examples/multimedia/video/recorder/main.cpp b/examples/multimedia/video/recorder/main.cpp new file mode 100644 index 0000000..471c5aa --- /dev/null +++ b/examples/multimedia/video/recorder/main.cpp @@ -0,0 +1,25 @@ +// Copyright (C) 2025 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +int main(int argc, char *argv[]) +{ + QGuiApplication app(argc, argv); + + QQmlApplicationEngine engine; + QObject::connect( + &engine, &QQmlApplicationEngine::objectCreationFailed, &app, []() { + QCoreApplication::exit(-1); + }, + Qt::QueuedConnection); + + engine.loadFromModule("RecorderExample", "Main"); + + return app.exec(); +} diff --git a/examples/multimedia/video/video.pro b/examples/multimedia/video/video.pro new file mode 100644 index 0000000..2915ce4 --- /dev/null +++ b/examples/multimedia/video/video.pro @@ -0,0 +1,3 @@ +TEMPLATE = subdirs + +SUBDIRS += qmlvideo diff --git a/examples/multimedia/videographicsitem/CMakeLists.txt b/examples/multimedia/videographicsitem/CMakeLists.txt new file mode 100644 index 0000000..4c34172 --- /dev/null +++ b/examples/multimedia/videographicsitem/CMakeLists.txt @@ -0,0 +1,41 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(videographicsitem LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/videographicsitem") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia MultimediaWidgets Widgets) + +qt_add_executable(videographicsitem + main.cpp + videoplayer.cpp videoplayer.h +) + +set_target_properties(videographicsitem PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +target_link_libraries(videographicsitem PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::MultimediaWidgets + Qt::Widgets +) + +qt_add_ios_ffmpeg_libraries(videographicsitem) + +install(TARGETS videographicsitem + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/videographicsitem/doc/images/video-videographicsitem.png b/examples/multimedia/videographicsitem/doc/images/video-videographicsitem.png new file mode 100644 index 0000000000000000000000000000000000000000..e333c54a294aac8df163e9882e7dc91a066668e1 GIT binary patch literal 54436 zcmd?Q^;cW%6FrI*X=!n{LZLu$chce%E5#j(ySs!IiU*1mmlt<0#T}C3#hn1bEqHKl z=;wad{Ri$(_nx&_S)7yPJZGMnJ$v>{B0s6hzkE*l90djCrJ{n&XA~5)eB>WGHYV~6 zcL-S+3d(B~MVSwpKA8v0wlRhCflvfoWX!9v%)qm}Y<9lbUsyUUiNTe`GJ5KZViL_j zEjmU#2bT*jMs30CSO2kd5u@Uup?Og&8sqmzSVsN|(RE=Qddp;Rs~W2iHB_<8CoyU7 zIoq*x=$q}XYAlXesVb}5%dWij(&)rnte6IwB|mk}cYMGFelTMS3S{TFmEm+ACA`>WQD{Z^^F z6}5zE`{#MQ1oA)nX$QY44WUb(h3lkM_P$|W%*<4~3Jd4sezqt9+0$Mflv|y!`ba!m zqb`1U6de(t3x|T1dZ%CD62p==CyTTmH9@hXH(bYiGYrff*PQ{2%=8Fj ze?gZrBVH3O8zzzRp%mRX!m7#?3=_h(e7=m+s{u@?OVLOo#9aG#%iW5*y~Bpe`me7% zWvNjSe`bptl*ZgH^8qrzZSbPg{((F&!oBm+eQF`@|5;haoj;*m_>6BQBh z$B3ZKUw)Cwx~O&fD8sY*#+5II);DscE;B$3@VE=?Zwwl`^+imoxjpCrBUNrgWE9W3 z?9uD@ACtKO8*W$F9E($hk64=6v?g1^WY|S=ulv7az;Ne81A@n!2+B)q6G8; zZ-DXqqzY6ooOcB#cV?H(x~6z+vrvTboX(*hzs;_9`04}ppdHHI-r@SBXMuD;yvHq} zu`{tTMv@Kn_`XLbOxR0mU~%zQ`^q%eRoIjN0Gs9QIzjP zEQ75;3O`CnTcUHoul`x%7BE}2;RfWf91ra{F6aU8st*F~eLO4QzM8wGGpovW54@mM zJWDOhM@GCS(^?ju{qkYfo5lN1;FW}Tz$5f-cRSVrG18&|cqKM-nB8gwa8mUb443Rw z6Mk6EY`t^$*fT;&?jh5i&knhhM^OtzJa!Lt-awTf zXlBL4AEN;tkZmwHj`?ELaZ!0MD-gc#*w#~M{kWEUDE_E4%|rXJ3eA-Sh82v@&u;fF zEZ;62-gr)#J71>CH(VdlU5Nz0F>z1w;$u+4ofQfrXD3I`WxPVG*nGVEzFng(r0}C@dQA-q{A59$(&c7MN1F=3LiW->rYilUHyNwjjFqTgVh7 z{pLLoCSKJUwBe2wvU4R60@7iL^MS5xBZ7c4qrl79!-M;58r%$j6X0=k{sL7FbR~#d zd|SwGI0R1Dd3kMem%B)dC|Tr21dN4mU2XB<@E9FG177{~%nthU6{6bM+_7L;Z*WT1 zdB)DwQ5PkU{34}M_*MZc-~$V$^S-r|(6Yy*iqP^=BbDaQUhh3H&BC)Q`^Qx!@r$p{ zut4ZTic>Rc+cDK+sy)}kOzvTa#x`R1p*w~AcAhSfZr1p&GVsHBDP8~-*BuyO1v{NR znv1Iy(xP}4vG>AZ>XE(SRA_$B&#;Et-t&6>6vnSAaS5gr>B+f^&Oj}{{~JEna@Ra? z{{UuVytp@KTEq*CC|Jprd}LG$Sd5D^_Rh}h9NlXkQ$1q7xHec3a=M*{K1A-dV~qlr zF4YfXZqFuIcCrGXcq^AphvAYKnpy*8W7d~6?n}n^KOjdQ%E8m_Ia!%QM9@oE+sz`N zyKwAL`pG%wy^ZfdXHTb4yVmF7mGAPffbU+BlV(F7PhUztsL+V=WzSaO`s})mK0cIg zUpYVS`OnSm@c<0Adp2JNA)-^bU8AWClEYO;QC5xUly7&?kq99kys|rV4jWs~UwFB~ z<9%worApi3WHVzpNA~dQ_pKGpbR6ByEpT}3ei?y&T>iKr|27VA@c>YAw2Hrs^p0;3 zb#9_N8QF&VsM!ZSgPXa3+NK(tQkYEAKiyhr%5udQzwV&hSkRG_@C|U@Kb)jvv}OOB z3XpDhw>rHl@4UCYe0Q^-bPqCEX>2@vC+y|qt785z9DhiCpf+y8TP!iHuoAG!L$BaMXLe{&7w*BLp5&nELP~pyM=%%T; z+iM!qnmS^t1bZxfg~901OTP_=CjWCHK^$*yhzx0ZR>AIV%SVX6i-pu1p&sVdRUU-2yd;MzOS>*h>VwxTUICKl$ zvpzl?g||LjLbm~T!_cfH;NCqjOy52pW)1jwyP;t*axJtJCuBrnx&2IZ&9@4dE^l&$ ze#||rm!A3H-E1qKxj|fKcbHT4_&go2^KL#5zo>Pp#C^A->Fq>uCtk3;yh3z`2Rx&~ z@xlJuZ5q*#EUX%_j*aHv=nT8Z$9BH1<|QDAzn$iPmyZEFcMSpD-NRihiRZ{